XMLFRagmenter.

每个片段都作为单独的FME功能输出片段端口。端口的每个特性都有一个XML_FRAGMENT.属性保存片段。该片段是一个有效的XML文档，可以通过后续的基于XML和/或基于xquery的转换器进行进一步处理。

添加了三个附加属性片段特点:

• xml_matched_element.- 记录匹配的元素。如果匹配表达式的最后一个组件是通配符（*），则该属性可用于标识匹配该表达式的匹配元素。
• XML_ID.- 为该元素保留一个ID。此属性不保证全局唯一，但它只在输入文档的上下文中是唯一的。
• xml_parent_id- 保留该元素的父级的ID。如果元素的父级不匹配，或者它没有任何父级，则此属性为空。
• xml_parent_child_pos-表示元素相对于其父元素的位置。如果元素的父元素不匹配，或者它没有任何父元素，则此属性为空。xml_parent_child_pos从0开始计数。

如果平坦选项已启用，然后是片段功能将具有与匹配的XML元素的内容相关的其他属性。

XML源类型是XML文件或其值是整个XML文档的特征属性。

此参数指定要映射的片段。特性路径可以是空格分隔的xfMap匹配表达式，也可以在新行上指定每个表达式。

此参数可以直接在文本框中输入，也可以单击浏览按钮来显示编辑器或选择特性属性。

例子

xmlns: < dc:元数据dc = " http://purl.org/dc/elements/1.1/ " >

犹他州< dc:主题> < / dc:主题>

边界

县

< dc:主题>管理> < / dc:主题

< dc:主题> geoscientificInformation > < / dc:主题

此数据集代表犹他州的县域边界，1：24,000规模。

 2004-04-20T00：00：00.000 

 DataSet 

< dc:标识符xmlns: dc = " http://purl.org/dc/elements/1.1/ " > {42 ae2814-fcc1-4bc2-baf4-ca3e55514997} > < / dc:标识符

 en 

< dcmiBox: northlimit单位= "十进制度" > 42.01 < / dcmiBox: northlimit >

  -  109.21 

 36.98 

  -  114.1 

> < / dcmiBox:框

> < / dc:元数据

这些是一些特性路径xfMap表达式，针对上述输入文档:

*”dc:主题”	将每个提取到一个XML片段中，总共产生5个片段特性。
*“dc:空间/ dcmiBox:盒子”	提取片段，但必须是父级。
*“DCMIBOX：BOX / *”	将中的每个子组提取到片段中，4个碎片特征对应于，，和。
*“DC：主题DC：空间/ DCMIBOX：BOX DCMIBOX：BOX / *”	前面三个匹配的表达式组合在一起，每个表达式用空格分隔。

如果“元素要匹配”的特征路径匹配多个元素，则此参数可用于指定结果中应排除哪些元素。此参数的输入还采用“元素以匹配”参数中描述的特征路径XFMAP表达式的形式。

Using the input document above, if the ‘Elements to Match’ is set to ‘dcmi:Box/*’ and ‘Elements to Exclude’ is set to ‘dcmi:northlimit dcmi:eastlimit” then only 2 fragment features will be output corresponding only to and elements.

将此参数设置为“是”将将其属性与“输入”功能与输出功能合并。

可以指定此参数将匹配元素的子元素提取为xml片段。

例子

The same XML input as shown in the above example – with the Feature Paths xfMap expression set to “dcmiBox:Box”, the default options accepted in Flatten Options, and Elements As XML Fragments set to ‘dcmi:northlimit dcmi:southlimit” – will produce the following feature. (The differences compared to the previous example are highlighted in bold.)

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

功能类型:“XMLFragmenter_FRAGMENTS”

属性(encoded: utf-16): ' eastlimit'有值' -109.21'

属性(编码:utf - 16):“eastlimit。单位的值是“十进制度”

属性（字符串）：`fme_type'有值`fme_no_geom'

属性(encoded: utf-16): ' northlimit'的值是' 42.01'

属性（编码：UTF-16）：`Northlimit.Units'有价值`十进制学位'

属性(encoded: utf-16): ' southlimit'有值' 36.98'

属性（编码：utf-16）：`southlimit.units'有价值`十进制学位

属性(encoded: utf-16): ' westlimit'有值' -114.1'

属性(编码:utf - 16):“westlimit。单位的值是“十进制度”

属性(encoded: utf-16): ' xml_fragment'有值' ?
            
16”?>
            
xmlns: dcmiBox = " http://dublincore.org/documents/2000/07/11/dcmi-box/ " >
            
< dcmiBox: northlimit单位= "十进制度" > 42.01 < / dcmiBox: northlimit >
            
  -  109.21 
            
 36.98 
            
  -  114.1 
            
> < / dcmiBox:盒子的
            
属性（编码：UTF-16）：`XML_FRAGMENT_NORTHLIMIT {0}'具有值`<？XML版本=“1.0”编码=“UTF-16”？>  42.01 '
            
属性（编码：UTF-16）：`XML_FRAGMENT_SOUTHLIMIT {0}'具有值`<？XML版本=“1.0”编码=“UTF-16”？>  36.98 '
            
属性（编码：UTF-16）：`XML_ID'具有值`id-box-1.2.1.11.1'
            
属性（编码：utf-16）：`xml_matched_element'有值`box'
            
属性(字符串):' xml_type'有一个值' xml_no_geom'
            
几何类型：未知（0）
            
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
           

“选项”按钮打开XML平坦选项对话框。这些选项控制匹配元素的子节点作为生成的功能上的属性/属性列表被展平。

默认视图是基本模式，其中列出了几个选项:

• > Sub-Elements To Ignore:指定匹配元素(来自Flatten Paths)的子元素应该被忽略。例如，在上面的例子中，如果Flatten Paths是“shipto”，那么如果这个选项被设置为“country city”，那么国家和城市的内容在输出中都会被忽略。
• 跳过空元素：指定是否应将空元素映射为空功能属性
• 添加自定义前缀>前缀：为将从扁平XML结构中添加的所有功能属性指定前缀
• 包括XML子位置>属性名称：指定其值将成为其父级中子元素的位置的属性名称。
• > Ancestor Element(s):指定Flatten Path中元素的父元素，其XML属性也将作为特性属性添加到输出中。

Advanced按钮打开Advanced Editor，它提供了自定义特性属性的附加选项。下表描述了每个选项的功能。这里的选项允许自定义将添加到FME Features的匹配XML子树的属性和属性列表。

选项(示例值)	描述	默认值	可能的价值
分离器=“。”	在命名匹配元素的子元素属性时，此选项的值用作分隔符。	时期 （。）	任何字符串
Map-空元素=“是”	如果设置为yes，则任何空元素都将作为空值属性添加到特性中。否则，属性将不会添加到特性中。	默认值如果未指定：是的	是的不 取值范围:任意字符串
matched-prefix = "属性"	该选项控制生成的FME特性属性是否以匹配元素的名称作为前缀。 如果值为yes，则匹配元素的属性和其所有子项都是前缀的 如果值为否，则没有匹配元素名称的任何一个特征属性都不是前缀 如果该值是儿童，那么只有匹配元素的子项是前缀的 如果值为属性，则只有匹配元素的属性是前缀的。	默认值如果未指定：是的	是的不|儿童|属性
matched-attributes = "是的"	如果此选项设置为YES，则匹配元素的属性被映射为FME功能属性。否则，忽略匹配元素​​的属性。 匹配 - 前缀选项也可以设置为属性或是，以允许属性以匹配元素的名称为前缀。	默认值如果未指定：是的	是的不
匹配 - 祖先attributes =“”	该选项控制是否应该将来自匹配元素祖先的XML属性包含为FME特性属性。 - “父”或“1”：添加匹配元素的父级的XML属性 - 'grandparent'或'2':添加匹配元素的祖父元素的XML属性 - “root”或'-1'：添加文档根的XML属性 - 添加任何非负数：通过从匹配元素上升起x级别来添加祖先的XML属性。0是匹配的元素。 要包含多个祖先，多个值可以用一个空格分隔。 例如：要从root，父和大父父级获取属性，我们可以指定 matched-ancestor-attributes =“父母祖父母根”		父母|祖父母|根
Cardinality =“+ {？}”	此选项可以指定为空间分隔的基数指令列表。	默认值:+ {?}(如果有多个相同名称的子元素，则将其视为一个列表)	可能的值：请参阅XML阅读器文档中的XFMAP部分。
除了= " "	除了除以映射规则的匹配或除属性之外，除了属性之外会接受与匹配项相同类型的表达式。 例如，表达式except="€parent/child{2}"€可用于从结构子规则的输出中排除元素中包含的第二个元素。		任何路径表达式
结构 - 前缀=“”	此选项可以设置为非空字符串，该字符串用作对匹配元素生成的每个属性的前缀。		任何字符串
child-position-attribute = " "	当这个选项被设置为非空字符串时，每个子元素将生成一个额外的特性属性，其值将是子元素在其父元素中的位置。		任何字符串
attribute-identifier = " "	XML属性可以与叶元素区分开来。通过将此选项设置为非空字符串，XML阅读器将向叶元素中的属性添加前缀。

所有选项都有更详细的示例和描述FME读者/作家手册：XML（可扩展标记语言）阅读器/作家。

例子

鉴于与上述相同的XML输入，功能路径XFMAP表达式设置为“DCMIBOX：BOAK”，“扁平选项”中的默认选项将产生以下功能：

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

功能类型:“XMLFragmenter_FRAGMENTS”

属性(encoded: utf-16): ' eastlimit'有值' -109.21'

属性(编码:utf - 16):“eastlimit。单位的值是“十进制度”

属性（字符串）：`fme_type'有值`fme_no_geom'

属性(encoded: utf-16): ' northlimit'的值是' 42.01'

属性（编码：UTF-16）：`Northlimit.Units'有价值`十进制学位'

属性(encoded: utf-16): ' southlimit'有值' 36.98'

属性（编码：utf-16）：`southlimit.units'有价值`十进制学位

属性(encoded: utf-16): ' westlimit'有值' -114.1'

属性(编码:utf - 16):“westlimit。单位的值是“十进制度”

属性(encoded: utf-16): ' xml_fragment'有值' ?
            
16”?>
            
xmlns: dcmiBox = " http://dublincore.org/documents/2000/07/11/dcmi-box/ " >
            
< dcmiBox: northlimit单位= "十进制度" > 42.01 < / dcmiBox: northlimit >
            
  -  109.21 
            
 36.98 
            
  -  114.1 
            
> < / dcmiBox:盒子的
            
属性（编码：UTF-16）：`XML_ID'具有值`id-box-1.2.1.11.1'
            
属性（编码：utf-16）：`xml_matched_element'有值`box'
            
属性(字符串):' xml_type'有一个值' xml_no_geom'
            
几何类型：未知（0）
            
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
           

暴露任何属性，以便其他变换器可以使用它们。直接在文本框中输入或单击“浏览”按钮以显示编辑器并在那里添加属性。