Communauté

Doc produitsMenu

Création et utilisation d'un fichier de correspondances Jive

Par défaut, le connecteur Jive utilise le fichier de correspondances par défaut ([CES_Path]\Bin\Coveo.CES.CustomCrawler.Jive.Mappings.xml. Si vous souhaitez personnaliser la façon dont le connecteur associe des métadonnées de Jive à des champs d'index, vous pouvez créer un fichier de correspondances personnalisé.

Note : Le connecteur Jive utilise le schéma standard de fichier de correspondances (voir Schéma standard d'un fichier de correspondances) afin de configurer les métadonnées de vos documents Jive originaux qui seront associées avec les champs des documents dans l'index Coveo.

La première section du fichier de correspondances, CommonMappings, définit les champs qui s'appliqueront à chaque document. 

<?xml version="1.0" encoding="utf-8" ?>
<Mappings>
  <Version>1</Version>
  <CommonMapping>
    <Fields>
      <Field name="sysauthor">%[author.displayName]</Field>
      <!-- Jive system fields -->
      <Field name="syscstag">%[tags]</Field>
      <Field name="syscstaggroup">%[categories]</Field>
      <Field name="syscsplace">%[coveo.places.titles]</Field>
      <Field name="syscsplacetype">%[coveo.places.types]</Field>
    </Fields>
  </CommonMapping>

Exemple : L'association <Field name="sysauthor">%[author.displayName]</Field> donne au connecteur la consigne de copier la valeur des métadonnées author.displayName de Jive et les coller dans le champ sysauthor de l'index Coveo pour chaque document indexé.

Les sections suivantes du fichier de correspondances Jive définissent les champs pour différents types de documents Jive (file, space, direct message...).

Exemple : Les champs du type person de documents Jive sont donnés dans l'extrait suivant d'un fichier de correspondances. 

<Mapping type="person">
  <Title>%[displayName]</Title>
  <Body> %[displayName] %[emails(work).value] %[jive.profile(Title).value]</Body>
  <Fields>
    <Field name="UserProfile_FirstName">%[name.givenName]</Field>
    <Field name="UserProfile_LastName">%[name.familyName]</Field>
    <Field name="UserProfile_AccountName">%[jive.username]</Field>
    <Field name="UserProfile_Title">%[jive.profile(Title).value]</Field>
    <Field name="UserProfile_AboutMe">%[jive.profile(Biography).value]</Field>
    <Field name="UserProfile_PictureURL">%[thumbnailUrl]</Field>
    <Field name="UserProfile_WorkEmail">%[emails(work).value]</Field>
    <Field name="UserProfile_WorkPhone">%[phoneNumbers(work).value]</Field>
    <Field name="mobile">%[phoneNumbers(mobile).value]</Field>
    <Field name="syslocation">%[location]</Field>
    <Field name="sysfiletype">csuser</Field>
    <!-- Jive system fields -->
    <Field name="syscsitemtype">User</Field>
  </Fields>
</Mapping>

Note : Le fichier de correspondances intégré n'inclut que les métadonnées Jive standards, donc aucune des métadonnées Jive personnalisées ou de type business. Toutefois, le connecteur récupère toutes les métadonnées. Si vous créez et assignez à votre source Jive un groupe de champs qui contient des noms de champs qui correspondent exactement aux noms des métadonnées, ils seront associés automatiquement (voir Ajout ou modification de champs personnalisés). Il est donc recommandé d'agrandir votre groupe de champs de la source Jive afin d'inclure des champs correspondants pour toutes les métadonnées utiles (voir Modification du groupe de champs utilisé par une source).

Pour créer et utiliser un fichier de correspondances personnalisé

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

  2. À l'aide d'un éditeur de texte :

    1. Créez un fichier XML qui respecte le schéma de fichier de correspondances.

      Astuce : Vous pouvez utiliser une copie du fichier de correspondances par défaut comme point de départ.

    2. Enregistrez le fichier à l'aide d'un nom de votre choix dans le dossier [Index_Path]\Config.

      Exemple : C:\CES7\Config\MyJiveMapping.xml

  3. Donnez au connecteur la consigne d'utiliser ce fichier de correspondances pour une certaine source en ajoutant le chemin d'accès du fichier de correspondances au paramètre de source Fichier de correspondances (voir Configuration et indexation d'une source Jive).