Konfigurera schemamappning för kunskapsbasartikel

  • Artikel

Obs

Du kan se tillgänglighetsinformationen för funktionen enligt följande.

Dynamics 365 Contact Center – inbäddad Dynamics 365 Contact Center – fristående Dynamics 365 Customer Service
Nej. Ja Ja

Som en del av lägga till en integrerad sökleverantör i kundtjänst måste du berätta för tjänsten hur de kunskapsbasartiklar den tar emot från leverantören. Det gör du genom att välja och konfigurera ett schema för en kunskapsbasartikel. Det går inte att ändra schema efter att du har sparat konfigurationen.

Om du har använt ett språkfilter i avsnittet Autentisering och testning måste du underhålla mappningen för språklokalen antingen i avsnittet JSON-schema eller i avsnittet Schemamappning för kunskapsbasartikel. Mer information om värden för språkversion finns i: Språk (LanguageLocale) tabell/entitetsreferens.

Välj ett alternativ i avsnittet Schema för kunskapsbasartikeln:

Fältmappning

Välj och ladda upp filen för val av metadata och välj sedan de metataggar du vill använda i mappningen. Med fältmappning mappar du en kunskapsbasartikel som tagits emot från sökleverantören (källegenskapen) till ett attribut i entiteten för kunskapsbasartikel (målet), baserat på en åtgärdstyp.

Välj och ladda upp filen för val av metadata

  1. Spara artikeln lokalt som en fil för webbsida, endast HTML-fil. Kontrollera att filnamnet är mindre än 99 tecken.

  2. I webbplatsöversikten administrationscenter för Customer Service eller administrationscenter för Contact Center, avsnittet Schema för kunskapsartikel>Fältmappning laddar du upp filen genom att markera Välj filen.

    Alla metataggar som finns i HTML-filen visas i avsnittet Inställningar för metataggar.

  3. Välj antingen Markera alla metataggar nedanför eller välj bara de metataggar du vill mappa.

    De metataggar du väljer här blir attribut som du kan välja som källegenskaper i avsnittet Mappning. Om du inte väljer något är endast standardkällegenskaperna HTML-rubrik och HTML-brödtext tillgängliga för mappning.

  4. För att gå till avsnittet Mappning väljer du Nästa. Om du vill avsluta och gå tillbaka till detta senare väljer du Spara som utkast.

Mappa artikelattribut

Använd en åtgärdstyp för att mappa källegenskapen till målet.

  • Artikelattribut: Målfältvärdena för kunskapsbasartikeln.
  • Åtgärdstyper: Mappningsmönster som mappar källartikeln till artikelattributen för entiteten för kunskapsbasartikeln. Läs mer om mappningsalternativ för åtgärdstyp.
  • Källegenskap: Värdet som du definierar för varje åtgärdstyp. Om du till exempel väljer åtgärdstypen Direkt måste du välja bland de tidigare markerade metataggarna, eller eller taggen HTML-Title.

  1. I webbplatsöversikten administrationscenter för Customer Service eller administrationscenter för Contact Center, avsnittet Mappning de obligatoriska kunskapsartikelattributen är Innehåll, Externt referens-ID och Titel. För varje väljer du Åtgärdstyp och en Källegenskap.

    Kontrollera att värdet Externt referens-ID är unikt.

  2. Om du vill lägga tilll fler artikelattribut väljer du Lägg till rad och sedan Artikelattribut, Åtgärdstyp och Källegenskap.

    Du kan också välja Ta bort om du vill ta bort ett artikelattribut om det behövs.

  3. Markera Validera mappning.

    Tjänsten använder de värden du har angett för att fastställa attributvärdena för den HTML-fil du överfört. Posterna i mappningstabellen och Regex-mönstren verifieras. Det finns inga valideringar för RegexUrl.

    Om valideringen lyckas visas ett bekräftelsemeddelande. Om valideringen misslyckas visas ett felmeddelande. Beroende på felmeddelandet kontrollerar du antingen posterna i mappningstabellen eller de regex-mönster du angav.

  4. Gå vidare till nästa steg genom att välja avsnittet Nästa. Om du vill avsluta och gå tillbaka till detta senare väljer du Spara som utkast.

Mappningsalternativ för åtgärdstyp

Välj bland följande mappningsalternativ för åtgärdstyp:

  • Regex: Använder regex-mönster för att extrahera värden från källwebbplatsen. Källegenskapen är ett textfält där du kan ange regex-mönster. Strängen från webbplatsens HTML-kod som matchar det här mönster är mappad till motsvarande kunskapsbasartikelfält.

    Regex-mönstren måste ha en registreringsgrupp som omges av parenteser och som gör att du kan extrahera en viss del av den matchande texten. Texten extraheras från den första gruppen av den första matchningen.

    Här är några exempel på regex-mönster för att extrahera innehåll från en viss div-tagg:

    • Baserat på div-taggen ID: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Baserat på div-taggen klass: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
    • För innehåll i brödtexttaggen: <body[^>]*>([\s\S]*)<\/body>
    • För innehåll i rubriktaggen: <head[^>]*>([\s\S]*)<\/head>

  • Direkt: Mappar värdet för en metatagg från källwebbplatsen direkt till ett kunskapsbasartikelfält. I listan Källegenskap visas alla metataggar som har extraherats från exempelwebbplatsen tillsammans med källegenskaperna HTML-rubrik och HTML-brödtext, som är tillgängliga som standard.

    Om du väljer Direkt som åtgärdstyp och og: url som källegenskap mappas värdet för og: url-metataggen från källegenskapen till motsvarande kunskapsbasartikelattribut.

  • Konstant: Ange ett konstant värde för ett värde i ett kunskapsbasartikelfält. Källegenskapen är ett textfält där du kan ange konstant värde.

  • RegexUrl: Som Regex, men söker endast efter matchningar i URL-adressen för källwebbplatsen. Om du vill mappa hela källwebbplats-URL:en till ett kunskapsattributfält väljer du Regexurl i åtgärdstyp och använder (. *) mönster i källegenskapen.

Här är ett exempel som förklarar hur man mappar artikelattributen.

Exempel

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

Använd följande åtgärdstyper för att mappa källegenskapen till målet i html-exemelfilen:

Skärmbild förklarar mappningen från den valda html-filen.

där,

  • Artikelattribut: Innehåll
  • Åtgärdstyp: Regex
  • Källegendom: <body[^>]>([\s\S])</body>

Exempel på regex extraherar hela innehållet inuti brödtexttaggen i HTML-filen.

  • Artikelattribut: Externt referens-ID
  • Åtgärdstyp: RegexUrl
  • Källegenskap: ^https://.?/id/(.?)/.*$

RegexUrl extraherar id – 2911cacd-efa5-4593-ae22-e09ae14c6698 från HTML-filen.

  • Artikelattribut: Titel
  • Åtgärdstyp: Direkt
  • Källegenskap: HTML-titel

Direkt extraherar innehållet i fältet Titel HTML-filens fält, till exempel WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

  • Artikelattribut: Beskrivning
  • Åtgärdstyp: Regex
  • Källegendom: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

Exempel på regex extraherar innehåll från en specifik div-tagg baserat på ID. Här, ms-desciptionArtikel är id för div-taggen i html.

  • Artikelattribut: Nyckelord
  • Åtgärdstyp: Direkt
  • Källegenskap: ms.keywords

Direct extraherar innehållet inom fältet ms.keywords i HTML-filen, till exempel XML-läsare, WS-Trust.

JSON-schema

Läs mer om schemainformation för att skapa en mappningsmall för metadata.

  1. I webbplatsöversikten administrationscenter för Customer Service eller administrationscenter för Contact Center, avsnittet Schema för kunskapsartikel>JSON-schema kopiera och klistra in dina artikelegenskaper och schemat JSON i fältet som du får.

  2. Välj validera JSON.

    Om valideringen lyckas visas ett bekräftelsemeddelande. Om valideringen misslyckas visas ett felmeddelande som identifierar parametern som har ett felaktigt värde.

  3. Gå vidare till nästa steg genom att välja avsnittet Nästa. Om du vill avsluta och gå tillbaka till detta senare väljer du Spara som utkast.

Gå vidare

Hantera integrerade sökleverantörer