Back Forward Page-Clear-Messages method

Methods and instructions by function

Use the Page-Clear-Messages method to remove all property messages and certain page messages from the page identified in the Step Page column of the current step.

CautionUse this method with care, as the messages present on the page may have been added by various application-related processing. Clearing a message before the cause is reported to a user or logged is not advisable.

NoteYour application can clear messages by other means. For example, when a user submits an HTML form to the server containing input values for properties on a page, the server clears all page messages for the page, and also clears property messages for any property with submitted values (that is, any property that was touched by the user before submitting the HTML form.)

TipTo avoid any chance of introducing invalid data into the database, design your activity to revalidate any page that was cleared of messages, before the activity attempts to save the page.

Parameters

This method uses no parameters.

Results

All messages placed by the Page-Set-Messages method on the step page are deleted.

Messages placed by Constraints rules, edit validate rules, and property type validation are not cleared — they are cleared and the restrictions are retested only when the property value changes.

Checking the method status

This method updates the pxMethodStatus property. See How to test method results using a transition.

Definitions page message, validate
Related topics Page-Set-Messages method

zzzMethods and instructions by function