Darbas su informaciniais straipsniais
Pastaba.
Funkcijos pasiekiamumo informacija yra tokia.
| "Dynamics 365 kontaktų centras" – įdėtoji | "Dynamics 365 kontaktų centras" – atskiras | Dynamics 365 Customer Service |
|---|---|---|
| No | Taip | Taip |
Nauja žinių patirtis leidžia kurti išsamius informacinius straipsnius kartu su versijų kūrimo ir vertimo palaikymu. Naujos žinių funkcijos naudoja objektą KnowledgeArticle žinių saugojimui ir valdymui pačioje programoje „Dynamics 365 Customer Service”.
Pastaba.
Objektai KBArticle, KBArticleTemplate ir KBArticleComment dabar nebenaudojami. Tai reiškia, kad nerekomenduojame naudoti šių objektų. Turite naudoti naujesnį objektą KnowledgeArticle, norėdami „Dynamics 365 Customer Service“ naudoti žinių valdymo funkciją. Daugiau informacijos žr. šios temos pabaigoje esančiame skyriuje Nebenaudojami žinių objektai.
Sukurkite informacinį straipsnį
Kai kuriate informacinio straipsnio įrašą, „Dynamics 365 Customer Service” viduje sukuria šakninį įrašo straipsnį. Šakninis straipsnis veikia kaip jūsų sukurto pagrindinio informacinio straipsnio ir visų straipsnių versijų bei vertimų, kuriuos galėsite sukurti ateityje, talpyklė. Toliau pateiktoje diagramoje vaizduojamas objekto KnowledgeArticle objekto modelis.
Sukūrus informacinio straipsnio įrašą, jo būsena yra Draft. Naudodami naują objektą KnowledgeArticle, galite sukurti straipsnį nurodydami jo turinį ir formatavimą HTML formatu. Galite nurodyti savo reikšmę KnowledgeArticle.
ArticlePublicNumber atributas programiškai kuriant informacinio straipsnio įrašą; kitu atveju reikšmė automatiškai generuojama pagal formatą, kurį nurodėte „Dynamics 365 Customer Service” žiniatinklio kliento parametrų srityje. KnowledgeArticle.
ArticlePublicNumber atributas saugo klientams, partneriams ir kitiems išoriniams vartotojams rodomą ID, skirtą informaciniams straipsniams nurodyti ir ieškoti, ir išlieka nepakitęs informacinių straipsnių versijose bei vertimuose.
Tolesnis kodo pavyzdys rodo, kaip galite sukurti informacinio straipsnio įrašą.
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);
Informacinio straipsnio pagrindinių ir papildomų versijų kūrimas
Sukūrus informacinio straipsnio įrašą, pagrindinė versija automatiškai nustatoma į 1, o papildoma versija į 0. Naudokite CreateKnowledgeArticleVersion pranešimą (Veiksmą „CreateKnowledgeArticleVersion“ arba CreateKnowledgeArticleVersionRequest) norėdami sukurti pagrindinę arba papildomą informacinio straipsnio versiją. Užklausos pranešime nustatykite reikšmę IsMajor į true, kad sukurtumėte pagrindinę versiją; nustatykite reikšmę į false, kad sukurtumėte papildomą versiją. Sukurtas naujas versijos įrašas naudoja toliau pateiktus atributus.
KnowledgeArticle.RootArticleIdatributas, skirtas palaikyti sąsaja su šakniniu įrašo informaciniu straipsniu.KnowledgeArticle.PreviousArticleContentIdatributas, skirtas nurodyti ankstesnę įrašo versiją.
Tolesnis kodo pavyzdys rodo, kaip galite sukurti informacinio straipsnio įrašo pagrindinę versiją naudodami CreateKnowledgeArticleVersionRequest.
CreateKnowledgeArticleVersionRequest versionRequest = new CreateKnowledgeArticleVersionRequest
{
Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),
IsMajor = true
};
CreateKnowledgeArticleVersionResponse versionResponse = (CreateKnowledgeArticleVersionResponse)_serviceProxy.Execute(versionRequest);
Informacinio straipsnio vertimo kūrimas
Naudokite Veiksmą „CreateKnowledgeArticleTranslation“ (Žiniatinklio API) arba CreateKnowledgeArticleTranslationRequest (organizacijos paslaugas), kad sukurtumėte informacinio straipsnio įrašo vertimą. Galite išversti jūsų informacinį straipsnį į daugiau nei 150 kalbų, o informacija apie šias palaikomas kalbas pasiekiama naujame objekte LanguageLocale.
Daugiau informacijos: Objektas LanguageLocale.
Naudojant Veiksmą „CreateKnowledgeArticleTranslation“ (žiniatinklio API) arba CreateKnowledgeArticleTranslationRequest (organizacijos paslauga) sukuriamas naujas informacinio straipsnio įrašas su pavadinimu, turiniu, aprašymu ir raktažodžiais, nukopijuotais iš šaltinio įrašo į naują įrašą, ir naujo įrašo kalba, nustatyta į nurodytą užklausoje. Taip pat turėsite nurodyti, ar naujas įrašas bus pagrindinės, ar papildomos versijos. Naujas įrašas naudoja atributą KnowledgeArticle.
ParentArticleContentId atributas, kad būtų palaikoma sąsaja su pirminiu įrašo informaciniu straipsniu.
Atlikę šį pranešimą ir gavę atsaką, nuskaitykite informacinio straipsnio įrašą iš atsako objekto, tada atnaujinkite pavadinimą, turinį, aprašą ir raktažodžius, kad įtrauktumėte išverstą turinį.
Tolesnis kodo pavyzdys rodo, kaip kurti informacinio straipsnio vertimą naudojant 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));
Pastaba.
Kiekvieno kalbos įrašo objekte LanguageLocale pirminio rakto (LanguageLocaleId) GUID reikšmė yra ta pati visose „Dynamics 365 Customer Service” organizacijose.
Informacinio straipsnio ciklas: informacinio straipsnio būsenos keitimas
Informacinis straipsnis jo ciklo metu gali būti toliau nurodytų būsenų.
0: Juodraštis (sukūrus informacinį straipsnį)
1: Patvirtinta (patvirtinus informacinį straipsnį)
2: Suplanuota (suplanavus publikuoti informacinį straipsnį)
3: Publikuota (publikavus informacinį straipsnį)
4: Nebegalioja (pasibaigus informacinio straipsnio galiojimo laikui, kuris nurodomas publikuojant)
5: Suarchyvuota (archyvavus informacinį straipsnį)
6: Atsisakyta (atsisakius informacinio straipsnio)
Norėdami pakeisti straipsnio būseną ir atnaujinti atributą KnowledgeArticle.StateCode, naudokite informacinio straipsnio įrašo pranešimą Update. Jei naudojate ankstesnius susiejimo tipus, naudokite išvardijimą KnowledgeArticleState, kad nustatytumėte galimas būsenas. Daugiau informacijos žr. Specializuotų operacijų atlikimas naudojant Update.
Tolesnis kodo pavyzdys rodo, kaip publikuoti informacinio straipsnio įrašą.
// 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);
Informacinio straipsnio įrašo susiejimas su „Dynamics 365 Customer Service” objekto egzemplioriumi
Kai įjungiate įtaisytąją „Dynamics 365 Customer Service” objekto žinių iešką naudodami žiniatinklio klientą, automatiškai sukuriamas ryšys „daug su daugeliu“ msdyn_<Entity_Name>_knowledgearticle. Galite naudoti šį ryšį programiškai susieti egzempliorių KnowledgeArticle su „Dynamics 365 Customer Service” objekto egzemplioriumi. Kai susiejate egzempliorių KnowledgeArticle su objekto egzemplioriumi, susikertančiame objekte sukuriamas ryšio įrašas pavadinimu msdyn_<Entity_Name>_knowledgearticle. Pavyzdžiui, kai pirmą kartą egzempliorių KnowledgeArticle susiejate su egzemplioriumi Account, sukuriamas susikertantis objektas pavadinimu msdyn_account_knowledgearticle, o šiame susikertančiame objekte sukuriamas įrašas su asociacijos susiejimu. Pagal numatytuosius nustatymus objektas Incident (atvejo) įjungiamas įdėtajai žinių ieškai ir, kai įrašą KnowledgeArticle susiejate su įrašu Incident, susikertančiame objekte KnowledgeArticleIncident sukuriamas susiejimo įrašas.
Tolesnis kodo pavyzdys rodo, kaip susieti egzempliorių KnowledgeArticle su egzemplioriumi 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);
Informacinio straipsnio peržiūrų skaičiaus padidinimas
Naudokite pranešimą IncrementKnowledgeArticleViewCountRequest norėdami padidinti tam tikros dienos informacinio straipsnio įrašo peržiūrų skaičių objekte KnowledgeArticleViews. Jei nurodytos dienos informacinio straipsnio įrašo nėra, įrašas bus sukurtas, o paskui nurodyta peržiūrų skaičiaus reikšmė bus nustatyta KnowledgeArticleViews.
KnowledgeArticleView atributas. Jei yra nurodytos dienos informacinio straipsnio įrašas, bus tik padidintas peržiūrų skaičius esamo įrašo atribute KnowledgeArticleViews.
KnowledgeArticleView esamo įrašo atributas.
Informacinių straipsnių ieška naudojant viso teksto iešką
„Dynamics 365 Customer Service” informaciniuose straipsniuose, įskaitant jų versijas ir vertimus, yra viso teksto indeksavimas ir „SQL Server” viso teksto ieškos palaikymas. Daugiau informacijos apie viso teksto iešką žr. „SQL Server”: viso teksto ieška.
Naudokite pranešimą FullTextSearchKnowledgeArticleRequest, kad ieškotumėte informacinio straipsnio jūsų programose ir rastumėte ieškomą informaciją. Pranešimas FullTextSearchKnowledgeArticleRequest leidžia naudoti vingio kamieno atitikimą (leidžia ieškos tekstui pakeisti skirtingą įtampą arba vingį) ir nurodyti užklausos kriterijus (naudojant FetchXML arba QueryExpression filtravimui, tvarkai, rūšiavimui ir puslapių paieškai nurodyti), kad rastumėte informacinius straipsnius su nurodytu tekstu. Taip pat galite pašalinti kelias tų pačių straipsnių versijas ieškos rezultatuose ir filtruoti pagal informacinio straipsnio būseną ieškodami teksto.
Nebenaudojami žinių objektai
Nerekomenduojami toliau nurodyti pasenę objektai. Daugiau informacijos: Nebenaudojami žinių objektai
Pasenę žinių bazės objektai nepasiekiami nuo 2020 m. gruodžio 1 d. Primygtinai rekomenduojame pereiti prie objekto KnowledgeArticle. Daugiau informacijos apie informacinio straipsnio kūrimą naudojant vieningoji sąsaja ieškokite Informacinių straipsnių kūrimas ir tvarkymas.
Norėdami gauti pagalbos, susijusios su perkėlimu, atlikite tolesnius veiksmus.
- Naudokite SDK, „WebAPI“ arba „Microsoft Power Automate“, priklausomai nuo savo situacijos.
- Naudokite atvirojo kodo perkėlimo įrankį su MIT licencija.
Svarbu
- „Microsoft” nepalaiko atvirojo kodo perkėlimo įrankio ir gali reikėti modifikuoti atsižvelgiant į jūsų scenarijus.
- Visada paleiskite bandomąją aplinką prieš naudodami gamyboje.
- Prieš naudodami įrankį, patikrinkite licenciją ir failą „Readme“.