Détails du schéma pour créer un modèle de mappage de métadonnées

Article
07/08/2024

Note

Les informations sur la disponibilité des fonctionnalités sont les suivantes.

Centre de contact Dynamics 365 – embedded	Centre de contact Dynamics 365 – autonome	Dynamics 365 Customer Service
No	Oui	Oui

Cet article décrit les détails de schéma requis pour mapper les informations des fournisseurs de données externes aux entités d’article de la base de connaissances, et comment vous pouvez préparer votre propre fichier JSON de mappage de schéma à l’aide de divers champs et attributs.

Champs

Le tableau suivant répertorie les champs et les détails des champs que vous devez utiliser dans votre schéma JSON.

Nom du champ	Définition	Requise	active
Nom	Nom de la définition du champ	Non	Chaîne indiquant le nom du champ.
UniqueTargetFieldName	Est l’identificateur unique la clé secondaire de l’entité de l’article de la base de connaissances. Généralement, ce champ est l’ID du côté du fournisseur de contenu.	Oui	Chaîne indiquant le nom du champ. Vous pouvez définir la valeur sur « msydn_externalreferenceid »
ContentTargetFieldName	La valeur de champ ne doit pas être changée.	Oui	Définissez la valeur sur « contenu ».
ApiPathLeafName	La valeur de champ ne doit pas être changée.	Oui	Définissez la valeur sur « knowledgearticles ».
List<FieldDefinitions>	Est une liste des définitions de champ.	Oui	Ensemble de définitions pour les champs. Consultez le tableau suivant pour la liste des champs pris en charge pour la définition des définitions de champ.

Définitions des champs

Le tableau suivant répertorie les attributs obligatoires et facultatifs que vous pouvez utiliser dans votre schéma de mappage de métadonnées.

Nom du champ	Définition	Requise	active
TargetFieldName	Est le nom du champ logique de l’attribut cible dans l’entité de l’article de la base de connaissances.	Oui	Toute chaîne indiquant le nom du champ cible
TargetFieldType	Indique le type de champ cible.	Oui	Chaîne indiquant le type de champ.
DocFieldSource	Indique comment la valeur du champ source sera identifiée et résolue au moment de l’exécution	Oui	Définissez la valeur sur un des types source suivants : Regex Méta Constante Url Document Pour en savoir plus sur ces types de données, reportez-vous à la section Types de source de champ suivante.
DocFieldPattern	Indique la nature du champ cible à récupérer.	Non	Définissez cette valeur en fonction de la valeur DocFieldSource. Voir les exemples ci-dessous sur la façon de définir DocFieldPatterns.
MaxLength	Est la longueur maximale de la chaîne qui peut être stockée dans le champ cible.	Non Peut être utilisé lorsque l’attribut TargetFieldType est de type Chaîne	Int
UseRegexCapture	Stocke le modèle regex qui peut être appliqué à l’URL.	Non Peut être utilisé lorsque l’attribut TargetFieldType est de type Chaîne et l’attribut DocFieldSource est de type Url.	URL ou chaîne.

Types de source de champ

Les données des moteurs de recherche externes peuvent être définies sur l’un des types de source de champ suivants :

Regex : utilisé pour indiquer un type de données d’expression régulière.
Méta : utilisé pour indiquer que la valeur du champ cible est obtenue à partir d’une balise <méta> dans l’article source
Constant : utilisé pour définir une valeur statique pour le champ cible.
URL : utilisé pour indiquer l’URL du document source externe.
Document : utilisé pour indiquer le contenu HTML de l’article.

Considérations pour créer votre propre modèle de mappage de métadonnées

Lorsque vous développez votre propre schéma de mappage, vous devez vous assurer de configurer quelques champs obligatoires et de définir des valeurs par défaut pour certaines définitions de champ.

Votre modèle de mappage doit inclure :

Les champs UniqueTargetFieldName, ContentTargetFieldName et ApiPathLeafName. Ces champs doivent être définis sur leurs valeurs requises comme suit :
- Définissez UniqueTargetFieldName sur le champ msdyn_externalreferenceid prêt à l’emploi ou sur un champ personnalisé. Si vous utilisez un champ personnalisé, assurez-vous d’ajouter le champ en tant que clé secondaire. Plus d’informations : Définir des clés secondaires pour référencer les enregistrements Dynamics 365.
- Incluez le champ ContentTargetFieldName et définissez sa valeur sur « content ».
- Incluez le champ ApiPathLeafName et définissez sa valeur sur « knowledgearticles ».
- Assurez-vous de fournir des mappages pour les champs UniqueTargetField et ContentTargetField dans la liste FieldDefinitions.
Votre schéma de mappage ressemblerait à :
```
  {
    "Name": "{To be filled by you}",
    "UniqueTargetFieldName": "msdyn_externalreferenceid",
    "ContentTargetFieldName": "content",
    "ApiPathLeafName": "knowledgearticles"
    "FieldDefinitions": []
  }
```

Vous devez inclure la liste FieldDefinitions ci-dessous et remplir ses attributs tels que FieldUse, DocFieldSource, TargetFieldName et TargetFieldType avec les valeurs par défaut. Assurez-vous d’inclure les champs et attributs suivants avec leurs valeurs, « tels quels », dans votre modèle. Cependant, les champs Docfieldsource et Docfieldpattern pour la valeur de titre et de contenu peuvent être définis par vous sur Regex, Meta, Document, Constante ou Url.


  {
    "FieldUse": "Create",
    "DocFieldSource": "ArticlePublicNumber",
    "TargetFieldName": "articlepublicnumber",
    "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "Constant",
     "DocFieldPattern": "true",
     "TargetFieldName": "msdyn_isingestedarticle",
     "TargetFieldType": "Boolean"
  },
  {
     "DocFieldSource": "Url",
     "TargetFieldName": "msdyn_ingestedarticleurl",
     "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "DataProvider",
     "TargetFieldName": "msdyn_integratedsearchproviderid@odata.bind",
     "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "Regex",
     "DocFieldPattern": "<title>(.*?)</title>",
     "TargetFieldName": "title",
     "TargetFieldType": "String"
  },
  {
     "DocFieldSource": "Url",
     "TargetFieldName": "msdyn_externalreferenceid",
     "TargetFieldType": "String",
     "UseRegexCapture": "^https://.*?/(.*?)/.*/.*?([0-9A-F]{8}[-](?:[0-9A-F]{4}[-]){3}[0-9A-F]{12})$"
 }, 
  {
     "DocFieldSource": "Document",
     "TargetFieldName": "content",
     "TargetFieldType": "String"
  }

Après avoir répertorié les champs obligatoires et les informations d’attribut, vous pouvez inclure des mappages de métadonnées supplémentaires et définir vos propres valeurs personnalisées pour ceux-ci. Par exemple, vous pouvez inclure un type Méta DocFieldSource et définir des valeurs personnalisées pour l’attribut, comme suit.
```
   {
     "DocFieldSource": "Meta",
     "DocFieldPattern": "description",
     "TargetFieldName": "description",
     "TargetFieldType": "String",
     "MaxLength": 155
    }
```

Exemple de modèle de mappage de métadonnées

Vous pouvez utiliser l’exemple JSON de mappage de métadonnées suivant comme modèle pour créer votre propre modèle de mappage personnalisé.


   {
     "Name": "Integrated Search Data Provider Name",
     "UniqueTargetFieldName": "msdyn_externalreferenceid",
     "ContentTargetFieldName": "content",
     "ApiPathLeafName": "knowledgearticles",
     "FieldDefinitions": [
     {
       "FieldUse": "Create",
       "DocFieldSource": "ArticlePublicNumber",
       "TargetFieldName": "articlepublicnumber",
       "TargetFieldType": "String"
      },
      {
        "DocFieldSource": "Constant",
        "DocFieldPattern": "true",
        "TargetFieldName": "msdyn_isingestedarticle",
        "TargetFieldType": "Boolean"
      },
      {
        "DocFieldSource": "Url",
        "TargetFieldName": "msdyn_ingestedarticleurl",
        "TargetFieldType": "String"  
      },
      {
        "DocFieldSource": "DataProvider",
        "TargetFieldName": "msdyn_integratedsearchproviderid@odata.bind",
        "TargetFieldType": "String"
      },
      {
        "DocFieldSource": "Regex",
        "DocFieldPattern": "<title>(.*?)</title>",
        "TargetFieldName": "title",
        "TargetFieldType": "String"
       },
       {
          "DocFieldSource": "Meta",
          "DocFieldPattern": "description",
          "TargetFieldName": "description",
          "TargetFieldType": "String",
          "MaxLength": 155
       },
       {
          "DocFieldSource": "Document",
          "TargetFieldName": "content",
          "TargetFieldType": "String"
        },
        {
          "DocFieldSource": "Url",
          "TargetFieldName": "msdyn_externalreferenceid",
          "TargetFieldType": "String",
          "UseRegexCapture": "^https://.*?/(.*?)/.*/.*?([0-9A-F]{8}[-](?:[0-9A-F]{4}[-]){3}[0-9A-F]{12})$"
        }
    ]
 }

Transformer, mapper des données de sources externes sur des champs de connaissances

Lorsque vous mappez des informations provenant de fournisseurs de données externes à des entités d’articles de la base de connaissances, si la valeur source est d’un type de données différent, vous devez transformer la valeur avant de pouvoir la mapper au champ de connaissances cible. Plus d’informations : Transformez et associez les données de source externe à l’attribut de connaissances cible correspondant

Voir aussi

Gérer les fournisseurs de recherche intégrés
Afficher et utiliser les informations des fournisseurs de recherche

Partager via