العمل مع المقالات المعرفية

‏‫ملاحظة

معلومات توفر الميزة هي كما يلي.

Dynamics 365 Contact Center—مضمن	Dynamics 365 Contact Center—مستقل	Dynamics 365 Customer Service
لا.	نعم	نعم

تمكنك تجربة المعرفة الجديدة من إنشاء مقالات معرفية غنية بالإضافة إلى دعم الإصدارات والترجمة. تستخدم تجربة المعارف الجديدة كيان KnowledgeArticle لتخزين المعارف وإدارتها في الأصل في Dynamics 365 Customer Service.

‏‫ملاحظة‬

يتم الآن إهمال كيانات KBArticle وKBArticleTemplate وKBArticleComment. وهذا يعني أننا لا نتوقع منك استخدام هذه الكيانات بعد الآن. يجب أن تستخدم كيان KnowledgeArticle الأحدث لإدارة المعرفة في Dynamics 365 Customer Service. لمزيد من المعلومات، راجع القسم الكيانات المعرفية المهملة في نهاية هذا الموضوع.

إنشاء مقالة معرفية

عندما تقوم بإنشاء سجل مقالة معرفية، فان Dynamics 365 Customer Service تقوم بإنشاء مقالة جذر للسجل بطريقة داخلية. تعمل المقالة الجذر كحاوية للمقالة المعرفية الأساسية التي أنشأتها مع كل إصدارات وترجمات المقالات التي قد تقوم بإنشائها في المستقبل. يصف المخطط التالي نموذج الكيان الخاص بالكيان KnowledgeArticle.

عندما تقوم بإنشاء سجل مقالة معرفية، فإنه يتم إنشاؤه بالحالة Draft. وباستخدام كيان KnowledgeArticle الجديد، يمكنك إنشاء مقالة من خلال تحديد محتوياتها وتنسيقها بتنسيق HTML. يمكنك تحديد القيمة الخاصة بك لـ KnowledgeArticle. سمة ArticlePublicNumber إنشاء سجل مقالة معرفية برمجيا؛ خلاف ذلك، يتم إنشاء القيمة تلقائيًا استنادًا إلى التنسيق الذي حددته في منطقة إعدادات Dynamics 365 Customer Service في عميل الويب. KnowledgeArticle. تخزن سمة ArticlePublicNumber المعرف المعروض للعملاء والشركاء والمستخدمين الخارجيين الآخرين للرجوع إلى المقالات المعرفية والبحث فيها، وتظل كما هي في كافة الإصدارات والترجمات الخاصة بالمقالات المعرفية.

يوضح مثال التعليمة البرمجية التالية كيف يمكنك إنشاء سجل مقالة معرفية.

KnowledgeArticle newKnowledgeArticle = new KnowledgeArticle  
{  
   Title = "Sample Knowledge Article",  
   Content = "<p>This is the article content.</p>"  
};  
knowledgeArticleId = _serviceProxy.Create(newKnowledgeArticle);  
Console.WriteLine("Created {0}", newKnowledgeArticle.Title);  

إنشاء إصدارات رئيسية وثانوية لمقالة معرفية

عند إنشاء سجل مقالة معرفية، يتم تعيين الإصدار الرئيسي تلقائيًا إلى 1 والإصدار الثانوي إلى 0. استخدم رسالة CreateKnowledgeArticleVersion (إجراء CreateKnowledgeArticleVersion أو CreateKnowledgeArticleVersionRequest) لإنشاء إصدار رئيسي أو ثانوي لإحدى المقالات المعرفية. في رسالة الطلب، قم بتعيين IsMajor إلى true لإنشاء إصدار رئيسي، وقم بتعيينه إلى false لإنشاء إصدار ثانوي. يستخدم سجل الإصدار الجديد الذي تم إنشاؤه ما يلي:

• KnowledgeArticle. سمة RootArticleId للاحتفاظ بالاقتران مع سجل المقالة المعرفية الجذر.

• KnowledgeArticle. سمة PreviousArticleContentId للإشارة إلى الإصدار السابق من السجل.

يوضح مثال التعليمة البرمجية التالية كيف يمكنك إنشاء إصدار رئيسي لسجل مقالة معرفية باستخدام CreateKnowledgeArticleVersionRequest.

CreateKnowledgeArticleVersionRequest versionRequest = new CreateKnowledgeArticleVersionRequest  
{  
   Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),  
   IsMajor = true  
};  
CreateKnowledgeArticleVersionResponse versionResponse = (CreateKnowledgeArticleVersionResponse)_serviceProxy.Execute(versionRequest);  

إنشاء ترجمة لمقال معرفي

استخدم إجراء CreateKnowledgeArticleTranslation (واجهة برمجة تطبيق الويب) أو CreateKnowledgeArticleTranslationRequest (خدمة المؤسسة) لإنشاء ترجمة لسجل مقالة معرفية. يمكنك ترجمه المقالة المعرفية الخاصة بك لأكثر من 150 لغة، وتتوفر معلومات حول هذه اللغات المدعومة في كيان LanguageLocale الجديد.

مزيد من المعلومات: كيان LanguageLocale.

يؤدي استخدام إجراء CreateKnowledgeArticleTranslation (واجهة برمجة تطبيق الويب) أو CreateKnowledgeArticleTranslationRequest (خدمة المؤسسة) إلى إنشاء سجل مقالة معرفية جديدة باستخدام عنوان ومحتوى ووصف وكلمات أساسية يتم نسخها من السجل المصدر إلى السجل الجديد، ويتم تعيين لغة السجل الجديد إلى اللغة التي قمت بتحديدها في الطلب. ستحتاج أيضًا إلى تحديد ما إذا كان السجل الجديد سيكون إصدارًا رئيسيًا أم ثانويًا. يستخدم السجل الجديد KnowledgeArticle. سمة ParentArticleContentId للاحتفاظ بالاقتران مع سجل المقالة المعرفية الأساسي.

بعد تنفيذ هذه الرسالة والحصول على استجابة، قم باسترداد سجل المقالة المعرفية من كائن الاستجابة، ثم قم بتحديث العنوان والمحتوى والوصف والكلمات الأساسية لإضافة المحتوى المترجم.

يوضح مثال التعليمة البرمجية التالية كيف يمكن إنشاء ترجمة مقالة معرفية باستخدام CreateKnowledgeArticleTranslationRequest.

CreateKnowledgeArticleTranslationRequest translationRequest = new CreateKnowledgeArticleTranslationRequest  
{  
   Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),  
   Language = new EntityReference(LanguageLocale.EntityLogicalName, languageLocaleId), //languageLocaleId = GUID of the Primary Key of LanguageLocale record  
   IsMajor = true    // Creating a major version   
};  
CreateKnowledgeArticleTranslationResponse translationResponse = (CreateKnowledgeArticleTranslationResponse)_serviceProxy.Execute(translationRequest);  
  
// Retrieve the new knowledge article record  
KnowledgeArticle respObject = (KnowledgeArticle)_serviceProxy.Retrieve(KnowledgeArticle.EntityLogicalName,   
      translationResponse.CreateKnowledgeArticleTranslation.Id, new ColumnSet(true));  

‏‫ملاحظة‬

تكون قيمة المعرف الفريد العمومي (GUID) للمفتاح الأساسي (LanguageLocaleId) لكل سجل لغة في الكيان LanguageLocale هي نفسها في كافة مؤسسات Dynamics 365 Customer Service.

دورة حياة المقالة المعرفية: تغيير حالة مقالة معرفية

أثناء دورة حياتها، يمكن أن تكون المقالة المعرفية بالحالات التالية:

• 0: مسودة (بعد إنشاء المقالة المعرفية)

• 1: معتمدة (بعد الموافقة على المقالة المعرفية)

• 2: مجدولة (بعد جدولة مقالة معرفية ليتم نشرها)

• 3: منشورة (بعد نشر المقالة المعرفية)

• 4: منتهية الصلاحية (بعد انتهاء صلاحية إحدى المقالات المعرفية حسب تاريخ انتهاء الصلاحية المحدد في النشر)

• 5: مؤرشفة (بعد أرشفة المقالة المعرفية)

• 6: متجاهلة (بعد تجاهل المقالة المعرفية)

لتغيير حالة المقالة، استخدم رسالة Update في سجل المقالة المعرفية لتحديث السمة KnowledgeArticle.StateCode. بالنسبة لأنواع الربط المبكر، استخدم تعداد KnowledgeArticleState لتعيين الحالات المحتملة. مزيد من المعلومات: اجراء عمليات متخصصة باستخدام التحديث.

يوضح مثال التعليمة البرمجية التالية كيف يمكن نشر سجل مقالة معرفية

// Retrieve the knowledge article record  
KnowledgeArticle myKnowledgeArticle = (KnowledgeArticle)_serviceProxy.Retrieve(  
        KnowledgeArticle.EntityLogicalName, knowledgeArticleId, new ColumnSet("statecode"));  
  
// Update the knowledge article record  
myKnowledgeArticle.StateCode = KnowledgeArticleState.Published;  
UpdateRequest updateKnowledgeArticle = new UpdateRequest  
{  
    Target = myKnowledgeArticle  
};  
_serviceProxy.Execute(updateKnowledgeArticle);  
  

إقران سجل مقالة معرفية بمثيل كيان Dynamics 365 Customer Service.

عند تمكين البحث عن المعرفة المضمن لكيان في Dynamics 365 Customer Service باستخدام عميل الويب، يتم تلقائيًا إنشاء علاقة كثير إلى كثير msdyn_<Entity_Name>_knowledgearticle. يمكنك استخدام هذه العلاقة لإقران مثيل KnowledgeArticle أو ربطه برمجيًا بمثيل كيان Dynamics 365 Customer Service. عندما تقوم بإقران مثيل KnowledgeArticle بمثيل كيان، يتم إنشاء سجل للعلاقة في كيان متقاطع يسمي msdyn_<Entity_Name>_knowledgearticle. على سبيل المثال، عند إقران مثيل KnowledgeArticle بمثيل Account للمرة الأولى، يتم إنشاء كيان متقاطع يسمى msdyn_account_knowledgearticle، ويتم إنشاء سجل بتعيين الاقتران في هذا الكيان المتقاطع. وبشكل افتراضي، يتم تمكين الكيان Incident (الحالة) للبحث عن المعرفة المدمج، وعند ربط سجل KnowledgeArticle بسجل Incident، يتم إنشاء سجل اقتران في الكيان KnowledgeArticleIncident المتقاطع.

يوضح مثال التعليمة البرمجية التالي كيفية إقران مثيل KnowledgeArticle بمثيل Account:

// Associate the knowledge article record with an account record  
  
// Step 1: Create a collection of knowledge article records that will be   
// associated to the account. In this case, we have only a single  
// knowledge article record to be associated.  
EntityReferenceCollection relatedEntities = new EntityReferenceCollection();  
relatedEntities.Add(new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId));  
  
// Step 2: Create an object that defines the relationship between knowledge article record and account record.  
// Use the many-to-many relationship name (msdyn_account_knowledgearticle) between knowledge article  
// record and account record.  
Relationship newRelationship = new Relationship("msdyn_account_knowledgearticle");  
  
// Step 3: Associate the knowledge article record with the account record.  
_serviceProxy.Associate(Account.EntityLogicalName, accountId, newRelationship, relatedEntities);  
  

تزايد عدد مرات مشاهدة المقالة المعرفية

استخدم الرسالة IncrementKnowledgeArticleViewCountRequest لحساب تزايد عدد مرات مشاهدة سجل المقالة المعرفية ليوم محدد في الكيان KnowledgeArticleViews. إذا لم يكن هناك سجل موجود لأي مقالة معرفية خاصة بيوم محدد، سيقوم بإنشاء سجل ثم تعيين قيمة عدد المشاهدات المحددة في KnowledgeArticleViews. سمة KnowledgeArticleView. إذا كان أحد السجلات موجودًا بالفعل لإحدى المقالات المعرفية الخاصة بيوم محدد، فسيتم فقط حساب تزايد عدد المشاهدات في KnowledgeArticleViews. سمة KnowledgeArticleView للسجل الموجود.

البحث في المقالات المعرفية باستخدام البحث عن نص كامل

تكون المقالات المعرفية في Dynamics 365 Customer Service، يشمل ذلك الإصدارات والترجمات الخاصة بها، مفهرسة بكامل النص وتدعم البحث الكامل النص في خادم SQL. لمزيد من المعلومات حول البحث بكامل النص، راجع خادم SQL: البحث بكامل النص.

استخدم رحالة FullTextSearchKnowledgeArticleRequest للبحث في المقالة المعرفية من التطبيقات الخاصة بك للعثور على المعلومات التي تبحث عنها. تتيح FullTextSearchKnowledgeArticleRequest لك الرسالة استخدام المطابقة الجذرية التصريفية (تسمح باستبدال توتر أو تصريف مختلف لنص البحث) وتحديد معايير الاستعلام (باستخدام FetchXML أو QueryExpression لتحديد التصفية والترتيب والفرز والترحيل) للعثور على المقالات المعرفية التي تحتوي على نص محدد. يمكنك أيضا اختيار إزالة إصدارات متعددة لنفس المقالات الموجودة في نتائج البحث والتصفية حسب حالة المقالة المعرفية أثناء البحث عن نص.

كيانات المعرفة المهملة

تم إهمال الكيانات القديمة التالية. مزيد من المعلومات: كيانات المعرفة المهملة

• KbArticle
• KbArticleComment
• KbArticleTemplate

لا يمكن الوصول إلى كيانات المعارف القديمة حتى 1 ديسمبر 2020. من المستحسن الانتقال إلى كيان KnowledgeArticle. لمزيد من المعلومات حول إنشاء مقالة معرفية في الواجهة الموحدة، راجع إنشاء مقالات معرفية وإدارتها.  

استخدم التالي للحصول مساعدة بشأن الترحيل:

• استخدم SDK أو WebAPI أو Microsoft Power Automate وفقًا للسيناريوهات الخاصة بك.
• استخدم أداة الترحيل مفتوحة المصدر مع ترخيص MIT.

هام

• لا يتم دعم أداة الترحيل مفتوحة المصدر بواسطة Microsoft وقد تحتاج إلى تعديلها لتناسب السيناريوهات الخاصة بك.
• قم دائمًا بالتشغيل بيئة اختبار قبل الاستخدام في بيئة الإنتاج.
• تحقق من الترخيص والملف التمهيدي قبل استخدام الأداة.

راجع أيضًا

• كيانات قاعدة المعارف
• كيان KnowledgeArticle
• تكوين اقتراحات الذكاء الاصطناعي للأوصاف والكلمات الأساسية في المقالات
• كيان KnowledgeArticleViews
• كيان KnowledgeBaseRecord
• كيان LanguageLocale
• تغييرات مهمة قادمة في الإصدارات المستقبلية من Microsoft Dynamics 365