Run

Property

Type

Required

Default

Markup

Description

Run

Text

Yes

(Empty)

1. FILE="C:\Temp\File.exe"

2. FILE="Notepad.exe"

The path and file name of the file to run. If necessary, this parameter should include the full path to the EXE, COM, BAT, or CMD file you wish to run. To specify a document, click the folder icon or use the Start button (Windows logo) to browse to the desired item. The properly formatted command line including the associated application for the document will be automatically built.

Run only if another instance isn't running

Yes/No

No

No

SINGLEINSTANCE="YES"

If selected, denotes that the application specified in the Run parameter should not start if another instance of that application is already running on the system. Instead, the step will be ignored and no error is generated. If disabled (default), the specified application will run despite other running instances.

Match processes by name (for compatibility with 64-bit applications)

Yes/No

NO

(Empty)

If selected, the method of comparing processes will be by the name of each process. This parameter is active only if the Run only if another instance isn't running parameter is enabled.

Initial window state

Text (options)

No

Normal

1. WINDOWSTARTUP="normal"

2. WINDOWSTARTUP="maximized"

3. WINDOWSTARTUP="minimized"

4. WINDOWSTARTUP="hidden"

In certain situations, a specific application may be more convenient to have running in the background, minimized or out of the way of other programs. This property allows you to control the state that the application's window should adhere to upon startup. The available options are:

• Normal (Default) - The application's window will start in a normal state.

• Maximized - The application's window will start maximized (fill the entire screen).

• Minimized - The application's window will start minimized to the taskbar (or notification tray) .

• Hidden - The application's window will start hidden. This is ideal for running batch files or console applications without the unwanted DOS window appearing.

NOTE: If an application is set to start Hidden, execution occurs without a visible window, thus, any interactive actions that try to interact with the hidden application will fail.

Startup folder

Text

No

(Empty)

DEFAULTFOLDER=

"C:\Program Files\AutoMate 11\"

The application's startup folder (if one is required). This option is not required and is available primarily for legacy (older) applications. When not specified, the folder that the application resides in is used.

Property

Type

Required

Default

Markup

Description

Do not wait

Yes/No

No

No

WAITFORINPUT="NO"

If selected, the step will not wait until the application is finished loading. Selecting this option could result in the task moving to the next line too early which would cause any interactive steps to be sent into nothing. This parameter is disabled by default.

If the Wait until application completes parameter is selected then this parameter is ignored.

Wait until application is ready for input

Yes/No

No

Yes

WAITFORINPUT="NO"

If selected (default), the step will wait until the application is finished loading and is ready to receive input such as keystrokes or mouse clicks. Setting this parameter to NO could result in the task moving to the next step too early which would cause any interactive steps to be sent into nothing (because the application hasn't fully loaded yet). If the Wait until application completes parameter is selected then this parameter is ignored.

NOTE: DOS applications, batch files, and certain console applications may not function correctly with this parameter selected because such applications do not support standard Windows event messaging that enables this kind of integration. For these applications, you may need to use a Pauseaction or other method of waiting for the application to be ready for input.

Wait until application completes

Yes/No

No

No

WAITFOREND="YES"

If selected, the step should wait until after the application has either closed itself (in the case of batch files, scripts, or console applications) or is closed by the user (in the case of Windows applications).

Populate variable with return code

Text

No

(Empty)

RETURNCODEVARIABLE="code"

If enabled, specifies an already existing variable to be populated with the application-provided return code. This parameter is only available if the Wait until application completes parameter is selected.

NOTE: Not all applications use return codes, so the functionality of this action may vary depending on the application.

Terminate process after

Number

No

No

TERMINATEAFTERTIMEOUT="YES"

If selected, the running process will be terminated when the timeout period is reached. This parameter is disabled by default and only available if the Wait until application completes parameter is selected.

Timeout length

Number

No

No

TERMINATEAFTERTIMEOUTLENGTH="50"

The length of the timeout period. This value is used along with the Timeout scale parameter below in order to entirely display a timeout value.

Timeout scale

Options

No

No

1. TERMINATEAFTERTIMEOUTSCALE="milliseconds"

2. TERMINATEAFTERTIMEOUTSCALE="seconds"

3. TERMINATEAFTERTIMEOUTSCALE="minutes"

4. TERMINATEAFTERTIMEOUTSCALE="hours"

The scale used to specify the timeout period. This parameter is used along with the Timeout length entered in order to entirely display a timeout value. The available options are:

• Milliseconds - The timeout value will be measured by milliseconds.
• Seconds (default) - The timeout value will be measured by seconds.
• Minutes -  The timeout value will be measured by minutes.
• Hours -  The timeout value will be measured by hours.

Property

Type

Required

Default

Markup

Description

Populate variable with process ID

Text

No

(Empty)

PROCESSIDVARIABLE="ID"

If enabled, specifies an already existing variable to be populated with the application's process ID.

Create and populate Dataset

Text

No

(Empty)

RESULTDATASET="myDataset"

If enabled, specifies the name of a dataset to be created and populated with data from the window of the application that was run. More information about the dataset that this action creates can be found below under Datasets.

Populate variable with window class

Text

No

(Empty)

WINDOWCLASSVARIABLE="myvar"

If enabled, specifies an already existing variable to be populated with the window class of the application that is launched. If the Do not wait parameter is selected under the Wait properties, this parameter becomes unavailable.

Populate variable with window handle

Text

No

(Empty)

WINDOWHANDLEVARIABLE="handle"

If enabled, specifies an already existing variable to be populated with the window handle of the application that is launched. If the Do not wait parameter is selected under the Wait properties, this parameter becomes unavailable.

Populate variable with window title

Text

No

(Empty)

WINDOWTITLEVARIABLE="title"

If enabled, specifies an already existing variable to be populated with the window title of the application that is launched.  If the Do not wait parameter is selected under the Wait properties, this parameter becomes unavailable.

Property

Type

Required

Default

Markup

Description

Run application as

Yes/No

No

No

1. DOS="YES"

2. ASEXPLORER="YES"

Specifies how the application should be launched as. The available options are:

• Standard Windows application (default) - The application will run as a standard Windows application.

• Document - The application will run as a document such as MS Word.

• Console application - The application will run as a console application that takes input and displays output at a command line console. Selecting this option enables the following parameters.

Capture standard output stream to variable

Text

No

(Empty)

OUTPUTVARIABLE="theVariable"

If enabled, specifies that an existing variable will be populated with the console output. Valid only if the Run application as parameter is set to Console application.

NOTE: These settings have no effect unless the Wait for application to complete option is enabled in the Wait properties.

Capture standard  output stream to file

Text

No

(Empty)

OUTPUTFILE="C:\Temp\filename.txt

If enabled, specifies a file to which the console output should be written. Valid only if the Run application as parameter is set to Console application.

NOTE: These settings have no effect unless the Wait for application to complete option is enabled in the Wait properties.

Overwrite if file already exists

Yes/No

No

No

OVERWRITEOUTPUTFILE="YES"

If selected, specifies that if the file being written to already exists, it will be overwritten. If disabled (default) and the file already exists, it will not be overwritten, however, the step will fail as a result. Valid only if the Run application as parameter is set to Console application.

NOTE: These settings have no effect unless the Wait for application to complete option is enabled in the Wait properties.

Capture standard error stream to variable

Text

No

(Empty)

ERRORVARIABLE="theVariable"

If enabled, specifies that an existing variable will be populated with the console error code (if any). Valid only if the Run application as parameter is set to Console application.

NOTE: These settings have no effect unless the Wait for application to complete option is enabled in the Wait properties.

Capture standard error stream to file

Text

No

(Empty)

ERRORFILE="C:\Temp\filename.txt

If enabled, specifies a file to which the console output should be written. Valid only if the Run application as parameter is set to Console application.

NOTE: These settings have no effect unless the Wait for application to complete option is enabled in the Wait properties.

Name

Type

Return Value

theDataset.Title

Text

Returns the window title.

theDataset.Class

Text

Returns the window class.

theDataset.Handle

Text

Returns the window handle.

theDataset.ProdcessID

Text

Returns the process ID.

theDataset.ReturnCode

Number

Returns the Return Code.

<AMRUN FILE="Notepad" />

<AMINPUT KEYSTROKES="Sending keystrokes to Notepad." PREDELAY="500" STAYFOCUSED="YES" DELAYBETWEENKEYS="50" />