Show message action

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

  • You cannot select a Show Message action within a Show Message action.
  • You can select 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, unexpected behavior occurs.

  1. On the form modeling bar, click Actions and click New.

    The New action dialog box is displayed.

  2. On the Type list, select Show message.
  3. Change the default Name (ShowMessage1) to something meaningful.
  4. Optional. Enter a Description for the action.
  5. Optional. Select Multilingual to configure a unique action for each language separately. See Configure multilingual actions.
  6. For Message type, select one of the following options:
    Option Description

    Alert

    By default, Alert is selected as the Message type. To configure the settings for the Alert message type, do the following:

    1. To display a title for the alert, select a dynamic value (form control or form/global variable), or click and provide a static value in the Title field.

    2. To display a text for the message, select a dynamic value (form control or form/global variable), or provide a static value in the Message text field.

    3. Optional. To add actions, click Add for Actions on OK, select the required actions, and click Done.

      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 the OK box are executed at runtime.

    Prompt

    To configure the settings for the Prompt message type, do the following:

    1. To display a title for the prompt, select a dynamic value (form control or form/global variable), or provide a static value in the Title field.

    2. To display a text for the prompt, select a dynamic value (form control or form/global variable) or provide a static value in the Prompt text box.

    3. To display a prompt input (default value) in multiline, select Multiline text field. (Default: Clear. This means the prompt input appears in a single line.)

    4. Optional. To display a default value at runtime, select a dynamic value (form control or form/global variable), or provide a static value in the Default value field.

    5. On the Input value list, select a form control, form variable, or global variable to accept the input value entered by the user at runtime.

    6. Optional. To add actions, click Add for Actions on OK, select the required actions, and click Done.

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

    7. Optional. To add actions, click Add for Actions on CANCEL, select the required actions, and click Done.

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

    The actions mapped in the Actions on OK and Actions on CANCEL fields are executed at runtime.

    Confirmation

    To configure the settings for the Confirmation message type, do the following:

    1. To display a title for the confirmation, select a dynamic value (form control or form/global variable), or provide a static value in the Title field.

    2. To display a text for the message, select a dynamic value (form control or form/global variable), or provide a static value in the Confirmation message field.

    3. Optional. To add actions, click Add for Actions on YES, select the required actions, and click Done.

    4. Optional. To add the required actions, click Add for Actions on NO, select the actions, and click Done.

    The actions mapped in the Actions on YES and Actions on NO fields are executed at runtime.
  7. Click Add.
    The newly created action appears on the Actions page.
  8. Associate the action with the control to trigger this action. See Configure actions for form control events. Alternatively, to call the Show message action for a form event, associate the action with the form. See Associate an action with a form.