通过

Mapping 元素

上次修改时间： 2015年3月9日

适用范围： SharePoint Server 2010

<Mapping path='XPath' attr='propName' propset='GUID' type='varType' sep-str='separator' post-str='postString' ignore-whitespace='yes|no' strip-tags='yes|no' shallow='yes|no' mode='append|prepend|overwrite' />

属性和元素

以下各节介绍了属性、子元素和父元素。

属性

属性

说明

path

必需。指定从 XPath 到 XML 的节点，从该节点检索内容。

attr

指定创建的已爬网属性的属性名。仅在元素不是 MappingGroup 的一部分时才必需。

propset

可选。指定表示十六进制 propset GUID 的字符串。取代默认的属性集。仅在元素不是 MappingGroup 的一部分时才适用。

type

可选。指定取代默认变量类型的变量类型规范。仅在元素不是 MappingGroup 元素的一部分时才适用。

sep-str

可选。指定路径与多个 XML 节点匹配时的分隔字符串。

默认值：单个空格字符。

post-str

可选。指定要追加至已提取内容的字符串。

默认值：空字符串。

ignore-white-space

可选。yes 值指示将连续的空白字符替换为单个空格。no 值指示无多个空格的映射。

默认值：yes

strip-tags

可选。yes 值指示已从已提取内容中抽取子元素标记。例如，当路径与包含子元素的元素匹配时。no 值指示将子元素标记保留在已提取内容中。如果已爬网属性映射至可搜索的托管属性，则不应使用 no。

默认值：yes

shallow

可选。yes 值指示仅提取匹配元素的文本。no 值指示还提取所有子项 XML 元素的文本。

下面的示例假定 path 属性包含与 body 元素匹配的 XPath 表达式 。

<body>
Some text
  <sub-body>  more text</sub-body>
End of body
</body>

当 shallow="yes" 时，仅提取 Some text 和 End of body。当 shallow="no" 时，还提取 more text（与 Some text 和 End of body 一同提取），因为它是 <body> 的子项子元素。

默认值：no

mode

可选。定义在其他 Mapping 元素或 MappingGroup 元素具有映射至同一属性名的内容时的行为。仅在元素不是 MappingGroup 的一部分时才适用。

默认值：append

属性

Value

Description

append

Adds the new content to the end of the existing content.

prepend

Adds the new content to the beginning of the existing content.

overwrite

Overwrites the existing content.

子元素

无。

父元素

名称

说明

XMLMappings

指定一组从 XPath 表达式到已爬网属性的映射。

MappingGroup

将子 Mapping 元素的内容映射至已爬网属性。

SubTree

定义包含的 Mapping、MappingGroup 和 SubTree 元素通用的基本路径。

示例

第一个代码段提供示例 XML 输入。第二个代码段提供关联的 XML 映射器配置，将标题、大小和关键字映射至已爬网属性 mytitle、mysize 和 mykeywords。

<Document>
  <title>My title</title>
  <size>128</size>
  <keywords>
    <keyword>math</keyword>
    <keyword>biology</keyword>
  </keywords>
</Document>

<XMLPropertiesCreator>
  <propset>d6ee4933-09c4-46e3-a5e4-b3787cb4a090</propset>
  <type>31</type>
  <XMLMappings>
    <Mapping attr="mytitle" path="//title"/>
    <Mapping attr="mysize" path="//size" propset="38c35ad5-69ee-4776-886f-95961a73d52d" type="3"/>
    <Mapping attr="mykeywords" path="//keyword" sep-str=","/>
  </XMLMappings>
</XMLPropertiesCreator>

请参阅

概念

自定义 XML 项处理

XML 映射程序架构

  • Last updated on