Process Error Messages

You can define custom error messages to be displayed when variables in a business process violate certain constraints. Custom error messages can contain process variables, and can be imported or exported for easy sharing between different processes.

Process error messages are distinct from custom error messages configured for a form. The latter apply to a specific form, while the former are process-wide.

To configure a new custom process error message

  1. Open the process modeler for the process of interest.
  2. Click on the Process Properties icon in the top right.
  3. In the Error Messages tab, click Add rule to configure a new custom error message.
  4. Under Display, specify the message that should be displayed. You can add process variables to the message by clicking Insert variables .
  5. Under When, select the condition that will cause the error message to be displayed.
  6. Under For, select which fields the condition will apply to.
    • If you select All fields, the error message will appear whenever any field in the process meets the specified condition.
    • If you select These field type(s), you must further select a field type that the condition will apply to.
    • If you select Fields text does not match required pattern, you must specify a regular expression that picks out the fields you want the condition to apply to. Regular expressions here work the same ways as they do in field masks.

After configuring your first rule, click Add rule to add more rules. Re-order the rules by using the up and down arrows on the left.

Exporting and importing error messages

Any set of error messages can be exported by clicking the Download icon in the top right corner.

Alternatively, click the Upload icon in the top right corner to import a set of error messages that have been exported from another process. Imported error messages cannot add on to an existing set of error messages but will overwrite them.

Related Links