property message

A property message is a text clipboard value, generated by the system and associated with a property. A message can convey error conditions, progress, or exceptions to a user.

In an activity, property messages can be associated with a property using the with the Property-Set-Messages method, among other ways. The Page-Clear-Messages method erases all the messages associated with properties on a page.

A clipboard page containing messages generally cannot be saved into the database, as the message typically indicates that the page (or a property on it) is invalid. The value of a property might not meet the requirements of a permanent instance of the page's class because of missing or incorrect data.

Although property messages appear as values on the clipboard, they are not defined through properties. On the Clipboard tool left panel display, property messages are marked with an icon and display in red text.

Associating a message with a property does not directly cause that message to be displayed to a user.

The page message text can be the name of a Rule-Message rule. When a page containing a page message is rendered, the system attempts to find a corresponding Rule-Message key, using the RuleSet list of the current requestor. If a match is not found, the resulting text consists of three asterisk characters followed by the message text.

When a workstation user submits an HTML form, previous page messages corresponding to the input are deleted (cleared).

Related Topics Link IconRelated terms