Pause Task Action

Declaration

<AMPAUSE SCALAR="number" MEASURE="text [options]">

See Also

Pause Task Action-Setting Properties, Wait for Window, Wait for Pointer, Wait for File, Wait for Process, Close Window

Description

Pauses the task at the current line until the timeframe specified has elapsed.

Practical Usage

Usually used to pause execution of a task until a process has completed. If the process completion time is variable other wait action such as Wait for Window, Wait for Pointer, Wait for File and Wait for Pixel should be considered as they would be more precise.

Parameters

General Tab

Wait for

Yes, No, Optional
MARKUP: ACTION="waitfor"

 

If set to YES, instructs the system to wait for a specific amount of time.

 

Delay to wait for

 

Text, Required
MARKUP: SCALAR="30"

 

Specifies the amount of time to wait. Only available if the Wait for parameter is set to YES.

 

The available drop-down options are:

 

Wait Until

Yes, No, Optional
MARKUP: ACTION="waituntil"

 

If set to YES, instructs the system to wait until the specified date/time.

Time

Text, Required
MARKUP: TIME="%TimeSerial(17,00,00)%"

 

Specifies the time to wait until. Only available if the Wait Until parameter is set to YES.

 

Day

Text, Required
MARKUP: DAY="sameday"

 

Specifies the day to wait until. Only available if the Wait Until parameter is set to YES.

 

The available drop-down options are:

 

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

  <AMPAUSE ACTION="waituntil" TIME="%TimeSerial(17,00,00)%" DAY="nextday" />