تكوين مخطط المقالة المعرفية
ملاحظة
معلومات توفر الميزة هي كما يلي.
Dynamics 365 Contact Center—مضمن | Dynamics 365 Contact Center—مستقل | Dynamics 365 Customer Service |
---|---|---|
لا. | نعم | نعم |
كجزء من إضافة موفر بحث متكامل في Customer Service، ستحتاج إلى إعلام الخدمة عن كيفية استيعاب المقالات المعرفية التي تتلقاها من الموفر. يمكنك القيام بذلك عن طريق تحديد مخطط مقالة معرفية وتكوينه. لا يمكنك تغيير المخطط بعد حفظ التكوين.
إذا قمت بتطبيق عامل تصفية لغة في قسم المصادقة والاختبار، فيجب الاحتفاظ بتعيين للغة المحلية سواء في مخطط JSON أو في القسم تعيين مخطط المقالة المعرفية. لمزيد من المعلومات حول قيم اللغات المحلية، انتقل إلى: جدول اللغة (LanguageLocale) /مرجع كيان اللغة.
حدد خيارًا في قسم مخطط المقالة المعرفية:
تعيين الحقل
حدد الملف وقم بتحميله لتحديد بيانات التعريف، ثم حدد العلامات التعريفية التي تريد استخدامها في التعيين. عند تعيين الحقل، يمكنك تعيين مقالة معرفية مستلمة من موفر البحث (الخاصية المصدر) إلى سمة من كيان المقالة المعرفية (الهدف)، بالاستناد إلى نوع العملية.
حدد الملف وقم بتحميله لاختيار بيانات التعريف
احفظ المقال محليًا باعتباره ملف صفحة ويب، HTML فقط. تأكد من أن اسم الملف أقل من 99 حرفًا.
في مخطط موقع مركز مسؤولي Customer Service أو مركز مسؤولي Contact Center، قسم مخطط المقالة المعرفية>تعيين الحقول، قم بتحميل الملف بتحديد اختيار ملف.
يتم سرد كافة علامات التعريف الموجودة في ملف HTML في القسم إعدادات علامات التعريف.
حدد الخيار تحدد جميع علامات التعريف أدناه أو حدد فقط علامات التعريف التي تحتاج إلى تعيينها.
تصبح علامات التعريف التي تحددها هنا سمات يمكنك تحديدها كخصائص مصدر في قسم التعيين. إذا لم تحدد أي خاصية من هذه الخصائص، فستتوفر فقط تتوفر خصائص المصدر الافتراضية HTML-Title وHTML-Body للتعيين.
للانتقال إلى قسم التعيين، حدد التالي. إذا أردت التوقف ثم الرجوع إلى هذه النقطة لاحقًا، فحدد حفظ كمسودة.
تعيين سمات المقال
استخدم نوع العملية لتعيين خاصية المصدر إلى الهدف.
- سمات المقالة: قيم الحقول الهدف للمقالة المعرفية.
- أنواع العمليات: أنماط التعيين التي يتم من خلالها تعيين المقالة المصدر إلى سمات المقالة لكيان المقالة المعرفية. اعرف المزيد حول خيارات تعيين نوع العملية.
-
الخاصية المصدر: القيمة التي تقوم بتعريفها لكل نوع عملية. على سبيل المثال، إذا حددت نوع العملية المباشرة، فعليك التحديد من بين علامات التعريف المحددة في السابق أو علامة
HTML-Title
.
في مخطط موقع مركز مسؤولي Customer Service أو مركز مسؤولي Contact Center، قسم التعيين، تكون سمات المقالة المعرفية الإلزامية هي المحتوى، ومعرف المرجع الخارجي، والتجانب. لكل سمة، حدد نوع عملية وخاصية مصدر.
تأكد من أن قيمة معرف لمرجع الخارجي هي قيمة فريدة.
لإضافة المزيد من سمات المقالة، حدد إضافة صف، ثم حدد سمة المقالة ونوع العملية والخاصية المصدر.
يمكنك أيضًا تحديد حذف لحذف سمة مقالة عند الحاجة.
حدد التحقق من صحة التعيين.
تستخدم الخدمة القيم التي قمت بإدخالها لتحديد قيم السمات مقابل ملف HTML الذي قمت بتحميله. وهي تتحقق من صحة الإدخالات في جدول التعيين وأنماط Regex. لا توجد عمليات تحقق صحة RegexUrl.
وفي حالة نجاح التحقق من الصحة، ترى رسالة التأكيد. وفي حالة فشل التحقق من الصحة، سترى رسالة خطأ. بالاستناد إلى رسالة الخطأ، تحقق من الإدخالات في جدول التعيين أو أنماط regex التي قمت بإدخالها.
حدد التالي للانتقال إلى القسم التالي. إذا أردت التوقف ثم الرجوع إلى هذه النقطة لاحقًا، فحدد حفظ كمسودة.
خيارات تعيين نوع العملية
حدد من ضمن خيارات تعيين أنواع العمليات:
Regex: يستخدم أنماط regex لاستخراج قيم من موقع الويب المصدر. الخاصية المصدر هي حقل نصي حيث يمكنك إدخال نمط regex. يتم تعيين السلسلة من HTML موقعك على الويب التي تتطابق مع هذا النمط إلى حقل المقالة المعرفية المقابل.
يجب أن يكون لدى أنماط Regex مجموعة التقاط مضمنة بين أقواس تتيح لك استخراج جزء محدد من النص المتطابق. تم استخراج النص من مجموعة nonempty الأولى في أول تطابق.
فيما يلي بعض الأمثلة عن أنماط regex لاستخراج المحتوى من علامة div معينة:
- بالاستناد إلى معرف علامة div:
<div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
- بالاستناد إلى فئة علامة div:
<div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
- للمحتوى داخل علامة النص الأساسي:
<body[^>]*>([\s\S]*)<\/body>
- للمحتوى داخل علامة الرأس:
<head[^>]*>([\s\S]*)<\/head>
- بالاستناد إلى معرف علامة div:
مباشر: يتم تعيين قيمة أي علامة تعريف من موقعها على الويب المصدر مباشرة إلى أي حقل مقالة معرفية. تسرد قائمة الخاصية المصدر جميع علامات التعريف التي تم استخراجها من عينة موقع الويب مع الخصائص المصدر HTML-Title وHTML-Body، المتوفرة بشكل افتراضي.
إذا حددت مباشر كنوع عملية، وog: url باعتباره الخاصية المصدر، فيتم تعيين قيمة علامة تعريف og: url من الخاصية المصدر إلى سمة المقالة المعرفية المقابلة.
ثابت: أدخل قيمة ثابتة في أي حقل مقالة معرفية. الخاصية المصدر هي حقل نصي حيث يمكنك إدخال القيمة الثابتة.
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:
حيث،
- سمة المقالة: المحتوى
- نوع العملية: Regex
- خاصية المصدر: <body[^>]>([\s\S])</body>
تستخرج عينة regex المحتوى بالكامل داخل علامة النص الأساسي لملف HTML.
- سمة المقالة: معرف المرجع الخارجي
- نوع العملية: RegexUrl
- خاصية المصدر: ^https://.?/id/(.?)/.*$
يستخرج RegexUrl المعرف - 2911cacd-efa5-4593-ae22-e09ae14c6698 من ملف HTML.
- سمة المقالة: العنوان
- نوع العملية: مباشر
- خاصية المصدر: HTML-Title
يستخرج الخيار مباشر المحتوى داخل حقل العنوان في ملف HTML، على سبيل المثال، WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn
- سمة المقالة: الوصف
- نوع العملية: Regex
- خاصية المصدر: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>
تستخرج عينة regex المحتوى من علامة div محددة بناءً على المعرف. هنا، ms-desciptionArticle هو معرف علامة div في HTML.
- سمة المقالة: كلمات أساسية
- نوع العملية: مباشر
- خاصية المصدر: ms.keywords
يستخرج الخيار مباشر المحتوى ضمن حقل ms.keywords لملف HTML، على سبيل المثال XML Reader, WS-Trust.
مخطط JSON
اعرف المزيد حول تفاصيل المخطط لإنشاء قالب تعيين بيانات التعريف.
في مخطط موقع مركز مسؤولي Customer Service أو مركز مسؤولي Contact Center، قسم مخطط المقالة المعرفية>مخطط JSON، انسخ والصق خصائص مقالتك ومخطط JSON في الحقل المقدم لك.
حدد التحقق من صحة JSON.
وفي حالة نجاح التحقق من الصحة، ترى رسالة التأكيد. إذا فشل التحقق من الصحة، سترى رسالة خطأ تحدد المعلمة التي لها قيمة غير صحيحة.
حدد التالي للانتقال إلى القسم التالي. إذا أردت التوقف ثم الرجوع إلى هذه النقطة لاحقًا، فحدد حفظ كمسودة.