Home Search

DriveWorks Pro 19
Start An Application With Arguments

Send Feedback

Start An Application With Arguments

This Specification Flow Task starts an application and will pass arguments into it on execution.

DriveWorks will pause/ wait while the application is running.

When the Task is executed it will either wait for the application to finish itself, or if the timeout is reached first then the Task will terminate the application.

The Task will execute on the host machine of the DriveWorks application from which it is being run.

For example:

If the Task is triggered from a client using the web theme, the Task will execute and attempt to run the application on the DriveWorks Live server machine.

Any application can be started with this Task, including malicious software.

Please take care to ensure the Task only executes the intended application, particularly when dynamic rules can result in different applications being started.

Properties

Property NameDescription
TitleChanges the Title (not the name) of the task.
ApplicationAn application with which to start a process.
Working DirectoryThe working directory for the process to be started.
ArgumentsA single string containing the arguments to pass to the target application.
TimeoutThe amount of time, in seconds, to wait for the associated process to exit. Set to 0 for no timeout and wait for the application to exit itself.

Example

When this Task is added the properties are static. To be able to build rules on a static property see How To: Change A Static Property To A Dynamic Property.

Property NameRuleMeaning
Applicationpython3.exeWill run the python3.exe
Working DirectoryC:\Python\HelloWorldThe working directory the application is run from.
ArgumentsHelloWorld.pyThe arguments to pass into the application.
Timeout10DriveWorks will continue after 10 seconds unless the application has already exited.

Using the Task in a Specification Macro

This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.

Outputs are only available within Specification Macros. Currently Outputs are not available for Specification Flow.

Status Outputs

This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs in the Task Node Outputs section of Specification Macros Task Node.

The status output navigation is as follows:

Success

  • The application ran and finished within the timeout period.

Success with Warnings

  • N/A - should never be fulfilled.

Failed

  • Application failed to start (for example: the application is not installed).
  • Application did not finish within the timeout period and had to be terminated.