Description The prompt user action is used to display a dialog box with a custom message and format, and control the flow of the task based on the user's selection. When the step is executed, a Windows-like messagebox appears with a question-mark icon, and the task pauses until the user clicks a button. Based on the button that is selected and the configuration of the step, the task can stop, fail, continue or start another task.

Loop dialog

Parameters

Message Text
The Message that will be displayed when the prompt is displayed. For example: "do you want to continue this task"?

Style
Specifies the buttons that will appear on the prompt dialog.

On OK
Specifies what to do when the user presses the OK button at the time of the prompt. Options are:

Start
Starts the named task

Stop Task
Stops the current task

Continue
Continues the current task

Fail task if Cancel
When enabled, the prompt action will fail the task if the user presses the Cancel button at runtime during the steps execution.

Fail task if No
When enabled, the prompt action will fail the task if the user presses the No button at runtime during the steps execution.

Notes

To setup the step, type in the text you wish to appear in the dialog box. Select which buttons you wish to be available by clicking an option in the Styles section.

The On OK area sets up how the task will behave if the user clicks the Yes or OK button when the dialog appears during task execution. If Start is selected, AutoMate™ will stop the currently executing task and begin the task specified in the box to the right. If Stop Task is selected, AutoMate™ will stop the current task with a message in the Log File stating that the task has ended programmatically. (This is different than a task failing, which is written to the Log File as an error.) If Continue is selected, the task proceeds from that point normally.

The Fail on Cancel and Fail On No checkboxes indicate whether or not the task should fail if the user selects the Cancel and/or No buttons (depending on which are available).

Related Topics:

Pause Action

Loop Action

Wait for Window Action

Wait for Window to Disappear Action

Start Another Task Action

Disable This Task Action

IF Conditional Action

Other AutoMate Actions