EvaluateXQuery 2025.5.31.15¶
捆绑包¶
org.apache.nifi | nifi-standard-nar
描述¶
对照 FlowFile 的内容评估一个或多个 XQueries。 这些 XQueries 的结果将分配给“FlowFile Attributes”或写入 FlowFile 本身的内容，具体取决于处理器的配置。XQueries 通过添加用户定义的属性来输入；属性的名称映射到要放置结果的“Attribute Name”（如果“Destination”是“flowfile-attribute”；否则，属性名称将被忽略）。 该属性的值必须是有效的 XQuery。 如果 XQuery 返回多个结果，则将为每个结果创建新的属性或 FlowFiles（分别用于“flowfile-attribute”或“flowfile-content”的“Destinations”）（属性将在指定的属性名称后面追加一个“.n”递增编号）。 如果提供的任何 XQuery 返回结果，则 FlowFile 将路由到“matched”。如果没有提供的 XQuery 返回结果，则 FlowFile 将路由到“unmatched”。 如果“Destination”是“flowfile-attribute”且 XQueries 不匹配任何内容，则不会将任何属性应用于 FlowFile。
输入要求¶
REQUIRED
支持敏感的动态属性¶
false
属性¶
属性 |
描述 |
|---|---|
目标 |
指明 XQuery 评估的结果是写入 FlowFile 内容还是写入 FlowFile 属性。如果设置为 <flowfile-content>，则只能指定一个 XQuery 且属性名称将被忽略。 如果设置为 <flowfile-attribute> 且 XQuery 返回多个结果，则将向 theFlowFile 添加多个属性，每个属性的名称后面追加一个“.n”递增编号 |
输出：缩进 |
指定处理器在输出结果树时是否可以添加额外的空白。 |
输出：方法 |
确定应用于输出结果树的总体方法。 |
输出：省略 XML 声明 |
指定处理器在转换结果树时是否应输出 XML 声明。 |
验证 DTD |
允许在 XML 中嵌入文档类型声明。应禁用此功能以避免 XML 实体扩展漏洞。 |
关系¶
名称 |
描述 |
|---|---|
failure |
当 XQuery 无法根据 FlowFile 的内容进行评估时，FlowFiles 将路由到此关系。 |
matched |
成功评估 XQuery 且 FlowFile 因此被修改后，FlowFiles 将路由到此关系 |
unmatched |
当 XQuery 与 FlowFile 的内容不匹配且目标设置为“flowfile-content”时，FlowFiles 将路由到此关系 |
写入属性¶
名称 |
描述 |
|---|---|
user-defined |
如果 <Destination> 属性设置为 flowfile-attribute，则该处理器会添加用户定义的属性。 |