Suppressing Messages During CATIA 3DEXPERIENCE Publishing
During the publishing of CATIA 3DEXPERIENCE design data using Windchill Visualization Services (WVS), warning messages sometimes display in pop-up windows. These messages can cause the CATIA 3DEXPERIENCE session to hang. An example of one of these warning messages is shown in the following figure.
To avoid this issue, you can set an environment variable that enables the WVS CAD Worker Agent to scan an XML file for titles and messages of specific pop-up message windows that you would like to suppress during CATIA 3DEXPERIENCE publishing. When you specify pop-up windows for suppression, you also designate the action to be taken based on the message type. For example, “Warning”—continue on with the publishing job, “Error”—abort the publishing job immediately.
 | Suppression of pop-up windows during the publishing process can lead to an incomplete or an incorrect update for the dataset being published. However, in the case of an incomplete dataset, this can be a desirable work-around. |
To set up the suppression of WVS pop-up windows during a CATIA 3DEXPERIENCE publishing job:
1. Stop the CAD Worker if it is running.
2. Invoke an XML editor and create a file named suppress.xml with the same content as described in Sample supress.xml File with Instructions.
3. In your suppress.xml file, at the appropriate location, log the title of the warning window causing the failure, its message text, and the desired action to take when the window displays during future publishing jobs (“Warning” to continue the job or “Error” to abort immediately).
For example, you could use the following definition:
<popup_definition title=”Hole*” message=”Geometry*” action=”Warning”>/
| | Wildcards (*) can be used to simplify the definition as seen in the previous example. |
4. Save your suppress.xml file to a location on your system.
5. Create a system environment variable using the name “PTC_WGM_CATIAV6_POPUP_SUPPRESS_DEF_FILE” and set its value to the path of your suppress.xml file.
6. Restart the File Sync CAD Worker Administration application and re-submit the publishing job to test the suppression of the pop-up window that you logged.
| | In cases where the value of the environment variable PTC_WGM_CATIAV6_POPUP_SUPPRESS_DEF_FILE is being initially defined or changed, you must restart the Worker Daemon under which the worker is running. Or in the case where the worker is running as a service, restart the service from the Services console. |
The publishing job either succeeds, or another failure occurs as seen in the log panel of the WVS Job Monitor window (later versions of the CAD Worker).
7. In cases where there are additional failures, repeat the procedure until the job succeeds without being hung by pop-up messages.
Sample supress.xml File with Instructions
<?xml version="1.0" encoding="UTF-8"?>
<!--
INSTRUCTIONS:
- in worker mode, during job processing, the adapter suppresses CATIA popups defined
in the <popup_definition> tags and performs an action specified in the "action"
attribute
- action attribute can only have one of the following case-sensitive values:
"warning" - Log warning, continue job
"error" - Log error, exit CNEXT.exe, job fails without delay
- for a window to be suppressed, its title has to match the pattern specified in the
"title" attribute (case-sensitive) and its message has to match the pattern specified
in the "message" attribute (case-sensitive)
- using a wildcard (*) is supported in the "title" and "message" definitions where <*>
matches any (zero or more) characters, for example:
string "ABC abc" matched with:
pattern: "*" -> match
pattern: "ABC*" -> match
pattern: "*A*" -> match
pattern: "*bc" -> match
pattern: "a*B" -> no match
- examples
<popup_definition title="*Err*" message="*twisted*" action="Warning"/> causes suppression of all popups having "Err"
in the title and "twisted" in message body
<popup_definition title="*" message="*" action="Warning" /> causes suppression of all popups
- in cases where there are intersecting "error" and "warning" definitions and the popup
matches both of them, the "error" definition applies, regardless of the order listed
in the XML,(error definitions are processed first):
<popup_definition> title="*" message="*" action="Warning"/>
<popup_definition title="AB*" message="TEST*" action="Error"/>
Error def is used if popup matches
-->
<popups_to_handle>
<popup_definition title="*diameter was changed*" message="*need update geometry*" action="error"/>
<popup_definition title="*Admin*" message="*Reque*" action="error"/>
<popup_definition title="*" message="*twisted*" action="error"/>
<popup_definition title="*" message="*" action="error"/>
</popups_to_handle>
<!--
INSTRUCTIONS:
- in worker mode, during job processing, the adapter suppresses CATIA popups defined
in the <popup_definition> tags and performs an action specified in the "action"
attribute
- action attribute can only have one of the following case-sensitive values:
"warning" - Log warning, continue job
"error" - Log error, exit CNEXT.exe, job fails without delay
- for a window to be suppressed, its title has to match the pattern specified in the
"title" attribute (case-sensitive) and its message has to match the pattern specified
in the "message" attribute (case-sensitive)
- using a wildcard (*) is supported in the "title" and "message" definitions where <*>
matches any (zero or more) characters, for example:
string "ABC abc" matched with:
pattern: "*" -> match
pattern: "ABC*" -> match
pattern: "*A*" -> match
pattern: "*bc" -> match
pattern: "a*B" -> no match
- examples
<popup_definition title="*Err*" message="*twisted*" action="Warning"/> causes suppression of all popups having "Err"
in the title and "twisted" in message body
<popup_definition title="*" message="*" action="Warning" /> causes suppression of all popups
- in cases where there are intersecting "error" and "warning" definitions and the popup
matches both of them, the "error" definition applies, regardless of the order listed
in the XML,(error definitions are processed first):
<popup_definition> title="*" message="*" action="Warning"/>
<popup_definition title="AB*" message="TEST*" action="Error"/>
Error def is used if popup matches
-->
<popups_to_handle>
<popup_definition title="*diameter was changed*" message="*need update geometry*" action="error"/>
<popup_definition title="*Admin*" message="*Reque*" action="error"/>
<popup_definition title="*" message="*twisted*" action="error"/>
<popup_definition title="*" message="*" action="error"/>
</popups_to_handle>