EXE

The EXE component executes the specified external program.

Stream Information

InputFormatAll
Number of Inputs1
OutputFormatXML,CSV,FixedLength,Text,HTML,Binary,MIME
Description

If the StreamPassThrough property is set to False, the executed program's output is passed to this component's output stream. If the StreamPassThrough property is set to True, the input stream is copied directly to the output stream.

Component Properties

NameData Type/SelectionMappingDescription
FilePathstringYes

The path of the program to execute.

If the path contains a space, the entire string must be surrounded by double quotes.

ArgumentstringYes

Defines the arguments passed to the program.

If the arguments are separated by a space, put them within double quotes. Although the program's path and arguments are separate properties, it is possible to define the arguments in the FilePath property field. For example, "cmd.exe /c test.bat". The file path and argument properties are combined to create a single command line. The Argument property can be set using a Mapper component.

DirectorystringYes

The directory in which the program exists.

If this property is not defined, the project owner's home directory is used.

STDINbooleanYes

If True, this component's input stream is directly passed to the program.

TimeoutintYes

The time, in seconds, to wait for the program to end.

If the program does not end before the specified time, the program is terminated, and an Exception is thrown.

If set to zero, this component will not timeout.

StreamPassThroughbooleanYes

If this property is set to False, the executed program's output is passed to this components' output stream. If this property is set to True, the input stream is passed directly to the output stream.

OutputEncodingstringNoneSpecifies the program's standard output encoding.
ReturnCodeintOutput OnlyThis read-only property is set to the return code returned by the executed program.
StderrCheckbooleanYes

If True, this component check stderr output and throw exception .

Loop Management

This component cannot be the starting point for a loop.

Transaction Management

Commit

Do Nothing

Rollback

Do Nothing

Exceptions

TypeParametersFlow Input StreamError CodeCause
Exception none

This component's input stream.

none The program can not be executed.
none The program does not end before the period set by the Timeout property.
none The program outputs an error.

Running Batch Files

Windows

Windows batch files and DOS commands can be executed.
Example 1 : "cmd.exe /c test.bat"
Example 2 : "cmd.exe /c dir"

Unix

Unix platform shell scripts can be executed like the example below:
"sh ./test.sh"