Updates the Attributes for a FlowFile by using the Attribute Expression Language and/or deletes the attributes based on a regular expression
attributes, modification, update, delete, Attribute Expression Language, state
In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.
| Display Name | API Name | Default Value | Allowable Values | Description |
|---|---|---|---|---|
| Delete Attributes Expression | Delete Attributes Expression | Regular expression for attributes to be deleted from FlowFiles. Existing attributes that match will be deleted regardless of whether they are updated by this processor. Supports Expression Language: true (will be evaluated using flow file attributes and Environment variables) | ||
| Store State | Store State | Do not store state |
| Select whether or not state will be stored. Selecting 'Stateless' will offer the default functionality of purely updating the attributes on a FlowFile in a stateless manner. Selecting a stateful option will not only store the attributes on the FlowFile but also in the Processors state. See the 'Stateful Usage' topic of the 'Additional Details' section of this processor's documentation for more information |
| Stateful Variables Initial Value | Stateful Variables Initial Value | If using state to set/reference variables then this value is used to set the initial value of the stateful variable. This will only be used in the @OnScheduled method when state does not contain a value for the variable. This is required if running statefully but can be empty if needed. | ||
| Cache Value Lookup Cache Size | canonical-value-lookup-cache-size | 100 | Specifies how many canonical lookup values should be stored in the cache |
Supports Sensitive Dynamic Properties: No
Dynamic Properties allow the user to specify both the name and value of a property.
| Name | Value | Description |
|---|---|---|
| A FlowFile attribute to update | The value to set it to | Updates a FlowFile attribute specified by the Dynamic Property's key with the value specified by the Dynamic Property's value Supports Expression Language: true (will be evaluated using flow file attributes and Environment variables) |
| Name | Description |
|---|---|
| success | All successful FlowFiles are routed to this relationship |
| Name | Description |
|---|---|
| See additional details | This processor may write or remove zero or more attributes as described in additional details |
| Scope | Description |
|---|---|
| LOCAL | Gives the option to store values not only on the FlowFile but as stateful variables to be referenced in a recursive manner. |
Add a new FlowFile attribute
Leave "Delete Attributes Expression" and "Stateful Variables Initial Value" unset.
Set "Store State" to "Do not store state".
Add a new property. The name of the property will become the name of the newly added attribute.
The value of the property will become the value of the newly added attribute. The value may use the NiFi Expression Language in order to reference other
attributes or call Expression Language functions.
Overwrite a FlowFile attribute with a new value
Leave "Delete Attributes Expression" and "Stateful Variables Initial Value" unset.
Set "Store State" to "Do not store state".
Add a new property. The name of the property will become the name of the attribute whose value will be overwritten.
The value of the property will become the new value of the attribute. The value may use the NiFi Expression Language in order to reference other
attributes or call Expression Language functions.
For example, to change the txId attribute to the uppercase version of its current value, add a property named txId with a value of ${txId:toUpper()}
Rename a file
Leave "Delete Attributes Expression" and "Stateful Variables Initial Value" unset.
Set "Store State" to "Do not store state".
Add a new property whose name is filename and whose value is the desired filename.
For example, to set the filename to abc.txt, add a property named filename with a value of abc.txt.
To add the txId attribute as a prefix to the filename, add a property named filename with a value of ${txId}${filename}.
Or, to make the filename more readable, separate the txId from the rest of the filename with a hyphen by using a value of ${txId}-${filename}.