Validation Message

Function

a!validationMessage( message, validateAfter, showWhen )

Configures a validation message for forms, sections, grids, and wizard steps.

See also:

• Form
• Section
• Editable Grid
• applyValidations() function

Parameters

Usage considerations

• Only supported in form layout, section layout, wizard step, and grid components.
• When Validate After is "SUBMIT", the validation message is only displayed when the user selects a button component where validate is true, or when the user selects a submit button.

Example

To experiment with examples, copy and paste the expression into an interface object.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
=a!localVariables(
  local!amount: 5000,
  a!formLayout(
    contents: {
      a!textField(
        label: "Amount",
        value: local!amount,
        saveInto: local!amount
      )
    },
    buttons: {
      a!buttonArrayLayout(
        buttons: {
          a!buttonWidget(
            label: "Submit",
            style: "SOLID",
            submit: true
          )
        }
      )
    },
    validations: a!validationMessage(
      message: "The total cannot be greater than $1,000",
      validateAfter: "REFRESH",
      showWhen: local!amount > 1000
    )
  )
)

Feature compatibility

Related Patterns

The following patterns include usage of the Validation Message.

• Showing Validation Errors that Aren't Specific to One Component (Validation): Alert the user about form problems that aren't specific to one component, showing the message only when the user clicks "Submit".

Feedback