MappingGroup Element [XML Mapper Schema]

SharePoint 2010

Last modified: June 22, 2010

Applies to: SharePoint Server 2010

<MappingGroup base-path='basePath' attr='propName' propset='GUID' type='varType' sep-str='separator' pre-str='preString' post-str='postString' rec-sep-str='recSeparator' rec-pre-str='recPreString' rec-post-str='recPostString' select='merge|first|longest' mode='append|prepend|overwrite'></MappingGroup>

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

base-path

Required. Specifies an XPath base path that the Mapping elements within this group will be relative to.

attr

Required. Specifies the property name of the created crawled property.

propset

Optional. Specifies a string that represents a hexadecimal property set GUID. Overrides the default property set. Applies only when the element is not part of a MappingGroup element.

type

Optional. Specifies a variant type that overrides the default variant type. Applies only when the element is not part of a MappingGroup element.

sep-str

Optional. Specifies the separation string when the base-path matches more than one XML node.

Default: A single space character.

pre-str

Optional. Specifies a string to prepend to the extracted content.

Default: An empty string.

post-str

Optional. Specifies a string to append to the extracted content.

Default: An empty string.

rec-sep-str

Optional. Specifies the string separator to use between contents from each Mapping element in the group.

Default: A single space character.

rec-pre-str

Optional. Specifies a string to prepend to the first Mapping element in the group.

rec-post-str

Optional. Specifies a string to append to the last Mapping element in the group.

select

Optional. Defines which Mapping elements to retrieve content from.

Default: merge

mode

Optional. Defines the behavior when another Mapping element or MappingGroup element has mapped content to the same property name.

Default: append

select Attribute

Value

Description

merge

Merges the content from all elements by using the rec-sep-str, rec-pre-str, and rec-post-str attributes.

first

Gets content from the first element that has content.

longest

Gets content from the element that has the longest content.

mode Attribute

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.

Child Elements

Element

Description

Mapping

Maps an XPath expression to a crawled property.

Parent Elements

Element

Description

XMLMappings

Specifies a set of mappings from XPath expressions to crawled properties.

The first code section provides sample XML input. The second code section provides an associated XML Mapper configuration that provides two Mapping expressions inside a MappingGroup.

<Document>
  <Tags>
    <Keywords>funny</Keywords>
    <UserTags>hilarious</UserTags>
  </Tags>
</Document>
<XMLMappings>
  <MappingGroup attr="mytags" base-path="//Tags" rec-sep-str=",">
    <Mapping path="Keywords"/>
    <Mapping path="UserTags"/>
  </MappingGroup>
</XMLMappings>

This example will produce a crawled property that has the value funny,hilarious.

Show: