Property-Set-Messages method
|
|
Use this method to associate a text message with a property or a step page. The system reads the appropriate property and adds the message to the page. You can provide the entire literal text of the message, or reference a message rule key that in turn contains message text. (Rule-Message rule type).
Some message rules themselves accept fill-in-the-blank parameters, identified in the message text by a number within parentheses. (Don't confuse method parameters with Message parameters, which appear within the Message parameter, and are numbered.)
This method has three parameters:
Parameter |
Description |
| Category |
R-19059Optional. Leave blank unless when the message text is displayed, the output is intended to be localized based on field value rules in a language-specific RuleSet. Identify a localization category. Accept the default value pyMessageLabel except in advanced cases. See About the Localization wizard. |
| Message |
Enter one of the following:
Optionally, if the message rule identified uses one or more parameters, follow the name by a backslash character, the letter t, and a text value for each value. For example, the standard Message rule named ActivityNotDefined references one parameter in its text definition: The activity {1} is not defined. To provide a value BouncedCheck for this parameter, enter the following as the value of the Message parameter: ActivityNotDefined\tBouncedCheck
|
| Field |
Identify the property on which the message is set. |
The message is added to the page. This usually prevents the page containing the message from being saved.
Associating a message with a property does
not directly cause that message to be displayed to a user.
This method updates the pxMethodStatus property. See How to test method results using a transition.
|
language-specific RuleSet, property message |
|
About
Messages
Constants in expressions Property references in expressions |
If this activity is part
of an application that is intended to be localized to support
multiple locales, always reference a message rule here. Do not
enter literal text. R-18939
Avoid using a field value whose localized value contains property references. Process Commander evaluates the field value is each time the page is read, not only when the message is first added to the page. Because the properties may have new values (or be removed) when the field value is re-evaluated, this can be a source of confusion or error, for example when debugging with the Clipboard tool or the Tracer. GENTJ 3/5/2010 BUG-20159 rejected