Mapping, élément
Dernière modification : mardi 22 juin 2010
S’applique à : 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' />
Attributs et éléments
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributs
Attribut |
Description |
|---|---|
path |
Obligatoire. Spécifie une expression XPath pour le nœud XML de récupération du contenu. |
attr |
Spécifie le nom de propriété de la propriété analysée créée. Obligatoire uniquement lorsque l’élément ne fait pas partie de MappingGroup. |
propset |
Facultatif. Spécifie une chaîne représentant un GUID propset hexadécimal. Remplace le jeu de propriétés par défaut. S’applique uniquement lorsque l’élément ne fait pas partie de MappingGroup. |
type |
Facultatif. Spécifie un type variant qui remplace le type variant par défaut. S’applique uniquement lorsque l’élément ne fait pas partie d’un élément MappingGroup. |
sep-str |
Facultatif. Spécifie la chaîne de séparation lorsque le chemin d’accès correspond à plusieurs nœuds XML. Valeur par défaut : un seul espace. |
post-str |
Facultatif. Spécifie une chaîne à ajouter à la fin du contenu extrait. Valeur par défaut : une chaîne vide. |
ignore-white-space |
Facultatif. La valeur yes indique que les espaces consécutifs sont remplacés par un seul espace. La valeur no indique l’absence de mappage de plusieurs espaces blancs. Valeur par défaut : yes |
strip-tags |
Facultatif. La valeur yes indique que les balises d’éléments enfants sont débarrassées du contenu extrait. C’est le cas par exemple, lorsque le chemin d’accès correspond à un élément qui contient des éléments enfants. La valeur no indique que les balises de sous-éléments sont conservées dans le contenu extrait. Vous ne devez pas utiliser no si la propriété analysée est mappée à une propriété gérée interrogeable. Valeur par défaut : yes |
shallow |
Facultatif. La valeur yes indique que seul le texte de l’élément correspondant est extrait. La valeur no indique que le texte de tous les éléments XML descendants est également extrait. L’exemple suivant part du principe que l’attribut path contient une expression XPath qui correspond à l’élément body. Lorsque shallow="yes", seul Some text et End of body sont extraits. Lorsque shallow="no", more text est également extrait (avec Some text et End of body), car il s’agit d’un sous-élément descendant de <body>. Valeur par défaut : no |
mode |
Facultatif. Définit le comportement lorsqu’un autre élément Mapping ou MappingGroup inclut du contenu mappé au même nom de propriété. S’applique uniquement lorsque l’élément ne fait pas partie de MappingGroup. Valeur par défaut : append |
Attributs
Valeur |
Description |
|---|---|
append |
Ajoute le nouveau contenu à la fin du contenu existant. |
prepend |
Ajoute le nouveau contenu au début du contenu existant. |
overwrite |
Remplace le contenu existant. |
Éléments enfants
Aucun.
Éléments parents
Nom |
Description |
|---|---|
Spécifie un jeu de mappages entre les expressions XPath et les propriétés analysées. |
|
Mappe le contenu des éléments Mapping enfants à une propriété analysée. |
|
Définit un chemin d’accès de base commun pour les éléments Mapping, MappingGroup et SubTree contenus. |
Exemple
La première section de code fournit un exemple d’entrée XML. La seconde section de code fournit une configuration de mappeur XML associé qui mappe le titre, la taille et les mots clés aux propriétés analysées mytitle, mysize et 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>