Show message action

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

Note
  • 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 for Message type. To configure the settings for 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.

    Note The actions mapped in the Actions on OK box are executed a runtime.

    Prompt

    To configure the settings for 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 text in multiline, select Multiline text field. (Default: Clear. This means the prompt text 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 a 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.

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

    Confirmation

    To configure the settings for 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.

    Note 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.