Configurarea mapării schemei articolelor din baza de cunoștințe

Ca parte a adăugării unui furnizor de căutare integrat în serviciu pentru relații cu clienții, trebuie să spuneți serviciului cum să ingereze articolele de cunoștințe pe care le primește de la furnizor . Faceți acest lucru selectând și configurând o schemă de articol din baza de cunoștințe. Nu puteți modifica schema după ce salvați configurația.

Dacă ați aplicat un filtru de limbă în secțiunea Autentificare și testare , trebuie să mențineți maparea pentru setările regionale de limbă fie în schema JSON, fie în secțiunea de mapare a schemei articolului din baza de cunoștințe. Pentru mai multe informații despre valorile setărilor regionale de limbă, accesați: Referință tabel/entitate Language (LanguageLocale).

Selectați o opțiune din secțiunea Schema articolului din baza de cunoștințe:

• Cartografierea câmpului
• Schema JSON

Mapare câmpuri

Selectați și încărcați fișierul pentru selectarea metadatelor, apoi selectați metaetichetele pe care doriți să le utilizați în mapare. Cu maparea câmpurilor, mapați un articol din baza de cunoștințe primit de la furnizorul de căutare (proprietatea sursă) la un atribut al entității articolului din baza de cunoștințe (ținta), pe baza unui tip de operațiune.

Selectați și încărcați fișierul pentru selectarea metadatelor

1. Salvați articolul local ca pagină web, fișier numai HTML. Asigurați-vă că numele fișierului are mai puțin de 99 de caractere.

2. În harta site-ului centrului de administrare serviciu pentru relații cu clienții,Schema articolului din baza de cunoștințe Maparea câmpurilor, încărcați fișierul selectând Alegeți>fișierul .

   Toate metaetichetele găsite în fișierul HTML sunt listate în secțiunea Setări metaetichete.

3. Selectați toate metaetichetele de mai jos sau selectați numai metaetichetele pe care trebuie să le mapați.

   Metaetichetele pe care le selectați aici devin atribute pe care le puteți selecta ca proprietăți sursă în secțiunea Mapare . Dacă nu selectați niciuna, numai proprietățile implicite sursă HTML-Title și HTML-Body sunt disponibile pentru mapare.

4. Pentru a accesa secțiunea Mapare , selectați Următorul. Dacă doriți să vă opriți și să reveniți la acest punct mai târziu, selectați Salvare ca schiță.

Mapați atributele articolelor

Utilizați un tip de operațiune pentru a mapa proprietatea sursă la țintă.

• Atribute articol: Valorile câmpului țintă pentru articolul din baza de cunoștințe.
• Tipuri de operațiuni: Modelele de mapare care mapează articolul sursă la atributele articolului din baza de cunoștințe ale entității articol din baza de cunoștințe. Aflați mai multe despre opțiunile de mapare a tipului de operațiune.
• Proprietatea sursă: Valoarea pe care o definiți pentru fiecare tip de operațiune. De exemplu, dacă selectați tipul de operațiune Directă , trebuie să selectați dintre metaetichetele selectate anterior sau tagul HTML-Title .

1. În harta site-ului centrului de administrare serviciu pentru relații cu clienții, secțiunea Mapare , atributele obligatorii ale articolului din baza de cunoștințe sunt Conținut , ID referință externă și Titlu. Pentru fiecare, selectați un tip de operațiune și oproprietate sursă.

   Asigurați-vă că valoarea ID referință externă este unică.

2. Pentru a adăuga mai multe atribute de articol, selectați Adăugare rând , apoi selectațiun atribut articol, un tip de operațiune șio proprietate sursă.

   De asemenea, puteți selecta Ștergere pentru a șterge un atribut de articol, dacă este necesar.

3. Selectați Validare mapare.

   Serviciul utilizează valorile pe care le-ați introdus pentru a determina valorile atributelor în fișierul HTML pe care l-ați încărcat. Validează intrările din tabelul de mapare și modelele Regex. Nu există validări pentru RegexUrl.

   Dacă validarea reușește, veți vedea un mesaj de confirmare. Dacă validarea nu reușește, vedeți un mesaj de eroare. În funcție de mesajul de eroare, verificați fie intrările din tabelul de mapare, fie modelele regex pe care le-ați introdus.

4. Selectați Următorul pentru a merge la secțiunea următoare. Dacă doriți să vă opriți și să reveniți la acest punct mai târziu, selectați Salvare ca schiță.

Opțiuni de mapare a tipului de operațiune

Selectați dintre următoarele opțiuni de mapare a tipului de operațiune:

• Regex: Utilizează modele regex pentru a extrage valori de pe site-ul web sursă. Proprietatea sursă este un câmp de text în care puteți introduce modelul regex. Șirul din codul HTML al site-ului web care se potrivește cu acest model este mapat la câmpul corespunzător articolului din baza de cunoștințe.

  Modelele regex trebuie să aibă un grup de captură inclus între paranteze, care vă permite să extrageți o anumită porțiune a textului potrivit. Textul este extras din prima grupă negoală a primului meci.

  Iată câteva exemple de modele regex pentru a extrage conținut dintr-o anumită etichetă div:

  • Pe baza ID-ului etichetei div: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Pe baza clasei div tag: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
  • Pentru conținutul din interiorul etichetei corpului: <body[^>]*>([\s\S]*)<\/body>
  • Pentru conținutul din interiorul etichetei cap: <head[^>]*>([\s\S]*)<\/head>

• Direct: mapează valoarea oricărei metaetichete de pe site-ul sursă direct la orice câmp de articol din baza de cunoștințe. Lista Proprietate sursă afișează toate metaetichetele extrase din site-ul web eșantion, împreună cu proprietățile sursă HTML-Title și HTML-Body, care sunt disponibile în mod implicit.

  Dacă selectați Direct ca tip de operațiune și og: url ca proprietate sursă, atunci valoarea metaetichetei og: urldin proprietatea sursă este mapată la atributul corespunzător articolului din baza de cunoștințe.

• Constantă: Introduceți o valoare constantă în orice câmp de articol din baza de cunoștințe. Proprietatea sursă este un câmp text în care puteți introduce valoarea constantă.

• RegexUrl: Ca Regex, dar caută potriviri numai în adresa URL a site-ului sursă. Pentru a mapa întreaga adresă URL a site-ului web sursă la un câmp de atribut de cunoștințe, selectați Regexurl în tipul de operațiune și utilizați modelul (. *) în proprietatea sursă.

Iată un exemplu care explică modul de mapare a atributelor articolului.

Exemplu

Exemplu 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>

Utilizați următoarele tipuri de operațiuni pentru a mapa proprietatea sursă la țintă în fișierul html eșantion:

unde

• atribut articol: conținut
• Tip de operare: Regex
• Proprietate sursă: <corp[^>]([\s\S]>)</body>

Eșantionul regex extrage întregul conținut din interiorul etichetei corpului fișierului HTML.

• Atribut articol: ID ref extern
• Tip de operațiune: RegexUrl
• Proprietatea sursă: ^https://.? /id/(.?) /.*$

RegexUrl extrage id-ul din 2911cacd-efa5-4593-ae22-e09ae14c6698 fișierul HTML.

• atribut articol: titlu
• Tip de operare: Direct
• Proprietate sursă: HTML-Title

Extrage direct conținutul din câmpul Titlu al fișierului HTML, de exemplu,Metoda WSTrustRequestSerializer.CanRead (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

• atribut articol: descriere
• Tip de operare: Regex
• Proprietate sursă:div\b[^]id="ms-descriptionArticle"[^ <>]([\s\S]>*?)></Div>

Exemplu regex extrage conținut dintr-o etichetă div specifică bazată pe ID. Aici, ms-desciptionArticle este id-ul tag-ului div în html.

• Atribut articol: Cuvinte cheie
• Tip de operare: Direct
• Sursa Proprietate: ms.keywords

Direct extrage conținutul din câmpul ms.keywords al fișierului HTML, de exemplu XML Reader, WS-Trust.

Schema JSON

Aflați mai multe despre detaliile schemei pentru a crea un șablon de mapare a metadatelor.

1. În harta site-ului centrului de administrare serviciu pentru relații cu clienții, secțiunea Schema articolului din baza de cunoștințe JSON Schema>, copiați și lipiți proprietățile articolului și schema JSON în câmpul furnizat.

2. Selectați Validare JSON.

   Dacă validarea reușește, veți vedea un mesaj de confirmare. Dacă validarea nu reușește, vedeți un mesaj de eroare care identifică parametrul care are o valoare incorectă.

3. Selectați Următorul pentru a merge la secțiunea următoare. Dacă doriți să vă opriți și să reveniți la acest punct mai târziu, selectați Salvare ca schiță.

Pașii următori

Gestionați furnizorii de căutare integrată