XML片段器

每个片段通过碎片端口。端口中的每个功能都将具有XML_片段保存片段的属性。片段是一个有效的XML文档，可以通过随后的基于XML和/或基于XQuery的转换器进行进一步处理。

将另外三个属性添加到碎片特征：

• xml_匹配的_元素–记录匹配的元素。此属性可用于标识与表达式匹配的元素，如果匹配表达式的最后一个组件是通配符（*）。
• XML标识–持有该元素的ID。此属性不保证全局唯一，但它只在输入文档的上下文中是唯一的。
• XML父级\u id–保留该元素父级的ID。如果元素的父元素不匹配或没有父元素，则此属性为空。
• XML父级子级位置–保持元素相对于其父元素的位置。如果元素的父元素不匹配或没有父元素，则此属性为空。xml父级\子级\ pos的计数从0开始。

如果展平选项已启用，然后碎片特性将具有与匹配的XML元素的内容相关的附加属性。

XML源类型要么是XML文件，要么是其值为整个XML文档的功能属性。

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

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

例子

             
              犹他州
             

             
              边界
             

             
              县
             

             
              行政的
             

             
              地球科学信息
             

             
              该数据集以1:24000的比例代表犹他州的县界线。
             

             
              2004年4月20日00:00:00.000
             

             
              数据集
             

             
              42AE2814-FCC1-4BC2-BAF4-CA3E55514997_
             

             
              英语
             

             
              42.01年
             

             
              -109.21条
             

             
              36.98美元
             

             
              -114.1条
             

以下是一些针对上述内容的xfmap表达式的特性路径 输入文档：

*“dc:主题”	提取间隔 在一个XML片段中，共产生5个片段特征。
*“dc:空间/dcmibox:box”	提取 碎片，但是 必须是父级。
*“dcmibox:框/*”	提取的每个子级 变成碎片，4个碎片特征对应 ，请 ，请 和 是输出。
*“dc:主题dc:空间/dcmibox:box dcmibox:box/*”	前三个匹配表达式组合在一起，每个都用空格隔开。

如果“要匹配的元素”中的功能路径与多个元素匹配，然后，可以使用此参数指定应在结果中排除哪些元素。此参数的输入还采用“要匹配的元素”参数中描述的功能路径xfmap表达式的形式。

使用上面的输入文档，如果“要匹配的元素”设置为“dcmi:box/*”，而“要排除的元素”设置为“dcmi:northlimit dcmi:eastlimit”，则只会输出与 和 元素。

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

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

例子

与上面示例中所示的相同的XML输入–将特性路径xfmap表达式设置为“dcmibox:box”，平坦选项中接受的默认选项，元素作为XML片段设置为“dcmi:northlimit dcmi:southlimit”—将生成以下功能。（与前一个示例相比的差异以粗体突出显示。）

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

功能类型：`xmlsfragmenter_fragments'

属性（编码：utf-16）：`eastlimit'的值为`-109.21'

属性（编码：utf-16）：`eastlimit.units'的值为'decimal degrees'

属性（字符串）：'fm_type'具有值'fm_no_geom'

属性（编码：utf-16）：`northlimit'的值为'42.01'

属性（编码：utf-16）：`northlimit.units'的值为'decimal degrees'

属性（编码：utf-16）：'southlimit'的值为'36.98'

属性（编码：utf-16）：`southlimit.units'的值为'decimal degrees'

属性（编码：utf-16）：`westlimit'的值为`-114.1'

属性（编码：utf-16）：`westlimit.units'的值为'decimal degrees'

属性（编码：utf-16）：`xml_fragment'有值`？
             
16英寸？>
              
               
xmlns:dcmi box=“http://dublincore.org/documents/2000/07/11/dcmi-box/”>
               
                
                 42.01年
                
               
                
                 -109.21条
                
               
                
                 36.98美元
                
               
                
                 -114.1条
                
               
'
               
属性（编码：utf-16）：`xml_fragment_northlimit_0具有值`
                
                
                 42.01年
                '
               
属性（编码：utf-16）：`xml_fragment_southlimit_0具有值`
                
                
                 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展平选项”对话框。这些选项控制匹配元素的子元素，以便在生成的功能上作为属性/属性列表展平。

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

• 忽略特定子元素>要忽略的子元素：指定应忽略的匹配元素（从扁平路径）的子元素。例如，在上面的例子中，如果展平路径为“Shipto”，然后，如果将此选项设置为“Country City”，则输出中将忽略Country和City内容。
• 跳过空元素：指定是否应将空元素映射为空功能属性
• 添加自定义前缀>前缀：指定将从扁平XML结构添加的所有功能属性的前缀
• include xml child position>attribute name：指定属性名，其值将是子元素在其父元素中的位置。
• 添加祖先属性>祖先元素：指定扁平路径中元素的父元素，其XML属性也将作为功能属性添加到输出中。

“高级”按钮打开高级编辑器，它提供了自定义特征属性的其他选项。下表介绍了每个选项的功能。这里的选项允许自定义将添加到FME功能的匹配XML子树的属性和属性列表。

选项（带示例值）	说明	默认值	可能值
分隔符“”	此选项的值用作匹配元素子级属性的命名中的分隔符。	句号（.）	任意字符串
map empty elements=“是”	如果设置为是，任何空元素都将作为具有空值的属性添加到特性中。否则，这些属性不会添加到功能中。	未指定默认值：是	是否 可能值：任何字符串
matched prefix=“属性”	此选项控制生成的FME特征属性是否以匹配元素的名称作为前缀。 如果值为是，然后，匹配元素的属性及其所有子元素都加上前缀。 如果值为否，然后，所有特性属性都不会以匹配元素的名称作为前缀。 如果值是子级，然后只在匹配元素的子元素前面加前缀 如果值是属性，然后，只对匹配元素的属性加前缀。	未指定默认值：是	是否子项属性
matched attributes=“是”	如果此选项设置为“是”，则匹配元素的属性将映射为FME特征属性。否则，匹配元素的属性将被忽略。 matched prefix选项也可以设置为attributes或yes，以允许在属性前面加上匹配元素的名称。	未指定默认值：是	是否
匹配的祖先属性=“”	该选项控制来自匹配元素的祖先的XML属性是否应包含为FME特性属性。 -“parent”或“1”：添加匹配元素父级的XML属性 -“祖父母”或“2”：添加匹配元素的祖父母的XML属性 -“根”或“-1”：添加文档根的XML属性 -任何非负数：通过从匹配的元素向上x级添加祖先的XML属性。0是匹配的元素。 要包含多个祖先，多个值可以用空格分隔。 例如：要从根目录获取属性，父母和祖父母，我们可以指定 匹配的祖先属性=“父祖父母根目录”		父母祖父母根
基数=“？}他说：“这是一个很好的选择。”	此选项可以指定为以空格分隔的基数指令列表。	默认值：+？}（如果有多个同名的子元素，则将其视为列表）	可能的值：请参阅XML阅读器文档中的xfmap部分。
except=“”	except属性接受与映射规则的match或except属性相同类型的表达式。 例如，表达式except=“parent/child 2”可用于排除第二个 包含在a中的元素 来自结构子规则输出的元素。		任意路径表达式
结构前缀=“”	此选项可以设置为非空字符串，用作为匹配元素生成的每个属性的前缀。		任意字符串
子位置属性=“”	当此选项设置为非空字符串时，每个子元素将生成一个额外的特性属性，其值将是子元素在其父元素中的位置。		任意字符串
属性标识符=“”	XML属性可以与叶元素区分开来。通过将此选项设置为非空字符串，XML阅读器将为叶元素中的属性添加前缀。

所有选项在FME读写器手册：XML（可扩展标记语言）读写器.

例子

给定与上述相同的XML输入，功能路径xfmap表达式设置为“dcmibox:box”，其中“展平选项”中的默认选项将生成以下功能：

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

功能类型：`xmlsfragmenter_fragments'

属性（编码：utf-16）：`eastlimit'的值为`-109.21'

属性（编码：utf-16）：`eastlimit.units'的值为'decimal degrees'

属性（字符串）：'fm_type'具有值'fm_no_geom'

属性（编码：utf-16）：`northlimit'的值为'42.01'

属性（编码：utf-16）：`northlimit.units'的值为'decimal degrees'

属性（编码：utf-16）：'southlimit'的值为'36.98'

属性（编码：utf-16）：`southlimit.units'的值为'decimal degrees'

属性（编码：utf-16）：`westlimit'的值为`-114.1'

属性（编码：utf-16）：`westlimit.units'的值为'decimal degrees'

属性（编码：utf-16）：`xml_fragment'有值`？
             
16英寸？>
              
               
xmlns:dcmi box=“http://dublincore.org/documents/2000/07/11/dcmi-box/”>
               
                
                 42.01年
                
               
                
                 -109.21条
                
               
                
                 36.98美元
                
               
                
                 -114.1条
                
               
'
               
属性（编码：utf-16）：`xml_id'的值为'id-box-1.2.1.11.1'
               
属性（编码：utf-16）：`xml_matched_element'具有值'box'
               
属性（字符串）：'xml_type'具有值'xml_no_geom'
               
几何类型：未知（0）
               
======================================
                                            
              

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