Process Start

Launches a Windows process or task and optionally allow interaction via StdIn, StdOut and StdError.

Revision History

1.0.0.2 Initial Release
2.0.0.2 Added more checks (only available on the 23 Refresh)

Properties

Connection

Type: Connection Input

Username
Type: String
Provides the username to be used when starting the process.

Password
Type: Password
Provides the password to be used when starting the process.

CreateNoWindow
Type: Boolean
When true, indicates that the launched process will not have a visible window.

UseShellExecute
Type: Boolean
Indicates whether to use the operating system shell to launch the process. Processes launched via shell can't be engaged with.

WaitForExit
Type: Boolean
Determines whether the Node should block until the launched process exits.

FileName

Type: String Input
Indicates the name of the file to launch. This may be the path to an executable file or a file that has an associated handler.

Arguments

Type: String Input
Provides additional command-line arguments.

Verb

Type: String Input
Provides the verb to use when opening an application or document.

WorkingDirectory

Type: String Input
Provides the working directory for the process

StdIn

Type: Multiline Text Input
Provides a way to inject input to the launched process via StdIn.

StdOut

Type: Multiline Text Output
Returns data emitted by the launched process via StdOut.

StdErr

Type: Multiline Text Output
Returns data emitted by the launched process via StdErr.

ProcessID

Type: Int32 Output
The ProcessID Property

WindowHandle

Type: Int32 Output
Returns the handle to the primary application window if relevant.

ExitCode

Type: Int32 Output
Returns the process exit code.

Remarks

This Node provides a powerful way to engage with existing or legacy systems and supports tasks ranging from opening documents, executing simple commands (eg. document print) and engagement with Windows console applications (eg. via StdIn/StdOut and command-line arguments).

Ensure that the appropriate DropPoint is used. It may be necessary to use a 32bit DropPoint to launch and engage with 32bit processes.

There are two basic techniques. When UseShellExecute is set to true, the process is launched and the Node returns asynchronously (ie. fire and forget). When UseShellExecute is set to false with WaitForExit set to true, a process can be engaged via StdIn and StdOut.

Examples

See Sample Workflow for examples.

See Also

SSH Client