Add a Show Message action
Use the Show Message action to alert or prompt the user, or request confirmation from the user.
- 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.
- On the Form Modeling bar, click Actions.
- On the Actions page, click Add .
- On the Type list, select Show Message.
- Enter a Name and Description for the action.
- Optionally, configure a unique action for each language separately. See Configure multilingual actions for a form or control for more information.
-
For
Message Type, select one
of the following options:
- Alert
- 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.
-
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.
-
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
- To display a title for the prompt, consume the required form variable or a form control or provide an inline value in the Titlebox.
- 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.
- 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.
- 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.
- Consume a form variable or a form control to accept the input value entered by the user at runtime, in the Input Value box.
-
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.
-
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.
The actions mapped in the Actions on OK and Actions on CANCEL boxes are executed at runtime. - Confirmation
- 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.
-
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.
- Optionally, consume the required actions in the Actions on OK box.
-
Optionally, to perform certain actions when you click cancel, consume the required actions in the Actions on CANCEL box.
- Alert
-
Click
OK.
The newly created action is added to the table.
- Click Save.
- 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.