Skip to main content

ExecuteProcess

Description

Runs an operating system command specified by the user and writes the output of that command to a FlowFile. If the command is expected to be long-running, the Processor can output the partial data on a specified interval. When this option is used, the output is expected to be in textual format, as it typically does not make sense to split binary data on arbitrary time-based intervals.

Tags

command, external, invoke, process, script, source

Properties

In the list below required Properties are shown with an asterisk (*). Other properties are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.

Display NameAPI NameDefault ValueAllowable ValuesDescription
Command *CommandSpecifies the command to be executed; if just the name of an executable is provided, it must be in the user's environment PATH.

Supports Expression Language, using Environment variables.
Command ArgumentsCommand ArgumentsThe arguments to supply to the executable delimited by white space. White space can be escaped by enclosing it in double-quotes.

Supports Expression Language, using Environment variables.
Batch DurationBatch DurationIf the process is expected to be long-running and produce textual output, a batch duration can be specified so that the output will be captured for this amount of time and a FlowFile will then be sent out with the results and a new FlowFile will be started, rather than waiting for the process to finish before sending out the results
Redirect Error StreamRedirect Error Streamfalse
  • true
  • false
If true will redirect any error stream output of the process to the output stream. This is particularly helpful for processes which write extensively to the error stream or for troubleshooting.
Working DirectoryWorking DirectoryThe directory to use as the current working directory when executing the command

Supports Expression Language, using Environment variables.
Argument Delimiter *Argument DelimiterDelimiter to use to separate arguments for a command [default: space]. Must be a single character.
Output MIME TypeOutput MIME typeSpecifies the value to set for the "mime.type" attribute. This property is ignored if 'Batch Duration' is set.

Dynamic Properties

NameValueDescription
An environment variable nameAn environment variable valueThese environment variables are passed to the process spawned by this Processor

Supports Expression Language: No

Relationships

NameDescription
successAll created FlowFiles are routed to this relationship

Reads Attributes

This processor does not read attributes.

Writes Attributes

NameDescription
commandExecuted command
command.argumentsArguments of the command
mime.typeSets the MIME type of the output if the 'Output MIME Type' property is set and 'Batch Duration' is not set

State Management

This component does not store state.

Restricted

Required PermissionExplanation
execute codeProvides operator the ability to execute arbitrary code assuming all permissions that NiFi has.

Input Requirement

This component does not allow an incoming relationship.

System Resource Considerations

This component does not specify system resource considerations.

See Also