Configurer le mappage du schéma des articles de la base de connaissances

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

Dans le cadre de l’ajout d’un fournisseur de recherche intégré dans Customer Service, vous devez indiquer au service comment ingérer les articles de la base de connaissances qu’il reçoit du fournisseur. Pour ce faire, sélectionnez et configurez un schéma d’article de la base de connaissances. Vous ne pouvez pas modifier le schéma après avoir enregistré la configuration.

Si vous avez appliqué un filtre de langue dans la section Authentification et test, vous devez maintenir le mappage des paramètres régionaux de langue dans le Schéma JSON ou dans la section Mappage du schéma des articles de la base de connaissances. Pour plus d’informations sur les valeurs des paramètres régionaux de langue, accédez à : Référence table/entité langue (LanguageLocale).

Sélectionnez une option dans la section Schéma de l’article de la base de connaissances :

• Mappage de champs
• Schéma JSON

Mappages de champs

Sélectionnez et chargez le fichier pour la sélection des métadonnées, puis sélectionnez les balises méta que vous souhaitez utiliser dans le mappage. Avec le mappage de champs, vous mappez un article de la base de connaissances reçu du fournisseur de recherche (la propriété source) à un attribut de l’entité Article de la base de connaissances (la cible), en fonction d’un type d’opération.

Sélectionner et charger le fichier pour la sélection des métadonnées

1. Enregistrez l’article localement en tant que fichier Page Web, HTML uniquement . Assurez-vous que le nom du fichier comporte moins de 99 caractères.

2. Dans le plan du site du centre d’administration Customer Service ou du centre d’administration du centre de contacts, Schéma de l’article connaissance>Mappage de champs section, téléchargez le fichier en sélectionnant Choisissez le fichier.

   Toutes les métabalises trouvées dans votre fichier HTML sont répertoriées dans la section Paramètres des métabalises.

3. Sélectionnez Sélectionner toutes les métabalises ci-dessous ou sélectionnez uniquement les métabalises que vous devez mapper.

   Les métabalises que vous sélectionnez ici deviennent des attributs que vous pouvez sélectionner comme propriétés sources dans la section Mappage. Si vous n’en sélectionnez aucune, seules les propriétés sources par défaut HTML-Title et HTML-Body sont disponibles pour le mappage.

4. Pour accéder à la section Mappage, sélectionnez Suivant. Si vous souhaitez vous arrêter et revenir à ce point ultérieurement, sélectionnez Enregistrer comme brouillon.

Mapper les attributs d’article

Utilisez un type d’opération pour mapper la propriété source à la cible.

• Attributs d’article : les valeurs du champ cible de l’article de la Base de connaissances.
• Types d’opération : les modèles de mappage qui mappent l’article source aux attributs d’article de l’entité d’article de la Base de connaissances. En savoir plus sur les options de mappage de type d’opération.
• Propriété source : la valeur que vous définissez pour chaque type d’opération. Par exemple, si vous sélectionnez le type d’opération Direct, vous devez sélectionner parmi les balises méta précédemment sélectionnées, ou la balise HTML-Title.

1. Dans le plan du site du centre d’administration Customer Service ou du centre d’administration du centre de contacts, mappage section, les attributs obligatoires de l’article de connaissances sont Contenu, ID de référence externe, et Titre. Pour chacun, sélectionnez un Type d’opération et une Propriété source.

   Assurez-vous que la valeur ID de référence externe est unique.

2. Pour ajouter d’autres attributs d’article, sélectionnez Ajouter une ligne, puis sélectionnez un Attribut d’article, un Type d’opération et une Propriété source.

   Vous pouvez également sélectionner Supprimer pour supprimer un attribut d’article, si nécessaire.

3. Sélectionnez Valider le mappage.

   Le service utilise les valeurs saisies pour déterminer les valeurs des attributs par rapport au fichier HTML que vous avez chargé. Il valide les entrées dans la table de mappage et les modèles Regex. Il n’y a aucune validation pour RegexUrl.

   Si la validation réussit, un message de confirmation s’affiche. Si la validation échoue, un message d’erreur s’affiche. En fonction du message d’erreur, vérifiez les entrées dans la table de mappage ou les modèles regex que vous avez saisis.

4. Sélectionnez Suivant pour passer à la section suivante. Si vous souhaitez vous arrêter et revenir à ce point ultérieurement, sélectionnez Enregistrer comme brouillon.

Options de mappage de type Opération

Sélectionnez parmi les options de mappage de type d’opération suivantes :

• Regex : utilise des modèles regex pour extraire des valeurs du site Web source. La propriété source est un champ de texte où vous pouvez saisir le modèle regex. La chaîne du HTML de votre site Web qui correspond à ce modèle est mappée au champ d’article de la base de connaissances correspondant.

  Les modèles Regex doivent avoir un groupe de capture entre parenthèses qui vous permet d’extraire une partie spécifique du texte correspondant. Le texte est extrait du premier groupe non vide de la première correspondance.

  Voici quelques exemples de modèles Regex pour extraire le contenu d’une balise div spécifique :

  • En fonction de l’ID de la balise div : <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Selon la classe de la balise div : <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Pour le contenu à l’intérieur de la balise du corps : <body[^>]*>([\s\S]*)<\/body>
  • Pour le contenu à l’intérieur de la balise de l’en-tête : <head[^>]*>([\s\S]*)<\/head>

• Direct : mappe directement la valeur d’une balise méta de son site Web source directement à un champ d’article de la base de connaissances. La liste Propriété source affiche toutes les métabalises extraites de l’exemple de site Web, ainsi que les propriétés sources HTML-Title et HTML-Body, qui sont disponibles par défaut.

  Si vous sélectionnez Direct comme type d’opération et og : url comme propriété source, alors la valeur de la balise méta og : url de la propriété source est mappée à l’attribut d’article de la base de connaissances correspondant.

• Constant : saisissez une valeur constante dans un champ d’article de la base de connaissances. La propriété source est un champ de texte où vous pouvez saisir la valeur constante.

• RegexUrl : comme Regex, mais recherche des correspondances dans l’URL du site Web source uniquement. Pour mapper toute l’URL du site Web source à un champ d’attribut de connaissances, sélectionnez Regexurl comme type d’opération et utilisez le modèle (. *) dans la propriété source.

Voici un exemple qui explique comment mapper les attributs d’article.

Exemple

Exemple de fichier HTML :

<html>
<head>
	<meta charset="utf-8" />
	<meta name="viewport" content="width=device-width, initial-scale=1.0" />
	<meta property="og:type" content="website" />
	<meta property="og:url" content="https://contoso.com/en-us/id/2911cacd-efa5-4593-ae22-e09ae14c6698/ee734739(v=msdn.10)" />
	<meta name="ms.keywords" content="XML Reader, WS-Trust" />
</head>	
<title>WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn</title>
<body lang="en-us" dir="ltr">
	<div id="ms-descriptionArticle">
	 Checks if an XML reader is positioned at a WS-Trust RequestSecurityToken element. This is crucial for handling security token requests in .NET applications using Windows Identity Foundation (WIF).
	</div>
	<div id="ms--content-well-notifications" data-bi-name="content-well-notification">
	</div>
	<p>Starting with the .NET Framework 4.5, Windows Identity Foundation (WIF) has been fully integrated into the .NET Framework. The version of WIF addressed by this topic, WIF 3.5, is deprecated and should only be used when developing against the .NET Framework 3.5 SP1 or the .NET Framework 4. For more information about WIF in the .NET Framework 4.5, also known as WIF 4.5</p>
	<p>When implemented in a derived class, checks if the specified XML reader is positioned at a WS-Trust RequestSecurityToken element.</p>
	<p><strong>Namespace:</strong> Microsoft.IdentityModel.Protocols.WSTrust<br/>
	<strong>Assembly:</strong> Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)</p>
	<h2 id="usage">Usage</h2>
	<pre><code class="lang-vb">'Usage
	Dim instance As WSTrustRequestSerializer
	Dim reader As XmlReader
	Dim returnValue As Boolean

	returnValue = instance.CanRead(reader)
	</code></pre>
	<h4 id="parameters">Parameters</h4>
	<ul>
	<li><strong>reader</strong><br/>
	The XmlReader object from which to read.</li>
	</ul>
	<h4 id="return-value">Return Value</h4>
	<p><strong>true</strong> if the reader is positioned at an RST element that the serializer can read; otherwise, <strong>false</strong>.</p>
</body>
</html>

Utilisez les types d’opérations suivants pour mapper la propriété source à la cible dans l’exemple de fichier HTML :

où,

• Attribut d’article : Contenu
• Type d’opération : Regex
• Propriété source : <body[^>]>([\s\S])</body>

Exemple de regex : extrait tout le contenu dans la balise body du fichier HTML.

• Attribut d’article : ID de référence externe
• Type d’opération : RegexUrl
• Propriété source : ^https://.?/id/(.?)/.*$

RegexUrl : extrait l’ID 2911cacd-efa5-4593-ae22-e09ae14c6698 du fichier HTML.

• Attribut d’article : Titre
• Type d’opération : Direct
• Propriété source : HTML-Title

Direct : extrait le contenu dans le champ Titre du fichier HTML, par exemple Méthode WSTrustRequestSerializer.CanRead (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

• Attribut d’article : Description
• Type d’opération : Regex
• Propriété source : <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

Exemple de regex : extrait le contenu d’une balise div spécifique en fonction de l’ID. Ici, ms-desciptionArticle est l’ID de la balise div dans le code HTML.

• Attribut d’article : Mots clés
• Type d’opération : Direct
• Propriété source : ms.keywords

Direct : extrait le contenu dans le champ ms.keywords du fichier HTML, par exemple XML Reader, WS-Trust.

Schéma JSON

En savoir plus sur les détails du schéma pour créer un modèle de mappage de métadonnées.

1. Dans le plan du site du centre d’administration Customer Service ou du centre d’administration du centre de contacts, Schéma de l’article de connaissances>Schéma JSON section, copiez et collez les propriétés de votre article et votre schéma JSON dans le champ qui vous est fourni.

2. Sélectionnez Valider JSON.

   Si la validation réussit, un message de confirmation s’affiche. Si la validation échoue, vous voyez un message d’erreur qui identifie le paramètre dont la valeur est incorrecte.

3. Sélectionnez Suivant pour passer à la section suivante. Si vous souhaitez vous arrêter et revenir à ce point ultérieurement, sélectionnez Enregistrer comme brouillon.

Étapes suivantes

Gérer les fournisseurs de recherche intégrés