Tietoartikkeleiden käsitteleminen
Dynamics 365 Customer Servicen uusi tietämyskokemus mahdollistaa monipuolisten tietoartikkeleiden luomisen, niiden versioiden luomisen sekä käännöstuen. Uusi tietämyskokemus käyttää KnowledgeArticle-entiteettiä tietämyksen tallentamisessa ja hallinnassa Dynamics 365 Customer Servicessa.
Muistiinpano
Entiteetit KBArticle, KBArticleTemplate ja KBArticleComment ovat nyt vanhentuneita. Tämä tarkoittaa sitä, että näitä entiteettejä ei enää tulisi käyttää. Käytä uusinta entiteettiä KnowledgeArticle Dynamics 365 Customer Servicen tietämyksenhallinnassa. Lisätietoja on tämän ohjeaiheen Vanhentuneet tietämysentiteetit -kohdassa.
Tietoartikkelin luominen
Kun luot tietoartikkelitietueen, Dynamics 365 Customer Service luo tietueelle sisäisesti pääartikkelin. Pääartikkeli toimii luodun ensisijaisen tietoartikkelin ja artikkelin tulevaisuudessa luotavien kaikkien versioiden ja käännösten säilönä. Seuraavassa kaaviossa esitetään entiteetin KnowledgeArticle entiteettimalli.
Kun luot tietoartikkelitietueen, se luodaan tilassa Draft. Kun käytössä on uusi entiteetti KnowledgeArticle, voit luoda artikkelin määrittämällä sen sisällön ja muotoilun HTML-muodossa. Voit määrittää oman arvon määritteelle KnowledgeArticle.
ArticlePublicNumber-määrite samalla, kun tietoartikkelitietue luodaan ohjelmallisesti. Muussa tapauksessa arvo luodaan automaattisesti WWW-asiakasohjelmassa Dynamics 365 Customer Service -asetusalueella määritetyn muodon perusteella. KnowledgeArticle.
ArticlePublicNumber-määrite tallennetaan asiakkaille, kumppaneille ja muille ulkoisille käyttäjille näytettävä tunnus. Sen avulla he voivat tunnistaa ja etsiä tietoartikkeleita. Tunnus on sama eri tietoartikkeliversioissa ja niiden käännöksissä.
Seuraava mallikoodi näyttää, miten voit luoda tietoartikkelitietueen.
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);
Tietoartikkelin pää- ja aliversioiden luominen
Kun luot tietoartikkelitietueen, pääversion numero on automaattisesti aina 1 ja aliversion numero 0. Luo tietoartikkelin pää- ja aliversio CreateKnowledgeArticleVersion-sanoman (CreateKnowledgeArticleVersion Action tai CreateKnowledgeArticleVersionRequest) avulla. Anna pyyntösanomassa kohdan IsMajor arvoksi true, jos haluat luoda pääversion. Jos haluat luoda aliversion, anna arvoksi false. Uusi luotu versiotietue käyttää seuraavia:
KnowledgeArticle.RootArticleId-määrite ylläpitämään päätietoartikkelitietueen liitosta.KnowledgeArticle.PreviousArticleContentId-määrite osoittamaan tietueen edelliseen versioon.
Seuraavassa mallikoodissa näytetään, miten tietoartikkelitietueen pääversio luodaan käyttämällä kohdetta CreateKnowledgeArticleVersionRequest.
CreateKnowledgeArticleVersionRequest versionRequest = new CreateKnowledgeArticleVersionRequest
{
Source = new EntityReference(KnowledgeArticle.EntityLogicalName, knowledgeArticleId),
IsMajor = true
};
CreateKnowledgeArticleVersionResponse versionResponse = (CreateKnowledgeArticleVersionResponse)_serviceProxy.Execute(versionRequest);
Tietoartikkelin käännöksen luominen
Luo tietoartikkelitietueen käännös käyttämällä kohdetta CreateKnowledgeArticleTranslation Action (verkko-ohjelmointirajapinta) tai CreateKnowledgeArticleTranslationRequest (organisaation palvelu). Voit kääntää tietoartikkelin yli 150 kielelle. Tietoja näistä tuetuista kielistä on uudessa entiteetissä LanguageLocale.
Lisätietoja: LanguageLocale-entiteetti.
Kun käytössä on CreateKnowledgeArticleTranslation Action (verkko-ohjelmointirajapinta) tai CreateKnowledgeArticleTranslationRequest (organisaation palvelu), luodaan uusi tietoartikkelitietue. Se sisältää otsikon, sisällön, kuvauksen ja avainsanat, jotka on kopioitu lähdetietueesta uuteen tietueeseen, sekä pyynnössä määritetyn uuden tietuejoukon kielen. Sinun täytyy myös määrittää, onko uusi tietue pää- vai aliversio. Uusi tietue käyttää KnowledgeArticle-määritettä.
ParentArticleContentId-määrite ylläpitämään ensisijaisen tietoartikkelitietueen liitosta.
Kun olet suorittanut tämän sanoman ja saanut vastauksen, nouda tietoartikkelitietue palauteobjektista ja päivitä sitten otsikko, sisältö, kuvaus ja avainsanat käännetyn sisällön lisäämistä varten.
Seuraavassa mallikoodissa näytetään, miten tietoartikkelin käännös luodaan käyttämällä kohdetta 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));
Muistiinpano
Ensisijaisen avaimen (LanguageLocaleId) GUID-arvo kullekin kielitietueelle entiteetissä LanguageLocale on sama kaikissa Dynamics 365 Customer Service -organisaatioissa.
Tietoartikkelin elinkaari: Tietoartikkelin tilan muuttaminen
Tietoartikkelilla voi olla elinkaarensa aikana seuraavat tilat:
0: Luonnos (kun tietoartikkeli on luotu)
1: Hyväksytty (kun tietoartikkeli on hyväksytty)
2: Ajoitettu: (sen jälkeen, kun tietoartikkeli on ajoitettu julkaisemista varten)
3: Julkaistu (kun tietoartikkeli on julkaistu)
4: Vanhentunut (kun tietoartikkeli on vanhentunut julkaistaessa määritetyn vanhentumispäivämäärän mukaan)
5: Arkistoitu (kun tietoartikkeli on arkistoitu)
6: Hylätty (kun tietoartikkeli on hylätty)
Jos haluat muuttaa artikkelin tilan, päivitä määrite KnowledgeArticle.StateCode käyttämällä tietoartikkelin sanomaa Update. Käytä aikaisille sidottu-tyypeille enumerointia KnowledgeArticleState ja määritä mahdolliset tilat. Lisätietoja: Erityisten toimintojen suorittaminen päivityksen avulla.
Seuraava mallikoodi näyttää, miten voit tietoartikkelitietue julkaistaan.
// 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);
Tietoartikkelitietueen liittäminen Dynamics 365 Customer Servicen entiteettiesiintymään
Kun Dynamics 365 Customer Servicen entiteetin upotettu tietämyshaku, jossa on käytössä WWW-asiakasohjelma, monta moneen -suhde, msdyn_<Entity_Name>_knowledgearticle luodaan automaattisesti. Voit käyttää tätä suhdetta, kun liität ohjelmallisesti esiintymän KnowledgeArticle Dynamics 365 Customer Servicen entiteettiesiintymään tai linkität esiintymät toisiinsa. Kun liität esiintymän KnowledgeArticle entiteettiesiintymään, suhdetietue luodaan leikkaava entiteetti nimeltä msdyn_<Entity_Name>_knowledgearticle. Kun liität esiintymän KnowledgeArticle ensimmäisen kerran esiintymään Account, luodaan leikkaava entiteetti msdyn_account_knowledgearticle ja tietue, jolla on liittyvä yhdistämismääritys tässä leikkaavassa entiteetissä. Oletusarvoisesti entiteetti Incident (palvelupyyntö) on käytössä upotetussa tietämyshaussa. Kun linkität tietueen KnowledgeArticle tietueeseen Incident, leikkaavassa entiteetissä KnowledgeArticleIncident luodaan liitostietue.
Seuraavassa näytekoodissa näytetään, miten esiintymä KnowledgeArticle liitetään esiintymään 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);
Tietoartikkelinäkymän määrän suurentaminen
Käytä sanomaa IncrementKnowledgeArticleViewCountRequest suurentaessasi tietoartikkelitietueen näkymän määrää annettuna päivänä entiteetissä KnowledgeArticleViews. Jos tietoartikkeli ei sisällä tietuetta tietyltä päivältä, se luo tietueen ja määrittää tietyn näkymien määrän arvon KnowledgeArticleViews-määritteessä.
KnowledgeArticleView-määrite. Jos tietyn päivän tietue on jo tietoartikkelissa, näkymien määrää vain suurennetaan KnowledgeArticleViews-määritteessä.
KnowledgeArticleView-määrite olemassa olevassa tietueessa.
Tietoartikkelien hakeminen tekstihaun avulla
Dynamics 365 Customer Servicen tietoartikkelit ja niiden versiot ja käännökset indeksoidaan tekstihakua varten. Niillä on SQL Serverin tekstihaun tuki. Lisätietoja tekstihausta on artikkelissa SQL Server: Tekstihaku.
Käytä sanomaa FullTextSearchKnowledgeArticleRequest, jos haluat hakea sovelluksista etsimäsi tiedot sisältävää tietoartikkelia. Sanoman FullTextSearchKnowledgeArticleRequest avulla voit käyttää taivutusvartalon täsmäytystä (mahdollistaa eri aikamuotojen ja taivutusmuotojen korvaamisen hakutekstissä) ja määrittää kyselyehdot (käyttämällä FetchXML:ää tai QueryExpressionia suodattamisen, järjestämisen, lajittelun ja sivutuksen määrittämisessä), kun etsit tietoartikkeleita määritetystä tekstistä. Voit myös poistaa saman artikkelin kaksoiskappaleet hakutuloksista ja suodattaa tietoartikkelin tilan mukaan tekstin haun aikana.
Vanhentuneet tietämysentiteetit
Seuraavat vanhat entiteetit ovat vanhentuneet. Lisätietoja: Vanhentuneet tietoentiteetit
Vanhoja tietoentiteettejä ei voi käyttää 1.12.2020 alkaen. Suosittelemme vahvasti KnowledgeArticle-entiteettiin siirtymistä. Lisätietoja tietoartikkelin luomisesta Unified Interfacessa on kohdassa Tietoartikkeleiden luominen ja hallinta.
Seuraavia tietoja voi käyttää siirrossa:
- Käytä SDK:ta, WebAPIa tai Microsoft Power Automatea skenaarioiden mukaan.
- Käytä avoimen lähdekoodin siirtotyökalua ja MIT-käyttöoikeutta.
Tärkeä
- Microsoft ei tue avoimen lähdekoodin siirtotyökalua. Sitä on ehkä muokattava skenaarioille sopivaksi.
- Suorita testiympäristö aina ennen tuotantoympäristön käyttämistä.
- Tarkista käyttöoikeus ja Lueminut-tiedosto, ennen kuin käytät työkalua.