Création et utilisation d'un fichier de correspondances personnalisé SharePoint
Exemple : Une liste Document Library ne contient que des documents. Vous pouvez également ajouter Custom List, une liste qui contiendra des éléments de liste génériques. Un utilisateur peut avoir deux listes Document Library, mais décide d’ajouter plus de colonnes (métadonnées) à la deuxième liste.
CES 7.0.6607+ (avril 2014) Le connecteur Microsoft SharePoint contient un fichier de correspondances par défaut ([CES_Path]\bin\Coveo.CES.CustomCrawlers.SharePoint.MappingFile.xml) qui contient des correspondances pour tous les types de liste standards. Utiliser le fichier de correspondances par défaut permet d’indexer du contenu standard de SharePoint.
Pendant que le contenu de métadonnées personnalisées telles que les colonnes personnalisées d’une liste est lié à des champs par défaut, dans une situation où vous identifiez des métadonnées personnalisées qui ne sont pas correctement liées, vous pouvez considérer la création et l’utilisation d’un fichier de correspondances personnalisé pour veiller à ce que le contenu des métadonnées personnalisées soit lié aux champs spécifiques.
Le connecteur SharePoint peut placer plusieurs types de correspondances dans la propriété MappingType pour chaque élément, séparé par des points-virgules, avant d’être envoyés à l’index.
Ces types de correspondances sont arrangés en ordre de plus ou moins spécifique :
-
Type d’élément + identifiant (un GUID)
-
Type d’élément + titre
-
Type d’élément + type de base
Exemple : Un élément d’une liste Contact peut avoir le MappingType suivant :
ListItem.{432-1123243434-343331};ListItem.My Contact List;ListItem.Contacts
Les éléments autres que List et List Items ont leur identifiant et leur nom :
Web.{58943-43849273-483922};Web.MyWeb
Pour tous les documents, la propriété DocumentType est définie au type d’élément de base (par exemple : ListItem).
Par conséquent, tel qu’affiché dans l’exemple suivant, un fichier de correspondances peut lier spécifiquement un groupe de listes ou une seule liste à un groupe particulier de champs.
Important : Des points-virgules (;) sont utilisés afin de séparer les éléments dans le fichier de correspondances. Lorsque vous souhaitez lier un élément dont le titre contient un caractère ;, retirez le caractère dans la propriété MappingType (<Mapping type="[Item title]">).
<?xml version="1.0" encoding="utf-8"?>
<Mappings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Version>1</Version>
<CommonMapping>
<Fields />
</CommonMapping>
...
<Mapping type="ListItem.Announcements">
<Title>%[coveo_SiteName] - %[Title]</Title>
<Body>%[Description]</Body>
<Fields />
</Mapping>
<Mapping type="ListItem.GenericList.My custom list">
<Title>%[coveo_SiteName] - %[Title]</Title>
<Body>%[Description]</Body>
<Fields>
<Field name="myfield1">%[ows_customTextColumn1]</Field>
<Field name="myfield2">%[ows_customTextColumn2]</Field>
<Field name="myfield3">%[ows_customTextColumn3]</Field>
</Fields>
</Mapping>
<Mapping type="ListItem.{432-1123243434-343331}">
<Title>%[coveo_SiteName] - %[Title]</Title>
<Body>%[Description]</Body>
<Fields>
<Field name="myfield4">%[ows_customTextColumn4]</Field>
<Field name="myfield5">%[ows_customTextColumn5]</Field>
<Field name="myfield6">%[ows_customTextColumn6]</Field>
</Fields>
</Mapping>
<Mapping type="Web.MyWebApp">
<Fields>
<Field name="syssearchablemeta">%[Description]</Field>
<Field name="mywebstuff">%[some_metadata]</Field>
</Fields>
</Mapping>
</Mappings>
Pour créer un fichier de correspondances personnalisé SharePoint
-
Connectez-vous au serveur maître de Coveo avec un compte d'administrateur.
-
Copiez le fichier de correspondances par défaut ([CES_Path]\bin\Coveo.CES.CustomCrawlers.SharePoint.MappingFile.xml) et renommez la copie dans un dossier sous [Index_Path]\Config\ afin de veiller à ce que le fichier fasse partie de votre configuration d’index.
Exemple : Lorsque votre index est dans le lecteur D: et vous indexez votre intranet SharePoint 2013, renommez la copie du fichier de correspondances par défaut à :
D:\CES70\Config\Connectors\SharePoint2013IntranetMapping.xml
-
À l’aide d’un éditeur de texte, modifiez des correspondances existantes ou ajoutez des nouvelles correspondances afin de faire lier spécifiquement vos métadonnées personnalisées.
Note : Le fichier de correspondances SharePoint doit respecter le schéma de fichier de correspondances standard (voir Schéma standard d'un fichier de correspondances).
Prochaines étapes?
-
Dans la source, veillez à sélectionner le fichier de correspondances personnalisé que vous avez créé (voir Configuration et indexation d'une source Microsoft SharePoint).
-
Si vous avez ajouté des champs personnalisés, veillez à les ajouter au groupe de champs utilisé par la source (voir Vue d'ensemble du déploiement du connecteur Microsoft SharePoint).