SplitJson 2025.10.9.21

Bundle

org.apache.nifi | nifi-standard-nar

Description

Splits a JSON File into multiple, separate FlowFiles for an array element specified by a JsonPath expression. Each generated FlowFile is comprised of an element of the specified array and transferred to relationship ‘split,’ with the original file transferred to the ‘original’ relationship. If the specified JsonPath is not found or does not evaluate to an array element, the original file is routed to ‘failure’ and no files are generated.

Tags

json, jsonpath, split

Input Requirement

REQUIRED

Supports Sensitive Dynamic Properties

false

Properties

PropertyDescription
JsonPath ExpressionA JsonPath expression that indicates the array element to split into JSON/scalar fragments.
Max String LengthThe maximum allowed length of a string value when parsing the JSON document
Null Value RepresentationIndicates the desired representation of JSON Path expressions resulting in a null value.

Relationships

NameDescription
failureIf a FlowFile fails processing for any reason (for example, the FlowFile is not valid JSON or the specified path does not exist), it will be routed to this relationship
originalThe original FlowFile that was split into segments. If the FlowFile fails processing, nothing will be sent to this relationship
splitAll segments of the original FlowFile will be routed to this relationship

Writes attributes

NameDescription
fragment.identifierAll split FlowFiles produced from the same parent FlowFile will have the same randomly generated UUID added for this attribute
fragment.indexA one-up number that indicates the ordering of the split FlowFiles that were created from a single parent FlowFile
fragment.countThe number of split FlowFiles generated from the parent FlowFile
segment.original.filenameThe filename of the parent FlowFile