Add a Show Message action

Use the Show Message action to alert or prompt the user, or request confirmation from the user.

Note
  • You cannot consume a Show Message action within a Show Message action.
  • You can consume a composite action which does not include a show message action within it, in a Show Message action. However, if you update the composite action with a show message action after it has been included within a Show message action, an unexpected behavior occurs.

  1. On the Form Modeling bar, click Actions.
  2. On the Actions page, click Add Generic Add.
  3. On the Type list, select Show Message.
  4. Enter a Name and Description for the action.
  5. Optionally, configure a unique action for each language separately. See Configure multilingual actions for a form or control for more information.
  6. For Message Type, select one of the following options:
    • Alert
      1. To display a title for the alert, consume the required form variable or a form control or provide an inline value in the Title box.
      2. To display a text for the message, consume the required form variable or a form control, or provide an inline value in the Message Text box.

      3. Optionally, consume the required actions in the Actions on OK box.

        At runtime, it displays the title of the alert and a read-only message with a OK button, and prompts to enter text in the Input Value box. The actions mapped in the Actions on OK box are executed a runtime.

    • Prompt
      1. To display a title for the prompt, consume the required form variable or a form control or provide an inline value in the Titlebox.
      2. To display a text for the prompt, consume the required form variable or a form control, or provide an inline value in the Prompt Text box.
      3. To display a prompt text in multiline, click Yes for Multiline Text Field. (Default: No. This means the prompt text appears in a single line.
      4. Optionally, to display a default value at runtime, enter an inline value, or consume a form variable or a form control in the Default Value box.
      5. Consume a form variable or a form control to accept the input value entered by the user at runtime, in the Input Value box.
      6. Optionally, consume the required actions in the Actions on OK box.

        At runtime, it displays the title of the confirmation and a read-only message with a OK button, and prompts to enter text in the text field.

      7. Optionally, consume the required actions in the Actions on CANCEL box.

        At runtime, it displays the title of the confirmation and a read-only message with a Cancel button and prompts to enter text in the text field.

      Note The actions mapped in the Actions on OK and Actions on CANCEL boxes are executed at runtime.
    • Confirmation
      1. To display a title for the confirmation, consume the required form variable or a form control, or provide an inline value in the Title box.
      2. To display a text for the message, consume the required form variable or a form control, or provide an inline value in the Message Text box.

      3. Optionally, consume the required actions in the Actions on OK box.
      4. Optionally, to perform certain actions when you click cancel, consume the required actions in the Actions on CANCEL box.

  7. Click OK.

    The newly created action is added to the table.

  8. Click Save.
  9. Associate the action with the control to trigger this action. To call the Show Message action upon form load, associate the action with the form. See Associate an action with a form or control.