EvaluateXQuery

描述:

根据一个或多个XQuery来解析数据流中的内容。解析XQuery的结果将依赖于参数配置来决定作为数据流的属性还是数据流的内容。 XQuery的设置通过用户添加自定属性方式提供；自定义属性名将映射为存放解析XPath值的属性名(如果<目标>是'数据流属性'，否则属性名将忽略)。自定义属性的值必须是有效的XQuery表达式。如果XQuery解析出多个结果，将针对每个结果创建新的属性或者数据流(当<目标>是'数据流属性'或者'数据流内容')，其中属性将带有'.n'数字序列的属性名。 如果设置的XQuery有返回结果，数据流将输出到'matched'连线。 如果设置的XQuery没有返回结果，数据流将输出到'unmatched'连线. 如果<目标>是'数据流属性'并且XQuery没有任何匹配，则没有任何属性添加到数据流中。

标签:

XML, evaluate, XPath, XQuery, 解析, 计算

参数:

如下列表中，必填参数则标识为加粗. 其他未加粗参数，则表示为可选参数。表中同时提到参数默认值设置.

名字	默认值	允许值列表	描述
目标	数据流内容	- 数据流内容 - 数据流属性	决定XQuery解析的结果是写入数据流中还是作为数据流的属性。如果作为属性，则必须添加相应的动态参数。如果作为数据流输出，则只能添加一个XQuery动态参数，且参数名将被忽略。如果设置为'数据流属性'并且XQuery解析出多个结果，多个属性将被添加到数据流中，则每个属性名将添加带有'.n'数字序列的特殊属性名。
输出方式	xml	- xml - html - text	用于结果的输出标识方式
省略XML声明	添加	- 省略 - 添加	当输出结果时，是否输出XML的声明
输出缩进	false	- true - false	当输出结果时，是否可以添加额外的缩进空格字符
DTD验证	验证	- 验证 - 不验证	决定XML内容是否需要DTD验证。

动态参数:

名字	值	描述
A FlowFile attribute(if <Destination> is set to 'flowfile-attribute'	An XQuery	If <Destination>='flowfile-attribute' then the FlowFile attribute is set to the result of the XQuery. If <Destination>='flowfile-content' then the FlowFile content is set to the result of the XQuery. 不支持表达式语言

连线:

名字	描述
failure	当XQuery不能解析输入数据流的内容时，数据流将输出到此连线。例如，如果输入数据流不是有效的XML，或者返回类型是'节点集'且解析出多个节点。
unmatched	当XQuery不能匹配数据流内容且<目的>设置为'数据流内容'时，数据流将输出到此连线
matched	当XQuery成功解析输入数据流的内容且数据流被修改后，数据流将输出到此连线

读取属性:

未提供。

写入属性:

名字	描述
user-defined	如果<目的>设置为'数据流属性'后添加的自定义属性

状态管理:

该组件不保存状态。

限制:

该组件没有限制

输入流要求:

组件必须提供输入流。

系统资源考量:

未提供。