Kopīgot, izmantojot

Darbs ar zināšanu bāzes rakstiem

  • Raksts

Piezīmes

Informācija par līdzekļu pieejamību ir šāda.

Dynamics 365 kontaktcentrs — iegults Dynamics 365 kontaktcentrs — savrups Dynamics 365 Customer Service
Nē. Jā Jā

Jaunā zināšanu pieredze ļauj jums izveidot bagātīgus zināšanu bāzes rakstus, kā arī versiju izveides un tulkošanas atbalstu. Jauno zināšanu pieredze izmanto entītiju KnowledgeArticle, lai glabātu un pārvaldītu zināšanas vietēji risinājumā Dynamics 365 Customer Service.

Piezīmes

Entītijas KBArticle, KBArticleTemplate un KBArticleComment tagad ir novecojušas. Mēs plānojam, ka šīs entītijas vairs neizmantosit. Jāizmanto jaunākā KnowledgeArticle entītija zināšanu pārvaldībai risinājumā Dynamics 365 Customer Service. Lai iegūtu papildinformāciju, skatiet sadaļu Novecojušas zināšanu entītijas šīs tēmas beigās.

Zināšanu bāzes raksta izveide

Izveidojot zināšanu bāzes raksta ierakstu, Dynamics 365 Customer Service iekšēji izveido ieraksta saknes rakstu. Saknes raksts darbojas kā primārā zināšanu bāzes raksta konteiners, ko izveidojat jūs kopā ar visām raksta versijām un tulkojumiem, ko, iespējams, izveidosit turpmāk. Tālāk redzamajā diagrammā attēlots entītijas modelis KnowledgeArticle entītijai.

KnowledgeArticle entītijas modelis.

Veidojot zināšanu bāzes raksta ierakstu, tas tiek veidots Draft statusā. Izmantojot jauno KnowledgeArticle entītiju, varat izveidot rakstu, norādot tā saturu un formatējumu HTML formātā. Varat norādīt savu entītijas vērtību KnowledgeArticle. ArticlePublicNumber atribūts, veidojot zināšanu bāzes raksta ierakstu programmiski; citādi vērtība tiek ģenerēta automātiski, ņemot vērā formātu, kas norādīts tīmekļa klienta Dynamics 365 Customer Service iestatījumu apgabalā. KnowledgeArticle. ArticlePublicNumber atribūts glabā ID, kuru rāda klientiem, partneriem un citiem ārējiem lietotājiem atsaucei un zināšanu bāzes rakstu uzmeklēšanai un tas ir vienāds visās zināšanu bāzes raksta versijās un tulkojumos.

Tālāk norādītajā koda paraugā parādīts, kā izveidot zināšanu bāzes raksta ierakstu.

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);

Zināšanu bāzes raksta galvenās un papildu versijas izveide

Veidojot zināšanu bāzes raksta ierakstu, galvenā versija automātiski tiek iestatīta uz 1 un papildu versija uz 0. Izmantojiet CreateKnowledgeArticleVersion ziņojumu (Darbību CreateKnowledgeArticleVersion vai CreateKnowledgeArticleVersionRequest), lai izveidotu galveno vai papildu zināšanu bāzes raksta versiju. Pieprasījuma ziņojumā, iestatiet IsMajor uz true, lai izveidotu galveno versiju; iestatiet uz false, lai izveidotu papildu versiju. Jaunizveidotais versijas ieraksts izmanto:

  • KnowledgeArticle. RootArticleId atribūtu, lai uzturētu saistību ar saknes zināšanu bāzes raksta ierakstu.

  • KnowledgeArticle. PreviousArticleContentId atribūtu, lai norādītu uz ieraksta iepriekšējo versiju.

Tālāk norādītajā koda paraugā parādīts, kā izveidot zināšanu bāzes raksta galveno versiju, izmantojot CreateKnowledgeArticleVersionRequest.

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

Zināšanu bāzes raksta tulkojuma izveide

Izmantojiet darbību CreateKnowledgeArticleTranslation(Tīmekļa API) vai CreateKnowledgeArticleTranslationRequest (organizācijas servisu), lai izveidotu zināšanu bāzes raksta ieraksta tulkojumu. Varat tulkot savu zināšanu bāzes rakstu vairāk nekā 150 valodās, un informācija par šīm atbalstītajām valodām ir pieejama jaunajā LanguageLocale entītijā.

Papildinformācija: LanguageLocale entītija.

Izmantojot darbību CreateKnowledgeArticleTranslationAction (Tīmekļa API) vai CreateKnowledgeArticleTranslationRequest (organizācijas servisu), tiek izveidots jauns zināšanu bāzes raksta ieraksts ar virsrakstu, saturu, aprakstu un atslēgvārdiem, kas tiek kopēti no avota ieraksta uz jauno ierakstu, un jaunā ieraksta, kas norādīts pieprasījumā, valoda. Jānorāda arī, vai jaunais ieraksts būs galvenā vai papildu versija. Jaunais ieraksts izmanto KnowledgeArticle. ParentArticleContentId atribūtu, lai uzturētu saistību ar galveno zināšanu bāzes raksta ierakstu.

Pēc šī ziņojuma izpildīšanas un atbildes saņemšanas, izgūstiet zināšanu bāzes raksta ierakstu no atbildes objekta un pēc tam atjauniniet nosaukumu, saturu, aprakstu un atslēgvārdus, lai pievienotu tulkoto saturu.

Tālāk norādītajā koda paraugā parādīts, kā izveidot zināšanu bāzes raksta tulkojumu, izmantojot 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));

Piezīmes

Primārās atslēgas GUID vērtība (LanguageLocaleId), katram valodas ierakstam LanguageLocale entītijā, ir vienāda visās Dynamics 365 Customer Service organizācijās.

Zināšanu bāzes raksta dzīves cikls: zināšanu bāzes raksta statusa maiņa

Dzīves cikla laikā zināšanu bāzes raksts var būt šādos stāvokļos:

  • 0: melnraksts (pēc zināšanu bāzes raksta izveides)

  • 1: apstiprināts (pēc zināšanu bāzes raksta apstiprināšanas)

  • 2: ieplānots (pēc zināšanu bāzes raksta ieplānotas publicēšanas)

  • 3: publicēts (pēc zināšanu bāzes raksta publicēšanas)

  • 4: termiņš beidzies (pēc zināšanu bāzes raksta derīguma termiņa beigām, kas norādīts publicēšanas laikā)

  • 5: arhivēts (pēc zināšanu bāzes raksta arhivēšanas)

  • 6: atmests (pēc zināšanu bāzes raksta atmešanas)

Lai mainītu raksta stāvokli, izmantojiet ziņojumu Update zināšanu bāzes raksta ierakstā, lai atjauninātu KnowledgeArticle.StateCode atribūtu. Iepriekšējās saistīšanas tipiem izmantojiet KnowledgeArticleState uzskaitījumu, lai iestatītu iespējamos stāvokļus. Papildinformācija: Specializētu operāciju veikšana, izmantojot atjaunināšanu.

Tālāk norādītajā koda paraugā parādīts, kā publicēt zināšanu bāzes raksta ierakstu.

// 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);

Zināšanu bāzes raksta ieraksta saistīšana ar Dynamics 365 Customer Service entītijas instanci

Iespējojot iegulto zināšanu meklēšanu entītijai, risinājumā Dynamics 365 Customer Service, izmantojot tīmekļa klientu, relāciju daudzi pret daudziem, msdyn_<Entītijas nosaukums>_knowledgearticle, tiek automātiski izveidots. Šo relāciju var izmantot, lai programmiski saistītu KnowledgeArticle instanci ar Dynamics 365 Customer Service entītijas instanci. Saistot KnowledgeArticle instanci ar entītijas instanci, relāciju ieraksts tiek izveidots šķērsentītijā ar nosaukumu msdyn_<Entītijas nosaukums>_knowledgearticle. Piemēram, kad KnowledgeArticle instanci pirmo reizi saistāt ar Account instanci, tiek izveidota šķērsentītija ar nosaukumu msdyn_account_knowledgearticle un šajā šķērsentītijā tiek izveidots ieraksts ar saistības kartējumu. Pēc noklusējuma, Incident (Pieteikums) entītija ir iespējota iegulto zināšanu meklēšanai, un, kad saistāt KnowledgeArticle ierakstu ar Incident ierakstu, tiek izveidots saistības ieraksts KnowledgeArticleIncident šķērsentītijā.

Tālāk norādītajā koda paraugā parādīts, kā saistīt KnowledgeArticle instanci ar Account instanci:

// 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);

Palielināt zināšanu bāzes raksta skatījumu skaitu

Izmantojiet IncrementKnowledgeArticleViewCountRequest ziņojumu, lai palielinātu zināšanu bāzes raksta ieraksta skatījumu skaitu noteiktai dienai KnowledgeArticleViews entītijā. Ja zināšanu bāzes rakstam nav ieraksta par noteiktu dienu, tas izveidos ierakstu un pēc tam iestatīs norādīto skatījumu skaita vērtību atribūtā KnowledgeArticleViews. KnowledgeArticleView atribūts. Ja noteiktai dienai ir izveidots zināšanu bāzes raksta ieraksts, tas tikai palielinās skatījumu skaitu atribūtā KnowledgeArticleViews. KnowledgeArticleView atribūts esošajam ierakstam.

Meklēt zināšanu bāzes rakstus, izmantojot pilnteksta meklēšanu

Zināšanu bāzes raksti risinājumā Dynamics 365 Customer Service, tostarp to versijas un tulkojumi, ir pilnteksta indeksā un atbalsta SQL Server pilnteksta meklēšanu. Lai iegūtu papildinformāciju par pilnteksta meklēšanu, skatiet SQL Server: pilnteksta meklēšana.

Izmantojiet FullTextSearchKnowledgeArticleRequest ziņojumu, lai meklētu zināšanu bāzes rakstu savās lietojumprogrammās un atrastu meklējamo informāciju. Ziņojums FullTextSearchKnowledgeArticleRequest ļauj izmantot lēcienveida cilmes atbilstību (ļauj meklējamajam tekstam aizstāt citu sasprindzinājumu vai lēcienu) un norādīt vaicājuma kritērijus (izmantojot FetchXML vai QueryExpression, lai norādītu filtrēšanu, kārtošanu, kārtošanu un peidžerošanu), lai atrastu zināšanu bāzes rakstus ar norādīto tekstu. Meklēšanas rezultātos var arī noņemt vairākas to pašu rakstu versijas un, meklējot tekstu, filtrēt zināšanu bāzes raksta stāvokli.

Novecojušas zināšanu entītijas

Ir novecojušas tālāk norādītās mantotās entītijas. Papildinformācija: Novecojušas zināšanu entītijas

Mantotās zināšanu entītijas nav pieejamas no 2020. gada 1. decembra. Ir ieteicams pāriet uz KnowledgeArticle entītiju. Papildinformāciju par zināšanu bāzes raksta izveidi programmā vienotais interfeiss skatiet rakstā Zināšanu bāzes rakstu izveide un pārvaldība.  

Lai saņemtu palīdzību saistībā ar migrāciju, izmantojiet tālāk minētos norādījumus:

  • Izmantojiet SDK, WebAPI Microsoft Power Automatevai atkarībā no jūsu scenārijiem.
  • Izmantojiet atklātā pirmkoda migrācijas rīku ar MIT licenci.

Svarīgi

  • Microsoft neatbalsta atklātā pirmkoda migrācijas rīku, un, iespējams, tas būs jāmodificē, lai atbilstu jūsu scenārijiem.
  • Pirms izmantošanas ražošanā vienmēr palaidiet testa vidi.
  • Pirms rīka lietošanas pārbaudiet licenci un Lasi_mani.

Skatiet arī