Messages and macros Functions

Enables you to display a message in an information box. The message can include one or more parameter values.

Message(message: String [, argument: Literal, ..])

Message("External radius is: # | Internal Radius is: #", PartBody\Sketch.1\Radius.3\Radius, PartBody\Hole.1\Diameter)

Message (BuildMessageNLS(KwrCATCatalog, Zero))

Enables you to display a yellow tooltip on the top right of the screen. To avoid tooltip overlap, the messages are stored within a defined timeframe and displayed altogether when the application idles. The notifications are stacked until:

• The notifications stack reaches 40 elements.
• Notify is called using “|” as first character, which indicates that you want to start a new notification stack.

Notify(message: String [, argument: Literal, ..])

Function identical to Message except that it does not have the optimization that compacts different messages into one and blocks the evaluation until the user clicks OK.

PopupMessage(severity: String, message: String [, argument: Literal, ..])

let i = 1
for i while i < 10
      Message("i = #", i)

Enables you to display a message in a dialog box, click a button to get a value indicating which button you clicked (true if Yes was clicked, false if No was clicked).

Question(question: String [, argument: Literal, ..]) :
 Boolean

Boolean

Boolean2 = Question("SketchRadius is # | Do you want to change this value ?",
PartBody\Sketch.1\Radius.3\Radius )

Enables you to create an error displayed at the end of evaluation in an error report.

Report(severity: String, summary: String, 
message: String [, argument: Literal, ..])

Function used to build a message using a format string and its arguments.

TextFormat(format: String [, argument: Literal, ..]) :
 String

String

Enables you to write information in a file for debugging purposes for example. On the client side, to do so, valuate the CATKnowledgeTracePathvariable (for example, set CATKnowledgeTracePath=E:\Temp\CATKnowledge_UserDefined.txt). If the variable is empty, the default name of the trace file is CATKnowledgeTrace_YYYY-MM-DD_HH-MM-SS.txt. This file is located in the CATTemp directory (For example: C:\Documents and Settings\user\Local Settings\Application Data\DassaultSystemes\CATTemp\CATKnowledgeTrace_2005-8-8_16-28-20.txt).

On the server side, to activate traces, the server must be launched with the trace options: For instance when working with a Tomcat server,set _JAVA_OPTIONS=-DJSystemTraceFile=e:\tmp\traces.txt.In this traces.txt file, the environment variable has to be set :

• CKE_CUSTO_TRACES 10 for basic traces like Business rules called,
• CKE_CUSTO_TRACES 30 for advanced traces like objects dump

Trace(level: Integer, message: String [, argument:
 Literal, ..])

Trace(1 , "MyMessage... 
						Param1: #, Param2: #", Integer.1, String.1) 

Function used to run a macro with arguments. It is up to you to check that the macro which is run is not going to cause an infinite loop or result in a system crash.

Visual Basic Script Macro->Run(valueOrFeature:ObjectType,...): VoidType 	

String

if PartBody\Pad.1.HasAttribute(String.1) 	== true 
						`VB Scripts.1` .Run(PartBody\Pad.1 .GetAttributeString(String.1),PartBody\Pad.1.Name() 
						)

Executes an action.

AdvisorAction->Run(valueOrFeature:ObjectType,...): VoidType 

String

if PartBody\Pad.1.HasAttribute(String.1)              == true 
 
`Action.1` .Run(PartBody\Pad.1 .GetAttributeString(String.1),PartBody\Pad.1.Name()