Skip to main content

Table of Contents

Validate rules in offline mode


Only available versions of this content are shown in the dropdown

Offline-enabled mobile apps support validate rules in specific scenarios. Validate rules help you verify the correctness of the input values in your app. For example, a validate rule can test if the property values that users enter in a form are valid against conditions that you define in the rule.

The validation is automatic if a flow action references the validate rule.


Pega Platform packages validate rules that match the supported scenarios on the server for use in an offline-enabled app. A validate rule can also call any number of function rules, and the system automatically packages the function rules that are referenced by the validation rule.

Pega Platform packages the following rules:

  • Validate rules that are referenced in flow actions
  • Validate rules that you add to the list of offline-supported validate rules

If a packaged validate rule matches an unsupported configuration, the offline-enabled app might not process the rule. The mobile client adds an error message in the client log files to indicate that the validate rule was not processed.

Supported configuration of validate rules

Offline-enabled apps support validate rules to the following extent:

  • Validation on only one level; support of one column for each property
  • Addition of warning and error messages for properties and pages if a supported validation fails
  • Several validation conditions:
    • Enable conditions
    • Select a function
    • Required check box with a default message: This field may not be blank
    • Continue validation
    • Message as a text or a reference to a message rule with parameters
    • Validation condition with function rules
  • Direct validation of a single-value property that you define in the following ways:
    • Individually

      Example: .CustomerType

    • In a Page property

      Example: .ItemToAdd.Name

    • In a Page List property

      Example: .Items(1).CategoryID

    • In a Page Group property

      Example: .ShipmentsGroup(A).TrackingNumber

    • In a specific page of a Page List property in a Page property

      Example: .ItemToAdd.Items(1).CategoryID

  • Localization of parameterized message rules for the validation conditions

Unsupported scenarios

Offline-enabled apps do not support validate rules in the following scenarios:

  • References to a validate rule from any rule other than a flow action
  • Any modification of the validate rule configuration in the flow action rule
  • Case-level validation during case creation and saving
  • Stage-entry validation
  • Validate rules in an assignment, during postprocessing when users navigate away from a step
  • Queuing additional validation, such as Edit Validate or another validate rule, that runs after the evaluation of the preceding validation
  • Input tab settings on a validate rule: input property, proposed work status, flow action name, stages
  • Direct validation of the following single-value properties: Validate Each, Call for Each, Call
  • Validate rules with expressions
  • Offline validation API

    The offline validation API consists of a JavaScript method that runs a validate rule in offline-enabled mobile apps by using a Run script action or a custom JavaScript function.

Suggest Edit
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us