你在这里: 流行的格式 > XML(可扩展标记语言)读/写 > 映射文件参考 > Reader Overview > Reader Mapping File Directives

Reader Directives

以下指令被XML阅读器处理。列出的后缀是由当前前缀在一个映射文件。默认情况下,对于XML阅读器XML

DATASET

必需/可选需要

此关键字指定输入XML文档的位置。XML读取器能够读取那些XML文档gzip压缩

工作台参数

源XML文件(S)

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

要么

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

SYSTEM_ENCODING

该指令规定了系统的编码。它的默认值是系统编码。

必需/可选

Optional

映射文件语法

XML_SYSTEM_ENCODING ISO-8859-3

工作台参数

系统编码

XFMAP

该指令规定了xfMap文档的位置。

MultipleXFMAPkeywords may be specified within a mapping file. Each xfMap will map features from the same input dataset. Alternatively, multiple xfMaps may be specified in a single value quotedXFMAP通过使用分号分隔每个xfMap路径指令。

必需/可选

Optional

映射文件语法

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,仅创建空的几何形状。

必需/可选

Optional

映射文件语法

XFMAP_BYPASS_GEOM_BUILDERSyes

XFMAP_FEATURE_PATHS, XFMAP_FEATURE_PATHS_EXCEPT

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

该match expressions specify which XML elements in the dataset should be extracted into features containing XML Fragments. The except expressions specify which XML elements in the match expressions should be excluded, and this is especially useful if the match expressions contains wildcard character.The fragments will be held in non-geometrical FME features under theirxml_fragment属性。

三个附加属性添加到该功能。其中一个记录所匹配的元素(xml_matched_element属性);其它适用于该元件的ID(在xml_id属性);和最后一个持有该元素的父ID的ID(在xml_parent_id属性)。

  • xml_matched_element可被用来确定哪些元素匹配的表达式的情况下,所述匹配的表达式的最后一个组件是一个通配符,“*”。需要注意的价值xml_matched_element也被设置为特征的特征类型。
  • xml_idattribute is not globally unique but is guarantee to be unique only in the context of the dataset.
  • xml_parent_id如果元素的父是不匹配的,或者它不具有任何父属性是空的。
  • xml_parent_child_poscontains the position of the element in relation to its parent. If the parent of the element is not matched or it doesn’t have any parent, then this attribute is empty.

XFMAP_FEATURE_PATHS指令是用于分解大XML文档转换成部分,其中这些部分可以进一步经由下游XML,的XQuery,XSLT或者文本处理工作台变压器操作是有用的。

见xfMap文档中的关于比赛的细节表达“匹配和除表达”部分。

必需/可选

Optional

映射文件语法

本实施例中提取的子从数据集转换成XML片段元件设有除了子:

XML_XFMAP_FEATURE_PATHS“CSW:SearchResult所/ *”
XML_XFMAP_FEATURE_PATHS_EXCEPT “CSW:SearchResult所/ CSW:元数据”

工作台参数

元素匹配和元素排除

XFMAP_FEATURE_PATHS_SUB_FRAGMENTS

This directive is to be used in conjunction withXFMAP_FEATURE_PATHS并允许匹配元素的孩子要被提取作为XML片段属性。

必需/可选

Optional

映射文件语法

This example extracts each child of为XML片段:

XML_XFMAP_FEATURE_PATHS“CSW:SearchResult所”

XML_XFMAP_FEATURE_PATHS_SUB_FRAGMENTS“CSW:SearchResult所/ *”

XFMAP_FEATURE_PATHS_STRUCTURE

该指令是在与XFMAP_FEATURE_PATHS一起使用,并且允许一个匹配元素的孩子暴露作为FME特征属性。

See the “Structure Element” section in the xfMap documentation for details regarding the options available and more examples.

必需/可选

Optional

映射文件语法

这个例子中提取元素插入FME功能属性的孩子:

XML_XFMAP_FEATURE_PATHS_STRUCTURE <结构/>

工作台参数

Flatten Options

CONTINUE_ON_GEOM_ERROR

而不是阻止读者,这个可选指令允许读者继续阅读并当遇到几何错误提取输入XML文档流功能。该指令的有效值为YES和NO,它的默认值是YES。

必需/可选

Optional

映射文件语法

XML_CONTINUE_ON_GEOM_ERROR YES

工作台参数

继续对几何误差

FEATURE_TYPES_SCHEMA_MODE

This directive specifies whether only feature types that exist in the dataset will be generated for the schema.

默认值是XML_SCHEMA其中XML读取器将生成所有的是,在应用模式存在(一个或多个)的特征类型,包括所有来自XML属性元素的可能的特征属性。

If the value is set to DATASET, then only feature types and attributes that are in the dataset will be generated. If attributes from both the dataset and XML Schema are desired, then set the value toDATASET_MERGE_XML_SCHEMA

必需/可选

Optional

XML_SCHEMA(默认)|DATASET |DATASET_MERGE_XML_SCHEMA

映射文件语法

这个例子中提取元素插入FME功能属性的孩子:

XML_FEATURE_TYPES_SCHEMA_MODE DATASET

VALIDATE_XFMAP

这个指令指定是否输入xfMap文件应针对其文档类型定义(DTD)进行验证。

必需/可选

Optional

汽车|是|没有(默认)

映射文件语法

XML_VALIDATE_XFMAP yes

工作台参数

验证XML映射文件

VALIDATE_DATASET

这个指令指定是否输入XML文档应针对DTD或XML模式进行验证。

必需/可选

Optional

汽车|是|没有(默认)

映射文件语法

XML_VALIDATE_DATASET是

工作台参数

验证XML数据集文件

FEATURE_ENCODING

这其中编码映射FME功能指令指定应该英寸

必需/可选

Optional

默认值是系统编码。

映射文件语法

XML_FEATURE_ENCODING Shift-JIS

MAPPING_FILE_ENCODING

这其中编码FME映射文件指令指定是英寸

必需/可选

Optional

When not specified, the FME mapping file is assumed to be encoded in the system encoding.

映射文件语法

XML_MAPPING_FILE_ENCODING ISO-8859-3

DOCUMENT_STREAM

This directive specifies as its value the input XML document to parse; that is, the XML document is specified inline in the FME mapping file.

注意:If present, this directive overrides the DATASET directive.

必需/可选

Optional

XFMAP_STREAM

该指令指定作为其值在FME映射文件内嵌xfMap文件。

注意:If present, it overrides the XFMAP directive.

必需/可选

Optional

XFMAP_SCHEMA

This directive specifies the xfMap(s) that are to be used when reading schema features. MultipleXFMAP_SCHEMAdirectives may also be specified as per theXFMAPdirective.

必需/可选

Optional

映射文件语法

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阅读器开关)文件允许的XML阅读器自动将自己配置为“已知的” XML数据集,而无需事先指定适当xfMaps。

既当该指令只适用的XFMAPXFMAP_STREAM指令不存在或为空。默认XRS文档也提供,所以XRS指令是可选的,即使它是适用的。

默认XRS文件被命名为xrs.xml,它位于XML / XRS子文件夹中FME安装文件夹中。

对于XRS的文档可以在找到XML / XRS / xrs_doc.txt文件。

必需/可选

Optional

映射文件语法

XML_XRS C:\ tmp目录\ my_xrs.xml

工作台参数

XRS文件

XR_PIPELINE

该XML阅读器允许几个xfMaps要在同一个文档流指定。每个xfMap可以通过解构输入流的层次结构为扁平结构构造其自己的特征表示为输入流,例如。该XR_PIPELINE指令允许跨xfMaps构建功能要应用的FME工厂流水线。

例如,XML格式可以在层次结构中定义他们区域,使得一个区域组件的XML表示含有直接或通过引用,线儿童,并且每行包含,无论是直接或通过引用,指向元素。一个xfMap只能构造一个特征的时间,因此,如果一个被xfMap映射区域元素来构造区域的特征,然后附加xfMaps需要分别映射线与点元素来构造线和点的功能,。该XR_PIPELINE然后指令可以用于对区域,线条应用工厂流水线,并点要素进行进一步处理之前,这些输出到FME,说来组装自己的拓扑结构,如果XML格式是基于拓扑。

必需/可选

Optional

映射文件语法

XML_XR_PIPELINE C:\tmp\my_topology_assembler.fmi

XFMAP_KEYWORD

This directive allows the specification for name-value pairs that become accessible in an xfMap with theexpression wherever expression sequences are allowed. See the xfMap表达部文档有关其用法的详细信息。

该指令可以在多个名称 - 值对的FME映射文件发生的次数有多个。

必需/可选

Optional

映射文件语法

XML_XFMAP_KEYWORD KEY0 value0
XML_XFMAP_KEYWORD key1的“我的其他价值”

XFMAP_KEYWORD_FILE

这个指令XFMAP_KEYWORD相似,但它allows name-value pairs to be specified in an external file.

该XFMAP_KEYWORD_FILE是一个XML文档。该文档中的每个关键字名称 - 值对与<关键字>元素中指定:

<关键字名=” ...”的值=” ...” />

Each keyword may in addition belong to a named group, thereby allowing keyword names to repeat when these belong to different groups. A keyword belongs to a named group if it is a child of the element:

<组名=” ...”> <关键字... /> <关键字... /> ... <...关键字/> 

未指定为一组的孩子关键字是默认的小组。属于默认组关键词必须是根元素的孩子。用于XFMAP_KEYWORD_FILE文件的根元素是<关键字>元素。

请注意,在与XFMAP_KEYWORD的FME映射文件中定义的关键字也是在默认组中,他们将优先于XFMAP_KEYWORD_FILE文档中定义如果发生冲突的关键字的关键词。

必需/可选

Optional

映射文件语法

sample_keyword_file.xml:

<?XML版本=” 1.0” 编码=” UTF-8” ?> <关键字> <组名称=” MyGroup的”> <关键字名称=” KEY1” 值=” VAL-1” /> <关键字名称=” KEY2”值=” VAL-2” />   XML_XR_PIPELINE C:\ TMP \ sample_keyword_file.xml

MAX_SCHEMA_SCAN_FEATURES

必需/可选

Optional

映射文件语法

XML_MAX_SCHEMA_SCAN_FEATURES 10000

任何正数

SEARCH_ENVELOPE

使用最小和最大x和y参数,定义了一个包围盒将被用于过滤输入功能。只有拥有返回与边框相互作用。

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

映射文件语法

_SEARCH_ENVELOPE

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

必需/可选

Optional

工作台参数

最小X,最小Y,最大X,最大Y

SEARCH_ENVELOPE_COORDINATE_SYSTEM

该指令规定,如果它比数据的坐标系不同的坐标搜索信封的系统。

坐标系directive, which specifies the coordinate system associated with the data to be read, must always be set if theSEARCH_ENVELOPE_COORDINATE_SYSTEM指令设置。

如果此指令设置,搜索信封的最低和最高点从重投影SEARCH_ENVELOPE_COORDINATE_SYSTEM读者坐标系之前,将所述包络。

必需/可选

Optional

映射文件语法

_SEARCH_ENVELOPE_COORDINATE_SYSTEM <坐标系>

工作台参数

搜寻信封坐标系

CLIP_TO_ENVELOPE

这个指令指定FME是否应该夹功能,在指定的信封SEARCH_ENVELOPEdirective.

YES |NO(默认值)

映射文件语法

_CLIP_TO_ENVELOPE [是|没有]

工作台参数

剪辑信封

EXPOSED_ATTRS

该指令允许格式的选择属性被显式添加到阅读器的功能类型。

This is similar to exposing format attributes on a reader feature type once it has been generated; however, it is even more powerful because it enables schema-driven applications other than Workbench to access and leverage these attributes as if they were explicitly on the schema as user attributes.

采摘的属性列表的结果是用逗号分隔的将被添加到架构的功能属性名称和类型的列表。目前,所有的读者特征类型将收到同一组的其他架构属性为读者的给定实例。

必需/可选

Optional

映射文件语法

Not applicable.

While it is possible for FME Objects applications to invoke this directive, the required format is not documented.

该指令的目的是用在我们的GUI应用程序(例如,工作台)只。

工作台参数

附加属性揭露

HTTP_AUTH_USER

必需/可选

Optional

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

映射文件语法

_HTTP_AUTH_USER someusername

工作台参数

Http Username

HTTP_AUTH_PASSWORD

必需/可选

Optional

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

映射文件语法

_HTTP_AUTH_PASSWORD password1234

工作台参数

HTTP密码

HTTP_AUTH_METHOD

必需/可选

Optional

指定的身份验证方法(基本,简要或NTLM)访问受密码保护的HTTP服务器时使用。

映射文件语法

_HTTP_AUTH_METHOD Digest

工作台参数

HTTP认证