|
|
Property-Set-Messages methodUse 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.)
Parameters
This method has three parameters:
Parameter |
Description |
| Category |
Optional. 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. |
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.
Avoid using a field value whose localized value contains property references. PRPC 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.Results
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.
Checking the method status
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 |