Білім мақалаларымен жұмыс істеу

Ескертпе

Мүмкіндіктің қолжетімділігі туралы ақпарат келесідей.

Dynamics 365 байланыс орталығы — ендірілген	Dynamics 365 байланыс орталығы — дербес	Dynamics 365 Customer Service
No	Иә	Иә

Жаңа білім тәжірибесі нұсқалар мен аударманы қолдаумен бірге бай білім мақалаларын жасауға мүмкіндік береді. Жаңа білім тәжірибесінде Dynamics 365 Customer Service бағдарламасында білімді табиғи түрде сақтау және басқару үшін KnowledgeArticle нысаны пайдаланылады.

Ескертпе

KBArticle, KBArticleTemplate және KBArticleComment нысандары енді ұсынылмайды. Бұл осы нысандарды енді пайдаланбайды деп күтіледі дегенді білдіреді. Dynamics 365 Customer Service бағдарламасында білімді жиынтығын басқару үшін жаңалау KnowledgeArticle нысанын пайдалануыңыз қажет. Қосымша ақпаратты осы мақаланың соңындағы Ұсынылмаған білім нысандары бөлімінен қараңыз.

Білім мақаласын жасау

Білім мақаласы жазбасын жасаған кезде 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 әрекеті (веб API) немесе CreateKnowledgeArticleTranslationRequest (ұйым қызметі) пайдаланыңыз. Білім мақаласын 150-ден аса тілге аударуға болады және осы қолдау көрсетілетін тілдер туралы ақпарат жаңа LanguageLocale нысанында қолжетімді.

Қосымша ақпарат: LanguageLocale нысаны.

CreateKnowledgeArticleTranslation әрекеті (веб API) немесе 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));  

Ескертпе

LanguageLocale нысанындағы әрбір тіл жазбасының негізгі кілтінің (LanguageLocaleId) GUID мәні барлық Dynamics 365 Customer Service ұйымдары бойынша бірдей.

Білім мақаласының жарамдылық кезеңі: білім мақаласы күйін өзгерту

Жарамдылық кезеңі барысында білім мақаласы мына күйлерде болуы мүмкін:

• 0: Жоба (білім мақаласы жасалғаннан кейін)

• 1: Расталған (білім мақаласы расталғаннан кейін)

• 2: Жоспарланған (білім мақаласын жариялау жоспарланғаннан кейін)

• 3: Жарияланған (білім мақаласы жарияланғаннан кейін)

• 4: Мерзімі біткен (жариялау кезінде көрсетілген мерзімі біту күніне сәйкес білім мақаласының мерзімі біткеннен кейін)

• 5: Мұрағатталған (білім мақаласы мұрағатталғаннан кейін)

• 6: Алынып тасталған (білім мақаласы алынып тасталғаннан кейін)

Мақала күйін өзгерту үшін, KnowledgeArticle.StateCode төлсипатын жаңарту үшін білім мақаласы жазбасында Update хабарын пайдаланыңыз. Ерте байланыс түрлері үшін ықтимал қадамдарды орнату үшін 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);  
  

Қадамдық білім мақаласын көру саны

KnowledgeArticleViews нысанында берілген күн үшін білім мақаласының жазбасын көру санын арттыру үшін IncrementKnowledgeArticleViewCountRequest хабарын пайдаланыңыз. Көрсетілген күні білім мақаласы үшін жазба бұрыннан болмаса, ол жазбаны жасайды және KnowledgeArticleViews ішіндегі көрсетілген көру саны мәніне орнатылады. KnowledgeArticleView төлсипаты. Көрсетілген күні білім мақаласы үшін жазба бұрыннан болса, ол KnowledgeArticleViews ішінде көру санын арттырады. бұрыннан бар жазбаның KnowledgeArticleView атрибуты.

Білім мақалаларын толық мәтіндік іздеу мүмкіндігімен іздеу

Dynamics 365 Customer Service бағдарламасындағы білім мақалалары (оның ішінде нұсқалары мен аудармалары) — толық мәтіндік индекстелген және қолдау көрсетілетін SQL Server толық мәтіндік іздеу. Толық мәтіндік іздеу туралы қосымша ақпаратты SQL Server: толық мәтіндік іздеу бөлімінен қараңыз.

Сіз іздеген ақпаратты табу үшін бағдарламалардан білім мақаласын іздеу үшін FullTextSearchKnowledgeArticleRequest хабарын пайдаланыңыз. FullTextSearchKnowledgeArticleRequest хабарлама флексия діңін сәйкестендіруді пайдалануға (іздеу мәтіні үшін басқа шақты немесе флексияны ауыстыруға мүмкіндік береді) және сұрау шарттарын көрсетуге (сүзуді көрсету үшін FetchXML немесе QueryExpression арқылы, реттеу, сұрыптау және беттеу) көрсетілген мәтіні бар білім мақалаларын табу. Сонымен қатар іздеу нәтижелеріндегі бір мақалалардың бірнеше нұсқасын жоюды және мәтінді іздеген кезде білім мақаласы күйін сүзгілеуді таңдай аласыз.

Ұсынылмаған білім нысандары

Келесі бұрынғы нысандар ұсынылмайды. Қосымша ақпарат: Ескірген білім нысандары

• KbМақаласы
• KbArticleComment
• KbArticle Template

Бұрынғы білім нысандары 2020 жылғы 1 желтоқсандағы жағдай бойынша қолжетімді емес. KnowledgeArticle нысанына көшуге кеңес береміз. Бірыңғай интерфейс ішінде білім туралы мақаланы жасау туралы қосымша ақпаратты Білім мақалаларын жасау және басқару бөлімінен қараңыз.  

Көшіру анықтамасы үшін мынаны пайдаланыңыз:

• Сценарийлеріңізге байланысты SDK, WebAPI немесе Microsoft Power Automate бағдарламаларын пайдаланыңыз.
• MIT лицензиясы бар ашық кодты көшіру құралын пайдаланыңыз.

Маңызды

• Microsoft корпорациясы ашық кодты көшіру құралына қолдау көрсетпейді және сценарийлерге сәйкес өзгертілуі керек.
• Өндірісте пайдалану алдында үнемі сынақ ортасын іске қосыңыз.
• Құралды пайдалану алдында лицензия мен readme файлын тексеріңіз.

Сондай-ақ, келесіні қараңыз

• Білім қорының нысандары
• KnowledgeArticle нысаны
• Мақала кілт сөздері мен сипаттамасына арналған AI ұсыныстарын конфигурациялау
• KnowledgeArticleViews нысаны
• KnowledgeBaseRecord нысаны
• LanguageLocale нысаны
• Microsoft Dynamics 365 жүйесінің болашақ шығарылымдарында маңызды өзгерістер енгізіледі