Aracılığıyla paylaş


Bilgi bankası makalesi şema eşlemesini yapılandırma

Customer Service'te tümleşik bir arama sağlayıcısı ekleme işlemenin parçası olarak, hizmete sağlayıcıdan aldığı bilgi bankası makalelerini nasıl içeri alacağını bildirmeniz gerekir. Bunu, bir bilgi bankası şeması seçip yapılandırarak gerçekleştirsiniz. Yapılandırmayı kaydettikten sonra şemayı değiştiremezsiniz.

Kimlik doğrulaması ve Test bölümünde dil filtresi uyguladıysanız, JSON Şeması veya Bilgi bankası şema eşlemesi bölümünde dil yerel ayarı için eşlemeyi korumanız gerekir. Dil yerel ayar değerleri hakkında daha fazla bilgi için: Dil (LanguageLocale) tablo/varlık başvurusu'na gidin.

Bilgi Bankası makalesi şeması bölümünde bir seçenek belirleyin:

Alan eşleme

Meta veri seçimi için dosyayı seçip yükleyin ve ardından eşlemede kullanmak istediğiniz meta etiketleri seçin. Alan eşleme ile, arama sağlayıcısından (kaynak özellik) alınan bir Bilgi Bankası makalesini, bir işlem türüne göre bilgi bankası makalesinin (hedef) bir özniteliğine eşlersiniz.

Meta veri seçimi için dosyayı seçin ve yükleyin

  1. Makaleyi Web Sayfası, Yalnızca HTML dosyası olarak yerel olarak kaydedin. Dosya adının 99 karakterden az olduğundan emin olun.

  2. Customer Service yönetim merkezi site haritasında Bilgi bankası makalesi şeması>Alan Eşlemesi bölümünde, Dosya seç'i seçerek dosyayı karşıya yükleyin.

    HTML dosyanızda bulunan tüm meta etiketler Meta etiketleri ayarları bölümünde listelenir.

  3. Aşağıdaki tüm meta etiketleri seç'i seçin veya yalnızca eşlemeniz gereken meta etiketleri seçin.

    Burada seçtiğiniz meta etiketler, Eşleme bölümünde kaynak özellikleri olarak seçebileceğiniz öznitelikler olarak kullanılabilir. Herhangi bir meta etiket seçmezseniz yalnızca varsayılan kaynak özellikleri olan HTML-Başlık ve HTML-Gövde eşleme için kullanılabilir.

  4. Eşleme bölümüne gitmek için İleri'yi seçin. Durdurup bu noktaya daha sonra dönmek isterseniz Taslak olarak kaydet'i seçin.

Makale özniteliklerini eşle

Kaynak özelliği hedefle eşlemek için bir işlem türü kullanın.

  • Makale öznitelikleri: Bilgi bankası makalesi hedef alan değerleri.
  • İşlem türleri: Kaynak makaleyi, bilgi bankası makalesi varlığının makale özniteliğine eşleyen eşleme desenleri. İşlem türü eşleme seçenekleri hakkında daha fazla bilgi edinin.
  • Kaynak özelliği: Her işlem türü için tanımladığınız değer. Örneğin, Doğrudan işlem türünü seçtiğinizde, daha önce seçilen meta etiketleri veya HTML-Title etiketini seçmeniz gerekir.
  1. Customer Service yönetim merkezi site haritasında, Eşleme bölümünde zorunlu bilgi bankası makalesi öznitelikleri İçerik, Harici Referans Kimliği ve Başlık'tır. Her biri için bir İşlem Türü ve bir Kaynak Özellik seçin.

    Harici Referans Kimliği değerinin benzersiz olduğundan emin olun.

  2. Daha fazla makale özniteliği eklemek için Satır Ekle'yi ve ardından Makale Özniteliği, İşlem Türü ve Kaynak Özelliği seçin.

    Gerekirse bir makale özniteliği seçmek için Sil'i de seçebilirsiniz.

  3. Eşlemeyi doğrula'yı seçin.

    Hizmet, yüklediğiniz HTML dosyasına göre öznitelik değerlerini belirlemek üzere girdiğiniz değerleri kullanır. Eşleme tablosunda ve Normal ifade desenlerindeki girişleri doğrular. RegexUrl için doğrulama yok.

    Doğrulama başarılı olursa, bir onay iletisi görürsünüz. Doğrulama başarısız olursa, bir hata iletisi görürsünüz. Hata iletisine bağlı olarak, eşleme tablosundaki girişleri veya girmiş olduğunuz normal ifade desenlerini işaretleyin.

  4. İleriki bölüme gitmek için İleri'yi seçin. Durdurup bu noktaya daha sonra dönmek isterseniz Taslak olarak kaydet'i seçin.

İşlem türü eşleme seçenekleri

Aşağıdaki işlem türü eşleştirme seçenekleri arasından seçim yapın:

  • Normal ifade: Kaynak web sitesinden değerleri ayıklamak için normal ifade desenleri kullanır. Kaynak özelliği, normal ifade desenini girebileceğiniz bir metin alanıdır. Web sitenizin HTML'sinden bu desenle eşleşen dize karşılık gelen bilgi bankası makalesi alanına eşlenir.

    Normal ifade desenlerinde, eşleşen metnin belirli bir bölümünü ayıklamanızı sağlayan parantez içine alınmış bir yakalama grubu olmalıdır. Metin ilk eşleşmenin boş olmayan ilk grubundan ayıklanır.

    Belirli bir div etiketinden içerik ayıklamaya yönelik bazı Regex örnekleri aşağıda verilmektedir:

    • Div etiketi kimliğine göre: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Div etiketi sınıfına göre: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Gövde etiketi içindeki içerik için: <body[^>]*>([\s\S]*)<\/body>
    • Başlık etiketi içindeki içerik için: <head[^>]*>([\s\S]*)<\/head>
  • Doğrudan: Kaynak web sitesindeki herhangi bir metee etiketin değerini doğrudan herhangi bir bilgi bankası makalesi alanıyla eşler. Kaynak Özelliği örnek web sitesinden ayıklanan tüm meta etiketleri, varsayılan olarak kullanılabilir olan HTML-Başlık ve HTML-Gövde kaynak özellikleri ile birlikte listeler.

    İşlem türü olarak Doğrudan ve kaynak özelliği olarak og:url seçerseniz, kaynak özellikten gelen og:url meta etiketinin değeri karşılık gelen Bilgi Bankası makalesi özniteliğiyle eşlenir.

  • Sabit: Herhangi bir bilgi bankası makalesi alanına bir sabit değer girin. Kaynak özelliği, sabit değeri girebileceğiniz bir metin alanıdır.

  • RegexUrl: Normal ifade gibidir ancak yalnızca kay web sitebib URL'sindeki eşleşmeleri arar. Kaynak web sitesi URL'sinin tamamını bir bilgi bankası özniteliği alanıyla eşlemek için işlem türünde Regexurl seçin ve kaynak özellikte (. *) desenini kullanın.

Makale özniteliklerinin nasıl eşleneceğini açıklayan bir örneği burada bulabilirsiniz.

Örnek

Örnek 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>

Kaynak özelliğini örnek html dosyasındaki hedefle eşlemek için aşağıdaki işlem türlerini kullanın:

Ekran görüntüsü, seçilen html dosyasındaki eşlemeyi açıklar.

konumu,

  • Makale Özniteliği: İçerik
  • İşlem türü: Normal ifade
  • Kaynak Özelliği: <gövde[^>]>([\s\S]) </gövde>

Örnek normal ifade HTML dosyasının gövde etiketi içindeki içeriğin tamamını çıkarır.

  • Makale Özelliği: Harici Referans Kimliği
  • İşlem türü: RegexUrl
  • Kaynak Özellik: ^https://.?/id/(.?)/.*$

RegexUrl kimliğini - 2911cacd-efa5-4593-ae22-e09ae14c6698 HTML dosyasından çıkarır.

  • Makale Özniteliği: Başlık
  • İşlem türü: Doğrudan
  • Kaynak Özelliği: HTML-Başlık

Doğrudan HTML dosyasının Başlık alanındaki içeriği çıkarır; örneğin, WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

  • Makale Özniteliği: Tanım
  • İşlem türü: Normal ifade
  • Kaynak Özelliği: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

Örnek normal ifade kimliğe dayalı olarak belirli bir div etiketinden içerik çıkarır. Burada, ms-desciptionArticle html'deki div etiketinin kimliğidir.

  • Makale Özniteliği: Anahtar Sözcükler
  • İşlem türü: Doğrudan
  • Kaynak Özelliği: ms.keywords

Doğrudan HTML dosyasının ms.keywords alanındaki içeriği çıkarır; örneğin XML Okuyucu, WS -Güven.

JSON şeması

Meta verileri eşleme şablonu oluşturmak için şema ayrıntıları hakkında daha fazla bilgi edinin.

  1. Customer Service yönetim merkezi site haritası, Bilgi makalesi şeması>JSON Şeması bölümünde, makale özelliklerinizi ve şema JSON'unuzu kopyalayıp size sağlanan alana yapıştırın.

  2. JSON doğrula'yı seçin.

    Doğrulama başarılı olursa, bir onay iletisi görürsünüz. Doğrulama başarısız olursa, yanlış değere sahip parametreyi belirten bir hata iletisi görürsünüz.

  3. İleriki bölüme gitmek için İleri'yi seçin. Durdurup bu noktaya daha sonra dönmek isterseniz Taslak olarak kaydet'i seçin.

Sonraki adımlar

Tümleşik arama sağlayıcılarını yönetme