EvaluateXPath 2025.5.31.15¶

バンドル¶

org.apache.nifi | nifi-standard-nar

説明¶

FlowFile の内容に対して、1つ以上の XPaths を評価します。これらの XPaths の結果は、プロセッサーの構成に応じて、 FlowFile 属性に割り当てられるか、 FlowFile 自体のコンテンツに書き込まれます。XPaths はユーザー定義のプロパティを追加することで入力されます。プロパティの名前は、結果が置かれる属性名にマッピングされます（Destinationがflowfile-attributeの場合、それ以外の場合、プロパティ名は無視されます）。プロパティの値は有効な XPath 式でなければなりません。XPath が複数のノードに評価され、Return Type が（直接、または Destination が 'flowfile-content' の 'auto-detect' を介して） 'nodeset' にセットされている場合、 FlowFile は変更されず、失敗にルーティングされます。XPath がノードとして評価されない場合、 FlowFile は、その内容が変更されることなく「unmatched」にルーティングされます。Destinationがflowfile-attributeで、式が何もマッチしない場合、属性は空文字列を値として作成され、 FlowFile は、常に'matched'にルーティングされます。

タグ¶

XML, XPath, 評価する

入力要件¶

REQUIRED

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

false

プロパティ¶

プロパティ	説明
目的地	XPath の評価結果を、 FlowFile コンテンツに書き込むか、 FlowFile 属性に書き込むかを指定します。属性を使用する場合は、Attribute Name プロパティを指定する必要があります。flowfile-content にセットされた場合、 XPath は1つしか指定できず、プロパティ名は無視されます。
返されるタイプ	Xpath 式の返り値のタイプを指定します。「auto-detect」を選択すると、戻り値のタイプがDestinationが「flowfile-content」の場合は「nodeset」に、Destinationが「flowfile-attribute」の場合は「文字列」にセットされます。
DTD の検証	XML に埋め込まれたドキュメントタイプ宣言を許可します。XML エンティティ拡張の脆弱性を避けるため、この機能は無効にしてください。

リレーションシップ¶

名前	説明
failure	FlowFiles は、 XPath が FlowFile の内容に対して評価できない場合、このリレーションにルーティングされます。例えば、 FlowFile が有効でない XML 場合、またはリターンタイプが「ノードセット」であり、 XPath が複数のノードに評価される場合などです。
matched	FlowFiles は、 XPath が正常に評価され、その結果 FlowFile が変更されると、この関係にルーティングされます。
unmatched	FlowFiles は、 XPath が FlowFile のコンテンツと一致せず、Destination が flowfile-content にセットされている場合、この関係にルーティングされます。

属性の書き込み¶

名前	説明
user-defined	このプロセッサーは、<Destination> プロパティが flowfile-attribute にセットされている場合、ユーザー定義属性を追加します。