設定知識文章結構描述對應

發行項
12/08/2023

在 Customer Service 中新增整合式搜尋提供者時，您必須告訴服務如何擷取從提供者接收的知識文章。您可以選取並設定知識文章結構描述來做到這一點。儲存設定之後，您就無法變更結構描述。

如果您在驗證和測試區段中套用語言篩選，則必須維護 JSON 結構描述中的，或知識文章結構描述對應區段中的語言地區設定對應。如需語言地區設定值的詳細資訊，請前往：語言 (語言地區設定) 資料表/實體參考。

選取知識文章結構描述區段中的選項：

欄位對應
JSON 結構描述

欄位對應

選取並上傳檔案以供選擇中繼資料，然後選取要用於對應的中繼標籤。您可以透過欄位對應，根據作業類型，將從搜尋提供者 (來源屬性 (Property)) 收到的知識文章對應至知識文章實體 (目標) 的屬性 (Attribute)。

選取並上傳檔案以供選擇中繼資料

將文章儲存為網頁 (僅限 HTML) 檔案。確定檔案名稱少於 99 個字元。
在 Customer Service 系統管理中心網站地圖的知識文章結構描述>欄位對應區段中，選取選擇檔案以上傳檔案。

在 HTML 檔案中找到的所有中繼標籤都會在中繼標籤設定區段中列出。
選擇選取以下所有的中繼標籤，或是僅選取對應所需的中繼標籤。

此處所選的中繼標籤會變成您可在對應區段中選取做為來源屬性 (Property) 的屬性 (Attribute)。如果未選取任何標籤，則只有預設來源屬性 HTML-Title 和 HTML-Body 可用於對應。
若要移至對應，請選取下一步。如果要停止，稍後再返回此位置，請選取另存為草稿。

對應文章屬性

使用作業類型將來源屬性對應至目標。

文章屬性：知識文章目標欄位值。
作業類型：將來源文章對應至知識文章實體文章屬性的對應模式。深入了解作業類型對應選項。
來源屬性：您為每個作業類型定義的值。例如，如果您選取直接作業類型，則必須在先前選取的中繼標籤或 HTML-Title 標籤當中選取。

在 Customer Service 系統管理中心網站地圖的對應區段中，必要的知識文章屬性為內容、外部參考識別碼和標題。為每個屬性選取作業類型和來源屬性。

確定外部參考識別碼值是唯一的。
若要新增其他文章屬性，請選取新增列，然後選取文章屬性、作業類型和來源屬性。

如有需要，也可以選取刪除來刪除文章屬性。
選取驗證對應。

服務會使用您輸入的值，對照您上傳的 HTML 檔案來判斷屬性的值。這會驗證對應資料表和 RegEx 模式中的項目。對 RegexUrl 沒有驗證。

如果驗證成功，就會看到確認訊息。如果驗證失敗，則會看到錯誤訊息。根據錯誤訊息，檢查您在對應資料表或 RegEx 模式中輸入的項目。
選取下一步移至下一個區段。如果要停止，稍後再返回此位置，請選取另存為草稿。

作業類型對應選項

從下列作業類型對應選項中選取：

RegEx：使用 RegEx 模式以從來源網站擷取值。來源屬性是您可在其中輸入 RegEx 模式的文字欄位。網站 HTML 中與此模式相符的字串會對應至相應的知識文章欄位。

RegEx 模式必須有擷取群組置於括號內，讓您可以擷取相符文字的特定部分。將會從第一個相符項目的第一個非空群組中擷取文字。

以下是一些用來從特定 div 標籤擷取內容的 RegEx 模式範例：
- 根據 div 標籤識別碼：<div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
- 根據 div 標籤類別：<div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
- 對於 body 標記中的內容：<body[^>]*>([\s\S]*)<\/body>
- 對於 head 標記中的內容：<head[^>]*>([\s\S]*)<\/head>
直接：將任何中繼標籤的值從其來源網站直接對應至任何知識文章欄位。 來源屬性清單會顯示所有從範例網站擷取的中繼標籤，以及預設提供的來源屬性 HTML-Title 和 HTML-Body。

如果選取直接做為作業類型以及 og: url 做為來源屬性，則會將來源屬性 (Property) 中的 og: url 中繼標籤值對應至相應的知識文章屬性 (Attribute)。
常數：在任何知識文章欄位中輸入常數值。來源屬性是您可在其中輸入常數值的文字欄位。
RegexUrl：類似於 RegEx，但只會在來源網站的 URL 中尋找相符項目。若要將整個來源網站 URL 對應至知識屬性欄位，請在作業類型中選取 Regexurl，然後在來源屬性中使用 (. *) 模式。

以下範例說明如何對應文章屬性。

範例

範例 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>

使用下列作業類型將來源屬性對應至範例 HTML 檔案中的目標：

螢幕擷取畫面說明所選 HTML 檔案的對應。

其中，

文章屬性：內容
作業類型：Regex
來源屬性：<body[^>]>([\s\S])</body>

範例 RegEx 擷取 HTML 檔案之 body 標籤內的全部內容。

文章屬性：外部參考識別碼
作業類型：RegexUrl
來源屬性：^https://.?/id/(.?)/.*$

RegexUrl 從 HTML 檔案擷取識別碼 - 2911cacd-efa5-4593-ae22-e09ae14c6698。

文章屬性：標題
作業類型：Direct
來源屬性：HTML-Title

Direct 擷取 HTML 檔案之標題欄位中的內容，例如 WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

文章屬性：描述
作業類型：Regex
來源屬性：<div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

範例 RegEx 根據識別碼從特定 div 標籤擷取內容。這裡的 ms-desciptionArticle 是 HTML 中 div 標籤的識別碼。

文章屬性：關鍵字
作業類型：Direct
來源屬性：ms.keywords

Direct 擷取 HTML 檔案之 ms.keywords 欄位中的內容，例如 XML 讀取器、WS-Trust。

JSON 結構描述

了解用於建置中繼資料對應範本的結構描述詳細資料。

在 Customer Service 系統管理中心網站地圖的知識文章結構描述>JSON 結構描述區段中，複製文章屬性和結構描述 JSON 並在提供給您的欄位中將其貼上。
選取驗證 JSON。

如果驗證成功，就會看到確認訊息。如果驗證失敗，則會看到錯誤訊息，指出其值不正確的參數。
選取下一步移至下一個區段。如果要停止，稍後再返回此位置，請選取另存為草稿。

後續步驟

管理整合式搜尋提供者

共用方式為