EvaluateJsonPath 2025.10.2.19¶
バンドル¶
org.apache.nifi | nifi-standard-nar
説明¶
Evaluates one or more JsonPath expressions against the content of a FlowFile. The results of those expressions are assigned to FlowFile Attributes or are written to the content of the FlowFile itself, depending on configuration of the Processor. JsonPaths are entered by adding user-defined properties; the name of the property maps to the Attribute Name into which the result will be placed (if the Destination is flowfile-attribute; otherwise, the property name is ignored). The value of the property must be a valid JsonPath expression. A Return Type of 'auto-detect' will make a determination based off the configured destination. When 'Destination' is set to 'flowfile-attribute,' a return type of 'scalar' will be used. When 'Destination' is set to 'flowfile-content,' a return type of 'JSON' will be used. If the JsonPath evaluates to a JSON array or JSON object and the Return Type is set to 'scalar' the FlowFile will be unmodified and will be routed to failure. A Return Type of JSON can return scalar values if the provided JsonPath evaluates to the specified value and will be routed as a match. If Destination is 'flowfile-content' and the JsonPath does not evaluate to a defined path, the FlowFile will be routed to 'unmatched' without having its contents modified. If Destination is 'flowfile-attribute' and the expression matches nothing, attributes will be created with empty strings as the value unless 'Path Not Found Behaviour' is set to 'skip', and the FlowFile will always be routed to 'matched.'
入力要件¶
REQUIRED
機密動的プロパティをサポート¶
false
プロパティ¶
プロパティ |
説明 |
|---|---|
目的地 |
JsonPath の評価結果を、 FlowFile コンテンツに書き込むか、 FlowFile 属性に書き込むかを指定します。属性を使用する場合は、Attribute Name プロパティを指定する必要があります。flowfile-content にセットされた場合、 JsonPath は1つしか指定できず、プロパティ名は無視されます。 |
最大文字列長 |
JSON ドキュメントをパースする際に許容される文字列値の最大長。 |
null値の表現 |
null 値を返す JSON パス式の望ましい表現を示します。 |
パスが見つからない動作 |
destinationが 'flowfile-attribute' にセットされている場合に、 JSON パス式が見つからない場合の処理方法を示します。「warn」を選択すると、 JSON パス式が見つからない場合に警告が表示されます。「skip」を選択すると、一致しない JSON パス式の属性が省略されます。 |
返されるタイプ |
Indicates the desired return type of the JSON Path expressions. Selecting 'auto-detect' will set the return type to 'json' for a Destination of 'flowfile-content', and 'scalar' for a Destination of 'flowfile-attribute'. |
リレーションシップ¶
名前 |
説明 |
|---|---|
failure |
FlowFiles は、 JsonPath が FlowFile の内容に対して評価できない場合、この関係にルーティングされます。たとえば、 FlowFile が JSON 有効でない場合などです。 |
matched |
FlowFiles は、 JsonPath が正常に評価され、その結果 FlowFile が変更されると、この関係にルーティングされます。 |
unmatched |
FlowFiles は、 JsonPath が FlowFile のコンテンツと一致せず、Destination が flowfile-content にセットされている場合、この関係にルーティングされます。 |