支持的格式列表

搜索在线变压器图库

你在这里: 流行格式 > XML(可扩展标记语言)读写器 > 映射文件参考 > 读者概述 > 读取映射文件指令

读者指令

下面的指令由XML阅读器处理。所列的后缀以当前后缀为前缀< ReaderKeyword >在映射文件中。默认情况下,< ReaderKeyword >对于XML阅读器来说是XML．

数据集

必需的/可选：要求

这个关键字指定输入XML文档的位置。XML Reader能够读取XML文档gzip．

工作台参数

源XML文件(年代)

例子：

XML_DATASET http://www.亚搏在线safe.com/data/points1.xml

或

XML_DATASET C: \ tmp \ \ points1.gz数据

SYSTEM_ENCODING

这个指令指定了系统的编码。默认值为系统编码。

必需的/可选

可选

映射文件的语法

XML_SYSTEM_ENCODING iso - 8859 - 3

工作台参数

系统编码

XFMAP

这个指令指定了xfMap文档的位置。

多个XFMAP关键字可以在映射文件中指定。每个xfMap将从相同的输入数据集映射特性。或者，多个xfmap可以在一个引用的值中指定XFMAP指令，用分号分隔每个xfMap路径。

必需的/可选

可选

映射文件的语法

XML_XFMAP C: \ tmp \ \ features.xmp数据

或

XML_XFMAP“C: \ tmp \ drainages.xmp; C: \ tmp \ pits_pipes.xmp”

或

XML_XFMAP C: \ tmp \ drainages.xmp
XML_XFMAP C: \ tmp \ pits_pipes.xmp

工作台参数

XML映射文件

XFMAP_BYPASS_GEOM_BUILDERS

这个指令指定几何图形是否应该在xfMap映射规则中完全构建。

理想情况下，可以将此指令设置为yes，以加速使用XML阅读器生成不需要从几何图形中获取任何信息的模式特性的过程。如果设置为yes，则只创建空几何。

必需的/可选

可选

映射文件的语法

XFMAP_BYPASS_GEOM_BUILDERS是的

XFMAP_FEATURE_PATHS, XFMAP_FEATURE_PATHS_EXCEPT

这个指令指定用空格分隔的xfMap匹配或except表达式。

匹配表达式指定应该将数据集中的哪些XML元素提取到包含XML片段的特性中。except表达式指定匹配表达式中的哪些XML元素应该被排除，如果匹配表达式包含通配符，这一点特别有用。碎片将在其下保持非几何FME特征xml_fragment属性。

该特性还添加了三个附加属性。一个记录匹配的元素(xml_matched_element属性);另一个保存该元素的ID (xml_id属性);最后一个包含该元素的父ID的IDxml_parent_id属性)。

  • 的xml_matched_element如果匹配表达式的最后一个组件是通配符“*”，则可用于标识哪个元素匹配了该表达式。的值xml_matched_element也被设置为功能部件的功能部件类型。
  • 的xml_id属性不是全局唯一的，但保证仅在数据集上下文中是唯一的。
  • 的xml_parent_id如果元素的父元素不匹配或它没有任何父元素，则属性为空。

  • 的xml_parent_child_pos包含元素相对于其父元素的位置。如果元素的父元素不匹配，或者它没有任何父元素，则此属性为空。

的XFMAP_FEATURE_PATHS指令对于将大型XML文档分解为多个部分非常有用，这些部分可以通过下游的XML、XQuery、XSLT或文本处理工作台转换器进行进一步操作。

有关匹配表达式的详细信息，请参阅xfMap文档中的“匹配和除表达式”一节。

必需的/可选

可选

映射文件的语法

这个例子将元素的子元素从数据集中提取到XML片段特性中，除了子元素:

XML_XFMAP_FEATURE_PATHS“世界基督教联合会:SearchResults / *”
XML_XFMAP_FEATURE_PATHS_EXCEPT“世界基督教联合会:SearchResults /世界基督教联合会:元数据”

工作台参数

匹配元素和排除元素

XFMAP_FEATURE_PATHS_SUB_FRAGMENTS

此指令将与XFMAP_FEATURE_PATHS并且允许将匹配元素的子元素提取为XML片段属性。

必需的/可选

可选

映射文件的语法

的每个子节点< cswSearchResults >生成XML片段:

XML_XFMAP_FEATURE_PATHS“世界基督教联合会:SearchResults”

XML_XFMAP_FEATURE_PATHS_SUB_FRAGMENTS“世界基督教联合会:SearchResults / *”

XFMAP_FEATURE_PATHS_STRUCTURE

这个指令将与XFMAP_FEATURE_PATHS一起使用，允许匹配元素的子元素作为FME Features的属性公开。

有关可用选项和更多示例的详细信息，请参阅xfMap文档中的“Structure Element”一节。

必需的/可选

可选

映射文件的语法

这个例子将元素的子元素提取到FME Features的属性中:

XML_XFMAP_FEATURE_PATHS_STRUCTURE <结构/ >

工作台参数

平的选择

CONTINUE_ON_GEOM_ERROR

这个可选指令允许读者在遇到几何错误时继续阅读并从输入XML文档流中提取特征，而不是停止读者。该指令的有效值为YES和NO，默认值为YES。

必需的/可选

可选

映射文件的语法

XML_CONTINUE_ON_GEOM_ERROR是的

工作台参数

继续几何误差

FEATURE_TYPES_SCHEMA_MODE

此指令指定是否只为模式生成数据集中存在的特性类型。

默认值为XML_SCHEMA其中，XML阅读器将生成应用程序模式中存在的所有特性类型，包括来自XML属性元素的所有可能的特性属性。

如果将该值设置为DATASET，则只生成数据集中的特性类型和属性。如果需要来自数据集和XML模式的属性，则将值设置为DATASET_MERGE_XML_SCHEMA．

必需的/可选

可选

值

XML_SCHEMA (default) |数据集| DATASET_MERGE_XML_SCHEMA

映射文件的语法

这个例子将元素的子元素提取到FME Features的属性中:

XML_FEATURE_TYPES_SCHEMA_MODE数据集

VALIDATE_XFMAP

该指令指定是否应该根据文档类型定义(document Type Definition, DTD)验证输入的xfMap文档。

必需的/可选

可选

值

自动|是|否(默认)

映射文件的语法

XML_VALIDATE_XFMAP是的

工作台参数

验证XML映射文件

VALIDATE_DATASET

该指令指定应该根据DTD还是XML模式验证输入XML文档。

必需的/可选

可选

值

自动|是|否(默认)

映射文件的语法

XML_VALIDATE_DATASET是的

工作台参数

验证XML数据集文件

FEATURE_ENCODING

这个指令指定映射的FME特性应该在哪个编码中。

必需的/可选

可选

值

默认值为系统编码。

映射文件的语法

由于XML_FEATURE_ENCODING shift - jis

MAPPING_FILE_ENCODING

该指令指定FME映射文件的编码方式。

必需的/可选

可选

值

如果未指定，则假定FME映射文件在系统编码中进行编码。

映射文件的语法

XML_MAPPING_FILE_ENCODING iso - 8859 - 3

DOCUMENT_STREAM

这个指令指定要解析的输入XML文档作为它的值;也就是说，XML文档是在FME映射文件中内联指定的。

注意:如果有，这个指令将覆盖DATASET指令。

必需的/可选

可选

XFMAP_STREAM

该指令指定FME映射文件中的内联xfMap文档作为其值。

注意:如果存在，它将覆盖XFMAP指令。

必需的/可选

可选

XFMAP_SCHEMA

这个指令指定了在读取模式特性时使用的xfMap。多个XFMAP_SCHEMA指令也可以根据XFMAP指令。

必需的/可选

可选

映射文件的语法

XML_XFMAP_SCHEMA C: \ tmp \ \ schema_features.xmp数据

或

XML_XFMAP_SCHEMA“C: s_drainages.xmp; C: s_pits_pipes.xmp”

或

XML_XFMAP_SCHEMA C: \ tmp \ schema_drainages.xmp
XML_XFMAP_SCHEMA C: \ tmp \ schema_pits_pipes.xmp

XRS

该指令指定XRS文档的路径。XRS (XML Reader Switch)文档允许XML Reader自动配置自己读取“已知的”XML数据集，而不需要预先指定适当的xfMaps。

该指令仅适用于XFMAP和XFMAP_STREAM指令不存在或为空。还提供了一个默认的XRS文档，因此即使适用XRS指令，它也是可选的。

默认XRS文档已命名xrs.xml，它位于xml / xrsFME安装文件夹的子文件夹。

文档中可以找到XRS的文档xml / xrs / xrs_doc.txt文件。

必需的/可选

可选

映射文件的语法

XML_XRS C: \ tmp \ my_xrs.xml

工作台参数

XRS文件

XR_PIPELINE

XML阅读器允许在同一文档流上指定几个xfmap。每个xfMap可以为输入流构造自己的特征表示，例如，通过将输入流的层次结构解构为一个扁平的结构。的XR_PIPELINE指令允许FME工厂管道应用于跨xfMaps构造的特性。

例如，XML格式可以在层次结构中定义它们的区域，这样一个区域元素的XML表示直接或通过引用包含行子元素，每一行直接或通过引用包含点元素。一个xfMap一次只能构造一个特性，所以如果一个xfMap要映射区域元素来构造区域特性，那么需要额外的xfMap来分别映射线元素和点元素来构造线元素和点元素。的XR_PIPELINE如果XML格式是基于拓扑结构的，那么指令可以用于在区域、线和点特征上应用工厂管道进行进一步的处理，然后输出到FME，比如组装它们的拓扑。

必需的/可选

可选

映射文件的语法

XML_XR_PIPELINE C: \ tmp \ my_topology_assembler.fmi

XFMAP_KEYWORD

此指令允许名称-值对规范，在xfMap中可以使用<关键词>表达式，只要表达式序列是允许的。看到xfMap<关键词>表达式部分文档获取关于其用法的更多信息。

此指令可能在FME映射文件中多次出现多个名称-值对。

必需的/可选

可选

映射文件的语法

XML_XFMAP_KEYWORD key0 value0
XML_XFMAP_KEYWORD key1 " my other value "

XFMAP_KEYWORD_FILE

这个指令类似于XFMAP_KEYWORD，但是它允许在外部文件中指定名称-值对。

XFMAP_KEYWORD_FILE是一个XML文档。文档中的每个关键字名值对都由元素指定:

<关键词name = "…“价值= "…" / >

每个关键字还可以属于一个命名组，因此允许在属于不同组时重复关键字名称。关键字属于命名组，如果它是元素的子元素:

<组名= "……" > <关键词……/ > <关键词……/ >……<关键词…/ > < /组>

未指定为组子元素的关键字在默认组中。属于默认组的关键字必须是根元素的子元素。XFMAP_KEYWORD_FILE文档的根元素是元素。

注意，使用XFMAP_KEYWORD的FME映射文件中定义的关键字也在默认组中，如果发生关键字冲突，它们将优先于XFMAP_KEYWORD_FILE文档中定义的关键字。

必需的/可选

可选

映射文件的语法

sample_keyword_file.xml:

<？xml version = " 1.0 " encoding = " utf - 8 " ?>      XML_XR_PIPELINE C:\tmp\sample_keyword_file.xml

MAX_SCHEMA_SCAN_FEATURES

必需的/可选

可选

映射文件的语法

XML_MAX_SCHEMA_SCAN_FEATURES 10000

值

任何正数

SEARCH_ENVELOPE

使用最小和最大x和y参数，定义一个用于过滤输入特性的边界框。只返回与边界框交互的特性。

如果搜索信封的所有四个坐标都指定为0，则搜索信封将被禁用。

映射文件的语法

_SEARCH_ENVELOPE

注意:如果搜索信封的所有四个坐标都被指定为零，则搜索信封将被禁用。

必需的/可选

可选

工作台参数

最小的X，最小的Y，最大的X，最大的Y

SEARCH_ENVELOPE_COORDINATE_SYSTEM

如果搜索包的坐标系统不同于数据的坐标系统，则此指令指定搜索包的坐标系统。

的COORDINATE_SYSTEM指令，它指定与要读取的数据相关联的坐标系统，如果SEARCH_ENVELOPE_COORDINATE_SYSTEM设置指令。

如果设置了这个指令，搜索包络的最小和最大点将从SEARCH_ENVELOPE_COORDINATE_SYSTEM读者COORDINATE_SYSTEM在申请信封之前。

必需的/可选

可选

映射文件的语法

< ReaderKeyword > _SEARCH_ENVELOPE_COORDINATE_SYSTEM <坐标系统>

工作台参数

搜索包络坐标系统

CLIP_TO_ENVELOPE

该指令指定FME是否应该将功能剪辑到SEARCH_ENVELOPE指令。

值

YES | NO(默认)

映射文件的语法

_CLIP_TO_ENVELOPE [yes | no]

工作台参数

夹信封

EXPOSED_ATTRS

这个指令允许选择显式添加到阅读器特性类型的格式属性。

这类似于一旦生成了阅读器特性类型就公开格式属性;然而，它甚至更强大，因为它允许Workbench以外的模式驱动应用程序访问和利用这些属性，就像它们显式地作为用户属性在模式上一样。

选择属性列表的结果是一个逗号分隔的属性名和类型列表，这些属性名和类型将添加到模式特性中。目前，所有读取器特性类型都将为给定的读取器实例接收相同的附加模式属性集。

必需的/可选

可选

映射文件的语法

不适用。

虽然FME对象应用程序可以调用此指令，但所需的格式没有文档记录。

这个指令只用于我们的GUI应用程序(例如，工作台)。

工作台参数

要公开的其他属性

HTTP_AUTH_USER

必需的/可选

可选

指定访问受密码保护的HTTP服务器时使用的用户名。

映射文件的语法

< ReaderKeyword > _HTTP_AUTH_USER someusername

工作台参数

Http用户名

HTTP_AUTH_PASSWORD

必需的/可选

可选

指定访问受密码保护的HTTP服务器时使用的密码。

映射文件的语法

< ReaderKeyword > _HTTP_AUTH_PASSWORD password1234

工作台参数

HTTP密码

HTTP_AUTH_METHOD

必需的/可选

可选

指定访问受密码保护的HTTP服务器时使用的身份验证方法(Basic、Digest或NTLM)。

映射文件的语法

< ReaderKeyword > _HTTP_AUTH_METHOD消化

工作台参数

HTTP身份验证