XML碎片器

每个片段通过碎片港口。端口中的每个功能都有一个xml片段包含片段的属性。片段是一个有效的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匹配表达式，也可以在新行指定每个表达式。

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

例子

             
              犹他州
             

             
              边界
             

             
              县
             

             
              行政的
             

             
              geoscientificInformation
             

             
              这组数据表示在1在犹他州县界：24,000比例。
             

             
              2004-04-20T00：00：00.000
             

             
              数据集
             

             
              {42AE2814-FCC1-4BC2-BAF4-CA3E55514997}
             

             
              恩
             

             
              42.01
             

             
              -109.21
             

             
              36.98
             

             
              -114.1
             

以下是xfMap表达式的几个特性路径，目标是 输入文件：

* “DC：主题”	每提取 生成一个XML片段，总共产生5个片段特性。
* “DC：空间/ dcmiBox：盒子”	提取 碎片，但是 必须是家长。
* “dcmiBox：盒/ *”	提取的每一个孩子 分成碎片，4个碎片特征对应于 , , 和 是输出。
* “DC：主题dc：空间/ dcmiBox：箱dcmiBox：盒/ *”	前面的三个匹配的表达式相结合，每个分离的由空格。

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

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

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

“选项”按钮打开“XML展平选项”对话框。这些选项控制匹配元素的子元素在生成的特征上展开为属性/属性列表。

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

• 忽略特定子元素>子元素忽略：指定应该忽略匹配的元素（从平铺路径）的儿童。例如，在上述例子中，如果拼合路径是“SHIPTO”，那么如果这个选项设置为“国家城市”，那么这两个国家和城市内容的输出被忽略。
• 跳过空元素：指定空的元素是否应该被映射为空要素属性
• 添加自定义前缀>前缀：指定所有前缀要素属性将从扁平XML结构添加
• 包括XML子位置>属性名称：指定值将成为其父项内的子元素的位置的属性名称。
• 添加ancestor属性>祖先元素（一个或多个）：指定其XML属性作为特征在输出属性也将添加平铺路径中的元素的父元素（一个或多个）。

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

选项（带有示例值）	描述	默认值	可能的值
隔板= “”。	该选项的这个值被用作匹配元素的儿童的属性命名的分隔符。	句点（。）	任何字符串
映射空元素=“是”	如果设置为YES，任何空元素将被添加到所述特征具有空值的属性。否则，属性不会被添加到功能。	如果没有指定缺省值：yes	是| no 可能的值：任何字符串
匹配前缀=“属性”	FME要素属性是否生产该选项控制将与匹配的元素的名称为前缀。 如果该值是肯定的，那么匹配元素的属性和它的所有孩子都被前缀 如果该值是否定的，那么所有的特征属性的前缀匹配与元素的名称 如果该值是孩子，那么只有匹配元素的儿童前缀 如果该值是属性，则仅匹配元素的属性前缀。	如果没有指定缺省值：yes	是| no | children | attributes
匹配的属性=“是”	如果此选项设置为yes，那么匹配元素的属性被映射为FME要素的属性。否则，匹配元素的属性被忽略。 匹配的前缀选项也可以设置为属性或者是允许属性与所匹配的元素的名称作为前缀。	如果没有指定缺省值：yes	是| no
匹配-祖先属性=“”	是否从所述匹配元素的祖先XML属性的选项控制应该被包括作为FME特征属性。 - “父”或“1”：该匹配元素的父元素的XML属性被添加 -“祖父母”或“2”：添加匹配元素祖父母的XML属性 -“根”或“-1”：添加文档根的XML属性 -任何非负数：通过从匹配元素向上x层添加祖先的XML属性。0是匹配的元素。 要包含多个祖先，可以用空格分隔多个值。 例如：要从根、父和父中获取属性，可以指定 matched祖先属性=“父祖父母根”		父母祖父母
基数= “+ {}？”	此选项可以指定为以空格分隔的基数指令列表。	默认值：+{？}（如果有多个同名子元素，则将其视为列表）	可能的值：请参阅XML阅读器文档中的xfMap部分。
除外=“”	except属性接受与映射规则的match或except属性相同类型的表达式。 例如，表达式except=“parent/child{2}”可用于排除第二个 元素包含在 结构子规则输出中的元素。		任何路径表达式
结构前缀=“”	此选项可以设置为非空字符串，作为为匹配元素生成的每个属性的前缀。		任何字符串
孩子位置属性=“”	当此选项设置为非空字符串时，每个子元素将生成一个附加的feature属性，其值将是子元素在其父元素中的位置。		任何字符串
属性标识符=“”	XML属性可以与叶元素区分开来。通过将此选项设置为非空字符串，XML读取器将向叶元素中的属性追加前缀。

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

例子

给定与上述相同的XML输入，并且特征路径xfMap expression设置为“dcmiBox:Box”，其中“展平选项”中的默认选项将生成以下特征：

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

功能类型：`XMLFragmenter\u FRAGMENTS'

属性（编码：utf-16）：“eastlimit”的值为“-109.21”

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

属性（字符串）：`fme_type'具有值`fme_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：dcmiBox = “http://dublincore.org/documents/2000/07/11/dcmi-box/”>
               
                
                 42.01
                
               
                
                 -109.21
                
               
                
                 36.98
                
               
                
                 -114.1
                
               
“
               
属性（编码：UTF-16）：`xml_id”具有值'ID-箱1.2.1.11.1'
               
属性（编码：UTF-16）：`xml_matched_element '具有值'盒'
               
属性（字符串）：`XML_TYPE '的价值'xml_no_geom'
               
几何类型：未知（0）
               
=================================================
              

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

例子

如上例所示的相同XML输入（Feature Paths xfMap expression设置为“dcmi Box:Box”、Flatten options中接受的默认选项和Fragment中的子选项元素（Fragment设置为“dcmi:northlimit dcmi:southlimit”）将生成以下功能。（与上一个示例相比的差异以粗体突出显示。）

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

功能类型：`XMLFragmenter\u FRAGMENTS'

属性（编码：utf-16）：“eastlimit”的值为“-109.21”

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

属性（字符串）：`fme_type'具有值`fme_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：dcmiBox = “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-箱1.2.1.11.1'
               
属性（编码：UTF-16）：`xml_matched_element '具有值'盒'
               
属性（字符串）：`XML_TYPE '的价值'xml_no_geom'
               
几何类型：未知（0）
               
=================================================
              

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