Skip to main content

InvokeScriptedProcessor

Description

Experimental - Invokes a script engine for a Processor defined in the given script. The script must define a valid class that implements the Processor interface, and it must set a variable 'processor' to an instance of the class. Processor methods such as onTrigger() will be delegated to the scripted Processor instance. Also any Relationships or PropertyDescriptors defined by the scripted processor will be added to the configuration dialog. The scripted processor can implement public void setLogger(ComponentLog logger) to get access to the parent logger, as well as public void onScheduled(ProcessContext context) and public void onStopped(ProcessContext context) methods to be invoked when the parent InvokeScriptedProcessor is scheduled or stopped, respectively. NOTE: The script will be loaded when the processor is populated with property values, see the Restrictions section for more security implications. Experimental: Impact of sustained usage not yet verified.

Tags

groovy, invoke, script

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
Script Engine *Script EngineGroovy
  • Groovy
Language Engine for executing scripts
Script FileScript FilePath to script file to execute. Only one of Script File or Script Body may be used

Supports Expression Language, using Environment variables.
Script BodyScript BodyBody of script to execute. Only one of Script File or Script Body may be used
Module DirectoryModule DirectoryComma-separated list of paths to files and/or directories which contain modules required by the script.

Supports Expression Language, using Environment variables.

Dynamic Properties

NameValueDescription
Script Engine Binding propertyBinding property value passed to Script RunnerUpdates a script engine property specified by the Dynamic Property's key with the value specified by the Dynamic Property's value

Supports Expression Language: Yes, evaluated using FlowFile Attributes and Environment variables.

Relationships

This processor has no relationships.

Reads Attributes

This processor does not read attributes.

Writes Attributes

This processor does not write attributes.

State Management

ScopeDescription
CLUSTER, LOCALScripts can store and retrieve state using the State Management APIs. Consult the State Manager section of the Developer's Guide for more details.

Restricted

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

Input Requirement

Input requirements are not specified for this component.

System Resource Considerations

This component does not specify system resource considerations.

See Also

ExecuteScript