Doc produitsMenu

Plateforme Coveo 7.0 >
Aide à l'administrateur > Connecteurs > Connecteur Microsoft SharePoint > Création et utilisation d'un fichier de correspondances personnalisé

Création et utilisation d'un fichier de correspondances personnalisé SharePoint

Un fichier de correspondances associe des métadonnées de SharePoint avec des champs d’index de Coveo. SharePoint est composé essentiellement de listes et d’éléments de liste. Chaque liste a un Base List Type, pour représenter ce qu’elle contient et comment interagir avec elle.

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

  1. Connectez-vous au serveur maître de Coveo avec un compte d'administrateur.

  2. 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

  3. À 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?