Jagamisviis:

Teadmusartiklitega töötamine

  • Artikkel

Märkus.

Teave funktsioonide saadavuse kohta on järgmine.

Dynamics 365 kontaktikeskus—manustatud Dynamics 365 kontaktikeskus – eraldiseisev Dynamics 365 Customer Service
No Ja Ja

Uus teadmuskogemus võimaldab teil luua rikkalikke teadmusartikleid koos versioonimise ja tõlketoega. Uus teadmiste kogemus kasutab olemit KnowledgeArticle teadmiste talletamiseks ja haldamiseks kohalikult Dynamics 365 Customer Service'is.

Märkus.

Olemid KBArticle, KBArticleTemplate ja KBArticleComment on nüüd iganenud. See tähendab, et me ei soovi, et te neid olemeid enam kasutaksite. Peate kasutama uuemat olemit KnowledgeArticle teadmistehalduseks rakenduses Dynamics 365 Customer Service. Lisateavet leiate jaotisest Iganenud teadmiste olemid selle teema lõpus.

Teabebaasi artikli loomine

Teadmusartikli kirje loomisel loob Dynamics 365 Customer Service sisemiselt juurartikli selle kirje jaoks. Juurartikkel toimib teie loodud peamise teadmusartikli konteinerina, koos kõigi artikli versioonide ja tõlgetega, mida võite luua hiljem. Järgmisel diagrammil on kujutatud olemi KnowledgeArticle olemi mudelit.

Olemi mudel KnowledgeArticle.

Teadmusartikli kirje loomisel luuakse see olekus Draft. Uue olemi KnowledgeArticle kasutamisel saate luua artikli, määrates selle sisu ja vormingu HTML-vormingus. Saate määrata oma väärtuse atribuudile KnowledgeArticle. ArticlePublicNumber luues samal ajal teadmusartikli kirje programmiliselt, vastasel juhul genereeritakse väärtus automaatselt vastavalt veebikliendi Dynamics 365 Customer Service sätete alas määratud vormingule. KnowledgeArticle. ArticlePublicNumber talletab klientidele, partneritele ja muudele välistele kasutajatele nähtava ID, mille abil saab viidata ja otsida teadmusartikleid ning mis jääb samaks teadmusartikli kõigis versioonides ja tõlgetes.

Järgmine näidiskood näitab, kuidas saate luua teadmusartikli kirje.

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

Teadmusartiklite põhi- ja vaheversioonide loomine

Teadusartikli kirje loomisel seatakse põhiversiooni väärtuseks automaatselt 1 ja vaheversiooni väärtuseks 0. Kasutage CreateKnowledgeArticleVersion sõnumit (CreateKnowledgeArticleVersion Action või CreateKnowledgeArticleVersionRequest) et luua teadmusartikli põhi- või vaheversiooni. Põhiversiooni loomiseks määrake taotluse sõnumis suvandi IsMajor väärtuseks true, vaheversiooni loomiseks määrake väärtuseks false. Uue loodud versiooni kirje kasutab järgmist.

  • KnowledgeArticle. RootArticleId atribuut juurteadmusartikli kirjega seose säilitamiseks.

  • KnowledgeArticle. PreviousArticleContentId atribuut kirje eelmisele versioonile viitamiseks.

Järgmine näidiskood näitab, kuidas saate luua teadmusartikli kirje põhiversiooni üksuse CreateKnowledgeArticleVersionRequest abil.

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

Teadmusartikli tõlke loomine

Kasutage CreateKnowledgeArticleTranslation Action (veebi API) või CreateKnowledgeArticleTranslationRequest (organisatsiooni teenus), et luua teadmusartikli kirje tõlge. Saate tõlkida oma teadmusartiklit üle 150 keelde ning teavet nende toetatud keelte kohta leiate uuest olemist LanguageLocale.

Lisateave: LanguageLocale’i olem.

Üksuste CreateKnowledgeArticleTranslation Action (Veebi API) või CreateKnowledgeArticleTranslationRequest (organisatsiooni teenus) abil luuakse uus teadmusartikli kirje, mille pealkiri, sisu, kirjeldus ja märksõnad kopeeritakse lähtekirjest uude kirjesse ja uue kirje keeleks määratakse see, mille määrasite taotluses. Samuti peate määrama, kas uus kirje on põhi- või vaheversioon. Uus kirje kasutab KnowledgeArticle. ParentArticleContentId atribuut peamise teadmusartikli kirjega seose säilitamiseks.

Kui käivitate selle sõnumi ja saate vastuse, tooge teadmusartikli kirje vastuse objektist ja seejärel värskendage pealkirja, sisu, kirjeldust ja märksõnu tõlgitud sisu lisamiseks.

Järgmine näidiskood näitab, kuidas saate luua teadmusartikli tõlget üksuse CreateKnowledgeArticleTranslationRequest abil.

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

Märkus.

Iga keele kirje peamise võtme (LanguageLocaleId) GUID-väärtus olemis LanguageLocale on kõigis Dynamics 365 Customer Service'i organisatsioonides ühesugune.

Teadmusartikli elutsükkel: teadmusartikli oleku muutmine

Teadmusartikkel võib oma elutsükli jooksul olla järgmistes olekutes.

  • 0: mustand (pärast teadmusartikli loomist)

  • 1: kinnitatud (pärast teadmusartikli kinnitamist)

  • 2: ajastatud (pärast teadmusartikli avaldamise kavandamist)

  • 3: avaldatud (pärast teadmusartikli avaldamist)

  • 4: aegunud (pärast teadmiste artikkel aegumist, vastavalt avaldamisel määratud aegumiskuupäevale)

  • 5: arhiivitud (pärast teadmusartikli arhiivimist)

  • 6: hüljatud (pärast teadmusartikli hülgamist)

Artikli oleku muutmiseks kasutage sõnumit Update teadmusartikli kirjes selle atribuudi KnowledgeArticle.StateCode värskendamiseks. Varajaste sidumise tüüpide puhul kasutage loendust KnowledgeArticleState võimalike olekute seadmiseks. Lisateave. Spetsiaalsete toimingute tegemine suvandi Värskendamine abil.

Järgmine näidiskood näitab, kuidas avaldada teadmusartikli kirjet.

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

Teadmusartikli kirje seostamine Dynamics 365 Customer Service'i olemi eksemplariga

Kui lubate manustatud teadmiste otsingu olemi jaoks, kasutades Dynamics 365 Customer Service'i veebiklienti, luuakse automaatselt mitu-mitmele-vastavus msdyn_<Entity_Name>_knowledgearticle. Selle seose abil saate programmiliselt seostada või linkida eksemplari KnowledgeArticle Dynamics 365 Customer Service'i olemi eksemplariga. Kui seostate eksemplari KnowledgeArticle olemi eksemplariga, luuakse seose jaoks kirje lõikuvas olemis, mida nimetatakse järgnevalt msdyn_<Entity_Name>_knowledgearticle. Näiteks juhul, kui seostate esmakordselt eksemplari KnowledgeArticle eksemplariga Account, luuakse lõikuv olem msdyn_account_knowledgearticle ja selles lõikuvas olemis luuakse seose vastendusega kirje. Vaikimisi on olem Incident (teenindusjuhtum) lubatud manustatud teadmiste otsingu jaoks ja kui lingite kirje KnowledgeArticle kirjega Incident, luuakse lõikuvas olemis KnowledgeArticleIncident seose kirje.

Järgmine näidiskood näitab, kuidas seostada eksemplari KnowledgeArticle eksemplariga 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);

Teadmusartikli vaatamiste arvu suurendamine

Sõnumi IncrementKnowledgeArticleViewCountRequest abil saate suurendada teadmusartikli kirje vaatamiste arvu teatud päeva kohta olemis KnowledgeArticleViews. Kui määratud päeval puudub teadmusartikli kirje, loob see kirje ja seejärel määrab täpsustatud vaatamiste arvu väärtuse üksuses KnowledgeArticleViews. KnowledgeArticleView atribuut. Kui määratud päeval on teadmusartikli kirje juba olemas, suurendab see ainult vaatamiste arvu olemasoleval atribuudil KnowledgeArticleViews. KnowledgeArticleView olemasoleva kirje atribuut.

Teadmusartiklite otsimine täisteksti otsingu abil

Dynamics 365 Customer Service'i teadmusartiklid, sh nende versioonid ja tõlked, on indekseeritud täistekstiga ja toetavad SQL-serveri täisteksti otsingut. Lisateabe saamiseks täisteksti otsingu kohta, vaadake teemat SQL Server: täisteksti otsing.

Kasutage sõnumit FullTextSearchKnowledgeArticleRequest teadmusartikli otsimiseks oma rakendusest, et leida otsitavat teavet. Sõnum FullTextSearchKnowledgeArticleRequest võimaldab teil kasutada käändelise tüve vastendamist (võimaldab otsinguteksti asendada erineva pinge või käändelõpuga) ja määrata päringukriteeriume (kasutades või QueryExpressioni abil FetchXML filtreerimise, järjestamise, sortimise ja otsingu määramiseks), et leida määratud tekstiga teadmusartikleid. Soovi korral saate ka eemaldada samade artiklite mitut versiooni ja filtreerida teadmusartikli olekut teksti otsimisel.

Iganenud teadmiste olemid

Järgmised pärandolemid on aegunud. Lisateave: Kasutuselt kõrvaldatud teadmusolemid

Pärand teadmusoleid ei ole alates 1. detsembrist 2020 juurdepääsetavad. Soovitame tungivalt minna üle olemile KnowledgeArticle. Lisateavet Unified Interface teadmusartikli loomise kohta leiate teemast Teadmusartiklite loomine ja haldamine.  

Migreerimisel saate abi järgmisest.

  • Kasutage SDK-d, WebAPI-t või Microsoft Power Automate'i olenevalt oma stsenaariumidest.
  • Kasutage avatud lähtekoodiga migreerimistööriista MIT-litsents.

Oluline

  • Microsoft ei toeta avatud lähtekoodiga migreerimistööriista ja selle muutmine võib olla vajalik, et see vastaks teie stsenaariumidele.
  • Käitage alati tootmiskeskkonnas, enne töökeskkonda üleminekut.
  • Kontrollige enne tööriista kasutamist litsentsi ja seletusfaili.

Vt ka