Launch Process

Launches an external process, and optionally waits for that process to terminate.

Inherits from: Unattended Activity

Properties

The following 6 properties are defined.

Property Name Description
General
Application Path Type: String

The path to execute. This activity performs a shell execute using the provided path. As such, this property can contain any command which could be executed from the Windows 'Run' prompt, such as:

  • The path to an executable file or batch file.
  • The path to any file for which a viewer is installed on the local machine, such as an Excel spreadsheet or text file.
  • The path to a file system folder. This will display the folder contents in Windows Explorer.
  • A URL to a web page. This will display the specified web page in the default browser.

Should Wait Type: Boolean, Default: False

If true, Grooper will launch the process and wait for a period of time for the process to complete or close. This is useful in cases where the process being launched does not have a user interface to interact with and is expected to run and complete invisible to the user, for example, a command line executable. If false, Grooper will launch the process and not care how long it takes to close. This is useful in cases where the process being launched has a user interface to be interacted with, for example a file that will be opened.

Wait Timeout Type: Int32, Default: 60

The maximum amount of time to wait for the process to finish in milliseconds before timing out.

Processing Options
Error Disposition Type: IssueDisposition, Default: Flag, Log

Determines what happens when an error occurs processing an activity.

Maximum Consecutive Errors Type: Int32, Default: 0

The maximum number of consecutive errors, after which a critical stop will be raised. A critical stop will cause services to stop running.

Concurrency Mode Type: ConcurrencyMode, Default: Multiple

Specifies the parallel processing mode for this activity. Can be one of the following values:

  • Multiple - Multiple instances can run concurrently.
  • PerMachine - Only a single instance can run per machine.
  • Single - Only a single instance can run per Grooper repository.
This value determines the type of Thread Pool on which the activity can be executed.

Used By

Batch Folder - Apply Activity, Batch Process Step