Udostępnij za pośrednictwem

Konfigurowanie mapowania schematu artykułów merytorycznych

  • Artykuł

W ramach dodawania zintegrowanego dostawcy wyszukiwania w Customer Service, musisz powiedzieć usłudze, jak pozyskiwać artykuły wiedzy, które otrzymuje od dostawcy. W tym celu należy wybrać i skonfigurować schemat artykułów wiedzy. Po zapisaniu konfiguracji nie można zmienić schematu.

Jeśli zastosowano filtr języka w sekcji Uwierzytelnianie i testowanie, należy zachować mapowanie dla lokalizacji języka w sekcji Schematy JSON lub w sekcji Mapowanie schematu artykułu wiedzy. Aby uzyskać więcej informacji o wartościach ustawień regionalnych języka, przejdź do dokumentacji dotyczącej tabeli/encji Język (LanguageLocale).

Wybierz opcję w sekcji Schemat artykułów wiedzy:

Mapowanie pól

Wybierz i przekaż plik w celu wybrania metadanych, a następnie wybierz metatagi, których chcesz użyć w mapowaniu. Mapowanie pól umożliwia mapowanie artykułu wiedzy otrzymanego od dostawcy wyszukiwania (właściwość źródłowa) na atrybut encji artykułu wiedzy (cel), w oparciu o typ operacji.

Wybierz i przekaż plik w celu wybrania metadanych

  1. Zapisz artykuł w lokalizacji jako plik Strona sieciowa, tylko HTML. Upewnij się, że nazwa pliku ma mniej niż 99 znaków.

  2. W mapie witryny centrum administracyjnego Customer Service, w sekcji Schemat artykułu wiedzy>Mapowanie pól, prześlij plik, wybierając Wybierz plik.

    Wszystkie meta etykiety znajdujące się w pliku HTML są wymienione w sekcji Ustawienia meta tagów.

  3. Wybierz Wybierz wszystkie poniższe meta tagi lub wybierz tylko te, które chcesz zmapować.

    Wybrane tutaj etykiety stają się atrybutami, które można wybrać jako właściwości źródła w sekcji Mapowanie. Jeśli nie wybierzesz żadnego, tylko domyślne właściwości źródła HTML-Title i HTML-Body są dostępne do mapowania.

  4. Aby przejść do sekcji Mapowanie, wybierz opcję Dalej. Jeśli chcesz zatrzymać i wrócić do tego punktu później, wybierz opcję Zapisz jako roboczą.

Zamapuj atrybuty artykułów

Użyj typu operacji, aby zmapować właściwość źródłową na docelową.

  • Atrybuty artykułu: wartości docelowe pola artykułu merytorycznego.
  • Typy operacji: wzorce mapowania, które mapuje artykuł źródłowy na atrybuty artykułu w encji artykułu merytorycznego. Więcej informacji o opcjach mapowania typu operacji.
  • Właściwość źródło: wartość zdefiniowana dla poszczególnych typów operacji. Na przykład po wybraniu typu operacji Bezpośrednie należy wybrać jeden z wcześniej wybranych tagów meta tagów albo tag HTML-Title.

  1. Na mapie witryny Centrum administracyjnego rozwiązania Customer Service, w sekcji Mapowanie, obowiązkowymi atrybutami artykułów merytorycznych są Zawartość, Identyfikator odwołania zewnętrznego i Tytuł. Dla każdej z nich wybierz Typ operacji i Właściwość źródłową.

    Upewnij się, że wartość Zewnętrzny identyfikator referencyjny jest unikalna.

  2. Aby dodać więcej atrybutów artykułu, wybierz pozycję Dodaj wiersz, a następnie wybierz pozycję Atrybut artykułu, Typ operacji i Właściwość źródła.

    Można również wybrać opcję Usuń, aby w razie potrzeby usunąć atrybut artykułu.

  3. Wybierz pozycję Weryfikuj mapowanie.

    Usługa używa wprowadzonych wartości do określenia wartości atrybutów względem przesłanego pliku HTML. Dokonuje weryfikacji wpisów w tabeli mapowań i wzorców Regex. Walidacje nie dotyczą elementu RegexUrl.

    Jeśli weryfikacja się powiedzie, zostanie wyświetlony komunikat z potwierdzeniem. Jeśli weryfikacja nie powiedzie się, wyświetlony zostanie komunikat o błędzie. W zależności od komunikatu o błędzie należy sprawdzić wpisy w tabeli mapowań lub wprowadzone wzorce regex.

  4. Aby przejść do sekcji Mapowanie, wybierz opcję Dalej. Jeśli chcesz zatrzymać i wrócić do tego punktu później, wybierz opcję Zapisz jako roboczą.

Opcje mapowania typu operacji

Wybierz jedną z następujących opcji operacji Typ mapowania:

  • Regex: używa wzorców regex w celu wyodrębnienia wartości z źródłowej witryny sieci Web. Właściwość source to pole tekstowe, w którym można wprowadzić wzorzec regex. Ciąg znaków z kodu HTML witryny, który pasuje do tego wzorca, jest mapowany do odpowiedniego pola artykułu wiedzy.

    Wzorce wyrażeń regex muszą mieć grupę przechwytywania zamkniętą w nawiasach, co umożliwi wyodrębnienie określonej części dopasowanego tekstu. Tekst jest wyodrębniany z pierwszej niepustej grupy pierwszego dopasowania.

    Oto kilka przykładów wzorców wyrażeń regularnych w celu wyodrębnienia zawartości z określonego tagu div:

    • Na podstawie identyfikatora tagu ID: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Na podstawie klasy tagu div: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Aby uzyskać zawartość wewnątrz etykiety treści: <body[^>]*>([\s\S]*)<\/body>
    • Aby uzyskać zawartość wewnątrz etykiety nagłówka: <head[^>]*>([\s\S]*)<\/head>

  • Bezpośrednio: mapuje wartość każdego meta tagu z witryny źródłowej bezpośrednio na dowolne pole artykułu merytorycznego. Lista Właściwość źródłowa pokazuje wszystkie etykiety wyodrębnione z przykładowej strony internetowej wraz z właściwościami źródłowymi HTML-Title i HTML-Body, które są dostępne domyślnie.

    Jeśli wybierzesz Bezpośrednio jako typ operacji i og: url jako właściwość źródłową, wówczas wartość etykiety og: url z właściwości źródłowej zostanie zmapowana do odpowiedniego atrybutu artykułu wiedzy.

  • Stałe: wprowadź stałą wartość w dowolnym polu artykułu wiedzy. Właściwość source to pole tekstowe, w którym można wprowadzić wartość stałą.

  • RegexUrl: podobnie jak Regex, ale szuka dopasowań tylko w adresie URL strony źródłowej. Aby zmapować cały adres URL witryny źródłowej do pola atrybutu wiedzy, wybierz Regexurl w typie operacji i użyj wzorca (. *) we właściwości source.

Oto przykład wyjaśniający, jak mapować atrybuty artykułu.

Przykład

Przykład w 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>

Aby zmapować właściwość źródłową na docelową w przykładowym pliku HTML, użyj następujących typów operacji:

Zrzut ekranu wyjaśnia mapowanie dl wybranego pliku HTML.

gdzie,

  • Atrybut artykułu: Zawartość
  • Typ operacji: Wyrażenie regularne
  • Właściwość źródłowa: <treść[^>]>([\s\S])</treść>

Przykładowe wyrażenie regularne wyodrębnia całą zawartość tagu treści pliku HTML.

  • Atrybut artykułu: Identyfikator odwołania zewnętrznego
  • Typ operacji: RegexUrl
  • Właściwość źródłowa: ^https://.?/id/(.?)/.*$

RegexUrl wyodrębnia identyfikator – 2911cacd-efa5-4593-ae22-e09ae14c6698 z pliku HTML.

  • Atrybut artykułu: Tytuł
  • Typ operacji: Bezpośredni
  • Właściwość źródłowa: Tytuł HTML

Bezpośrednio wyodrębnia zawartość z pola Tytuł pliku HTML, na przykład Metoda WSTrustRequestSerializer.CanRead (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

  • Atrybut artykułu: Opis
  • Typ operacji: Wyrażenie regularne
  • Właściwość źródłowa: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

Przykładowe wyrażenie regularne wyodrębnia zawartość z określonego tagu div na podstawie identyfikatora. Tutaj ms-desciptionArticle jest identyfikatorem tagu div w kodzie HTML.

  • Atrybut artykułu: Słowa kluczowe
  • Typ operacji: Bezpośredni
  • Usługa źródłowa: ms.keywords

Bezpośrednio wyodrębnia zawartość z pola ms.keywords pliku HTML, na przykład Czytnik XML, WS -Zaufaj.

Schemat systemu JSON

Dowiedz się więcej o szczegółach schematu, aby utworzyć szablon mapowania metadanych.

  1. W mapie witryny Centrum administracyjne rozwiązania Customer Service, sekcja Schemat artykułu merytorycznego>Schemat JSON, skopiuj i wklej właściwości artykułu oraz schemat JSON w odpowiednim polu dostarczonym dla użytkownika.

  2. Wybierz Potwierdź JSON.

    Jeśli weryfikacja się powiedzie, zostanie wyświetlony komunikat z potwierdzeniem. Jeśli weryfikacja nie powiedzie się, pojawi się komunikat o błędzie identyfikujący parametr, który ma nieprawidłową wartość.

  3. Aby przejść do sekcji Mapowanie, wybierz opcję Dalej. Jeśli chcesz zatrzymać i wrócić do tego punktu później, wybierz opcję Zapisz jako roboczą.

Następne kroki

Zarządzanie zintegrowanymi dostawcami wyszukiwania