Wait for Process Action

Description

Causes Workflow execution to pause at the current line until the specified process starts or ends. Commonly used to wait for an external application to start or end which could indicate that a process has completed successfully. If the process started/ended then the Workflow could move on.

Most of the functionality contained in Wait for Process <AMWAITFORPROCESS> is also contained in the Run action <AMRUN>. This action should only need to be used if Automated Workflow is not responsible for starting the process, such as in cases where the external application or the user starts/ends the process.

Declaration

<AMWAITFORPROCESS ACTION="text [options]" PROCESS="text" PROCESSID="text" RESULTDATASET="text" />

Example

<AMWAITFORPROCESS PROCESS="C:\Program Files\Internet Explorer\iexplore.exe" RESULTDATASET="ProcessDataset" />

<AMWAITFORPROCESS ACTION="end" PROCESSID="3932" RESULTDATASET="ProcessDataset" />

General Tab Parameters

Action: Specifies whether the step should wait for the process to start or end.

  • Wait for process to start: the action will wait for the specified process to start

  • Wait for process to end: the action will wait for the specified process to end

Text [Options], Optional, Default: start
MARKUP: ACTION="end"

Use process name: Specifies the executable of the process that Automated Workflow should wait for. Partial matches are allowed (either the full path or the EXE name only may be specified).

(The process may be specified either by process name or by process ID—see below).

Text, Optional
MARKUP:
a) PROCESS="c:\foldername\iexplore.exe"
b) PROCESS="iexplore.exe"

Use process ID: Specifies the process ID for the process that Automated Workflow should wait for.

Text, Optional
MARKUP: PROCESSID="3932"

Create and populate dataset: Specifies the name of a dataset to be created and populated with process data. In addition to the standard dataset fields, the dataset will contain the following:

  • ProcessName: the path and file name of the process's .exe file

  • ProcessID: the ID of the process

  • WindowTitle: the title of the process's main window

  • WindowClass: the class of the process's main window

  • WindowHandlle: the handle of the process's main window

Text, Optional
MARKUP: RESULTDATASET="DatasetName"