Détails du schéma pour générer un modèle de mappage de métadonnées

2025-05-22

S’applique à : Dynamics 365 Contact Center – autonome et Dynamics 365 Customer Service uniquement

Cet article décrit les détails du schéma requis pour mapper les informations des fournisseurs de données externes aux entités de l’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.

Domaines

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

Nom du champ	Définition	Obligatoire	Valeur
Nom	Nom de la définition de champ	Non	Chaîne indiquant le nom du champ.
UniqueTargetFieldName	Identificateur unique ou autre clé de l’entité de l’article de la base de connaissances. En règle générale, 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 du champ ne doit pas être modifiée.	Oui	Définissez la valeur sur « contenu ».
ApiPathLeafName	La valeur du champ ne doit pas être modifiée.	Oui	Réglez la valeur sur « knowledgearticles ».
List<FieldDefinitions>	Est une liste de définitions de champs.	Oui	Un ensemble de définitions pour les champs. Consultez le tableau suivant pour obtenir la liste des champs pris en charge pour la définition des champs.

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	Obligatoire	Valeur
TargetFieldName	Nom de 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 du champ cible.	Oui	Chaîne indiquant le type du champ.
DocFieldSource	Indique comment la valeur du champ source est identifiée et résolue au moment de l’exécution	Oui	Définissez la valeur sur l’un des types de source suivants : Regex Meta Constante URL Document Pour en savoir plus sur ces types de données, reportez-vous à la section Types de sources de champs suivante.
DocFieldPattern	Indique la nature du champ cible à récupérer.	Non	Définissez cette valeur en fonction de la valeur DocFieldSource. Consultez les exemples ci-dessous pour savoir comment définir DocFieldPatterns.
LongueurMaximale	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 String	Entier
UtiliserRegexCapture	Stocke le modèle regex qui peut être appliqué à l’URL.	Non. Peut être utilisé lorsque l’attribut TargetFieldType est de type String et que 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 : Permet d’indiquer un type d’expression régulière de données.
Méta : Indique que la valeur du champ cible est obtenue à partir d’une <balise méta> dans l’article source.
Constante : permet de définir une valeur statique pour le champ cible.
Url : Permet d’indiquer l’URL du document source externe.
Document : Permet d’indiquer le contenu HTML de l’article.

Considérations relatives à la création de 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 obligatoires 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. Pour plus d’informations : Définir d’autres clés 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 se présente comme suit :
```
  {
    "Name": "{To be filled by you}",
    "UniqueTargetFieldName": "msdyn_externalreferenceid",
    "ContentTargetFieldName": "content",
    "ApiPathLeafName": "knowledgearticles"
    "FieldDefinitions": []
  }
```

Vous devez inclure la liste FieldDefinitions ci-dessous et renseigner ses attributs tels que FieldUse, DocFieldSource, TargetFieldName et TargetFieldType avec les valeurs par défaut. Veillez à inclure les champs et attributs suivants avec leurs valeurs, «as-is», dans votre modèle. Toutefois, vous pouvez définir les champs Docfieldsource et Docfieldpattern pour les champs de valeur de titre et de contenu sur Regex, Meta, Document, Constant 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"
  }

Une fois que vous avez 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 Meta de 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})$"
        }
    ]
 }

Transformez et mappez des données sources externes à des champs de connaissances

Lorsque vous mappez des informations provenant de fournisseurs de données externes à des entités d’article 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. Pour plus d’informations : Transformer et mapper des données sources externes à l’attribut de connaissances cible correspondant

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

Partager via