Back Forward Property-Set-Messages method

 Methods and instructions by function

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.)

 

Parameters

This method has three parameters:

Parameter

Description
Category

Enter a localization category that is the second key part of a field value. The default is pyMessageLabel.

Otherwise, leave this field blank.
Message

Identify the message to add to the page. You can enter values in this field in one of the following ways:

  • The name of a Rule-Message instance, without quotes. The list of available options in the SmartPrompt is limited to Error and blank category messages of the class of the specified Page.

    If the message supports parameters, append a tab-delimited string to the message name.

  • The third key part of a field value rule where @baseclass is the first key part and the value specified in the Category field is the second key part.

    Use this approach when the Category field is not blank and the specified field value does not contain property references. Property references can lead to confusion because field values are evaluated each time the page is read, and property values can change over time.

  • A literal text string within double quotes.

    Avoid this option if your application supports localization.

Field

Identify the property on which the message is set.

 

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.

 

Definitions language-specific RuleSet, property message
Related topics About Messages
Constants in expressions
Property references in expressions

UpMethods and instructions by function