EvaluateJsonPath 2025.5.31.15¶

バンドル¶

org.apache.nifi | nifi-standard-nar

説明¶

FlowFile の内容に対して、1 つ以上の JsonPath 式を評価します。これらの式の結果は、プロセッサーの構成に応じて、 FlowFile 属性に割り当てられるか、 FlowFile 自体のコンテンツに書き込まれます。JsonPaths はユーザー定義のプロパティを追加することで入力されます。プロパティの名前は、結果が置かれる属性名にマッピングされます（Destinationがflowfile-attributeの場合、それ以外の場合、プロパティ名は無視されます）。プロパティの値は有効な JsonPath 式でなければなりません。Return Typeが「auto-detect」の場合、構成された宛先に基づいて決定されます。'Destination' が 'flowfile-attribute' にセットされている場合、戻り値のタイプは「スカラー」となります。'Destination'が 'flowfile-content' に設定されている場合、 'JSON' のリターンタイプが使用されます。 JsonPath が JSON 配列または JSON オブジェクトとして評価され、リターンタイプが'スカラー'に設定されている場合、 FlowFile は変更されず、失敗にルーティングされます。戻り値のタイプの JSON は、提供された JsonPath が特定の値を評価し一致したものとしてルーティングされた場合、スカラー値を返すことができます。Destinationが 'flowfile-content' で、 JsonPath が定義されたパスに評価されない場合、 FlowFile は、その内容が変更されるることなく、 'unmatched' にルーティングされます。Destinationが'flowfile-attribute'で、式が何もマッチしない場合、'Path Not Found Behaviour'が'skip'にセットされていない限り、属性は空文字列を値として作成され、 FlowFile は常に 'matched' にルーティングされます。

タグ¶

JSON, JsonPath, 評価する

入力要件¶

REQUIRED

機密動的プロパティをサポート¶

false

プロパティ¶

プロパティ	説明
目的地	JsonPath の評価結果を、 FlowFile コンテンツに書き込むか、 FlowFile 属性に書き込むかを指定します。属性を使用する場合は、Attribute Name プロパティを指定する必要があります。flowfile-content にセットされた場合、 JsonPath は1つしか指定できず、プロパティ名は無視されます。
最大文字列長	JSON ドキュメントをパースする際に許容される文字列値の最大長。
null値の表現	null 値を返す JSON パス式の望ましい表現を示します。
パスが見つからない動作	destinationが 'flowfile-attribute' にセットされている場合に、 JSON パス式が見つからない場合の処理方法を示します。「warn」を選択すると、 JSON パス式が見つからない場合に警告が表示されます。「skip」を選択すると、一致しない JSON パス式の属性が省略されます。
返されるタイプ	JSON パス式の返り値のタイプを指定します。「auto-detect」を選択すると、Destinationが「flowfile-content」の場合は戻り値のタイプが「JSON」にセットされ、Destinationが「flowfile-attribute」の場合は戻り値のタイプが「scalar」に設定されます。

リレーションシップ¶

名前	説明
failure	FlowFiles は、 JsonPath が FlowFile の内容に対して評価できない場合、この関係にルーティングされます。たとえば、 FlowFile が JSON 有効でない場合などです。
matched	FlowFiles は、 JsonPath が正常に評価され、その結果 FlowFile が変更されると、この関係にルーティングされます。
unmatched	FlowFiles は、 JsonPath が FlowFile のコンテンツと一致せず、Destination が flowfile-content にセットされている場合、この関係にルーティングされます。