Työskentely KnowledgeArticle-taulukon kanssa

Koskee: Dynamics 365 Customer Service ja Dynamics 365 Contact Center – vain erillisversioina

Käytä taulukkoa KnowledgeArticle rakentaaksesi tiedonhallintaominaisuuksia Dynamics 365 Customer Service -ratkaisuihisi. Tässä artikkelissa kuvataan, miten artikkeleita luodaan, versioita ja käännöksiä hallitaan, sisältöä julkaistaan sekä tietoartikkeleita integroidaan muihin asiakaspalvelutoimijoihin.

Edellytykset

Varmista, että sinulla on vaaditut tehtävät ja etuoikeudet.

Tietoartikkelin luominen

Kun luot tietoartikkelitietueen, Dynamics 365 Customer Service luo sisäisesti pääartikkelin tietueelle. Juuriartikkeli toimii säiliönä ensimmäiselle tietoartikkelille, jonka luot, sekä kaikille tuleville esseeversioille ja käännöksille. Seuraava kaavio esittää taulukon mallin KnowledgeArticle .

Kun luot tietoartikkelitietueen, luot sen tilassa Draft. Uuden KnowledgeArticle taulukon avulla voit luoda artikkelin määrittämällä sen sisällön ja muotoilun HTML-muodossa. Voit määrittää oman arvon määritteelle KnowledgeArticle. ArticlePublicNumber Ominaisuus, kun luot tietoartikkelin tietuetta ohjelmallisesti. Muussa tapauksessa arvo generoidaan automaattisesti sen muodon perusteella, jonka määritit Dynamics 365 Customer Service -asetuksissa web-asiakkaassa. KnowledgeArticle. ArticlePublicNumber attribuutti tallentaa ID:n, joka on asiakkaille, kumppaneille ja muille ulkopuolisille käyttäjille viitatakseen ja etsiäkseen tietoartikkeleita. Se pysyy samana kaikissa tietoartikkeliversioissa ja 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ääversio asetetaan automaattisesti arvoksi 1 ja pieni versio nollaksi. Luo tietoartikkelin pää- ja aliversio CreateKnowledgeArticleVersion-sanoman (CreateKnowledgeArticleVersion-toiminto tai CreateKnowledgeArticleVersionRequest) avulla. Pyyntöviestissä aseta IsMajor luomaan true pääversio tai false luomaan pienen version. Uuden version tietue käyttää seuraavia attribuutteja:

• KnowledgeArticle. RootArticleId-määrite ylläpitämään päätietoartikkelitietueen liitosta.

• KnowledgeArticle. PreviousArticleContentId-määrite osoittamaan tietueen edelliseen versioon.

Seuraava esimerkkikoodi näyttää, miten luodaan merkittävä versio tietoartikkelitietueesta käyttämällä 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, kun käytössä on CreateKnowledgeArticleTranslation-toiminto (verkko-ohjelmointirajapinta) tai CreateKnowledgeArticleTranslationRequest (organisaation palvelu). Voit kääntää tietoartikkelisi yli 150 kielelle. Tietoa näistä tuetuista kielistä löytyy uudesta LanguageLocale taulukosta.

Lue lisää LanguageLocale-taulukosta.

Käyttämällä CreateKnowledgeArticleTranslation Actionia (Web API) tai CreateKnowledgeArticleTranslationRequest (organisaatiopalvelua) luot uuden tietoartikkelin tietueen, jossa otsikko, sisältö, kuvaus ja avainsanat kopioidaan lähdetietueesta uuteen tietueeseen. Asetat uuden tietueen kielen siksi, jonka määrittelet pyynnössä. Sinun täytyy myös määritellä, onko uusi levy duuri- vai sivuversio. 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.

Seuraava esimerkkikoodi näyttää, miten tietoartikkelin käännös tehdään käyttämällä 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));  

Tietoartikkelin elinkaari: Tietoartikkelin tilan muuttaminen

Tietoartikkelilla voi olla elinkaarensa aikana seuraavat tilat:

• 0: Luonnos (sen jälkeen kun olet luonut tietoartikkelin)

• 1: Hyväksytty (sen jälkeen kun olet hyväksynyt tietoartikkelin)

• 2: Aikataulutettu (sen jälkeen kun olet aikatauluttanut tietoartikkelin julkaistavan)

• 3: Julkaistu (sen jälkeen kun olet julkaissut tietoartikkelin)

• 4: Vanhentunut (sen jälkeen, kun tietoartikkeli vanhenee julkaisun yhteydessä määritellyn vanhenemispäivän mukaisesti)

• 5: Arkistoitu (tietoartikkelin arkistoinnin jälkeen)

• 6: Hylätty (tietoartikkelin hylkäämisen jälkeen)

Jos haluat muuttaa artikkelin tilan, päivitä määrite Update käyttämällä tietoartikkelin sanomaa KnowledgeArticle.StateCode. Käytä aikaisille sidottu-tyypeille enumerointia KnowledgeArticleState ja määritä mahdolliset tilat. Lue lisää aiheesta Suorita erikoisoperaatioita Update-toiminnolla.

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

Tietoartikkelin tietueen liittäminen Dynamics 365 Customer Service -entiteetin esiintymään

Kun otat käyttöön upotetun tiedonhaun taululle Dynamics 365 Customer Service:ssa käyttämällä web-asiakasohjelmaa, järjestelmä luo automaattisesti monesta moneen -suhteen nimeltä msdyn_<Entity_Name>_knowledgearticle. Käytä tätä suhdetta ohjelmallisesti yhdistääksesi tai linkittämään instanssin KnowledgeArticle Dynamics 365 Customer Service -taulukkoinstanssiin. Kun liität instanssin KnowledgeArticle tauluinstanssiin, luot tietueen suhteesta leikkaustauluun nimeltä msdyn_<Entity_Name>_knowledgearticle. Esimerkiksi, kun liität instanssin KnowledgeArticle instanssiin Account ensimmäistä kertaa, luot leikkaustaulukon nimeltä msdyn_account_knowledgearticle, ja luot tietueen, jossa assosiaatiokartta on tässä leikkaustaulukossa. Oletuksena ( Incident Case)-taulukko on käytössä upotetulle tiedonhaulle. Kun linkität tietueen KnowledgeArticle tietueeseen Incident , luot assosiaatiotietueen leikkaustauluun KnowledgeArticleIncident .

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ä IncrementKnowledgeArticleViewCountRequest viestiä KnowledgeArticleViews lisätäksesi tietoartikkelin tietueen katselumäärää tiettynä päivänä taulukossa. Jos tietuetta ei ole olemassa tietoartikkelille tiettynä päivänä, operaatio luo tietueen ja asettaa määritellyn näkymämäärän arvon .KnowledgeArticleViews KnowledgeArticleView-määrite. Jos tietue on jo olemassa tietoartikkelista kyseiseltä päivältä, operaatio kasvattaa näkymän määrää KnowledgeArticleViews. KnowledgeArticleView-määrite aiemmin luodussa tietueessa.

Tietoartikkelien hakeminen tekstihaun avulla

Dynamics 365 Customer Service tietoartikkelit, mukaan lukien niiden versiot ja käännökset, ovat tekstiindeksoituja ja tukevat SQL Server koko tekstin hakua. Lisätietoja täystekstihausta on artikkelissa SQL Server: Full-text Search.

Käytä viestiä FullTextSearchKnowledgeArticleRequest etsiäksesi tietoartikkeleita hakemuksistasi löytääksesi etsimäsi tiedot. Viesti FullTextSearchKnowledgeArticleRequest antaa käyttää taivutusvartaloa (joka mahdollistaa erilaisen aikamuodon tai taivutusmuodon korvaamisen hakutekstille) ja määrittää kyselykriteerit (käyttämällä FetchXML:ää tai QueryExpressionia suodattamisen, järjestyksen, lajittelun ja sivutuksen määrittämiseen) löytääksesi tietoartikkeleita, joissa on määritelty teksti. Voit myös poistaa saman artikkelin kaksoiskappaleet hakutuloksista ja suodattaa tietoartikkelin tilan mukaan tekstin haun aikana.

Vanhentuneet tietämysentiteetit

Seuraavat perintöyksiköt ovat vanhentuneita. Lisätietoja on kohdassa Vanhentuneet tietoentiteetit

• KbArticle
• KbArticleComment
• KbArticleTemplate

1. joulukuuta 2020 alkaen et pääse käsiksi vanhoihin tietoyksiköihin. Siirry KnowledgeArticle -taulukkoon. Lisätietoja on kohdassa Tietoartikkeleiden luonti ja hallinta.    

Migrointiapua varten käytä seuraavia resursseja:

• Käytä SDK:ta, WebAPI:tä tai Microsoft-Power Automate skenaarioiden mukaan.
• Käytä avoin lähdekoodi-siirtotyökalua MIT-käyttöoikeuden kanssa.

Liittyvät tiedot

• Tietokantaentiteetit
• Tietoartikkeli-taulukko
• KnowledgeArticleViews-taulukko
• KnowledgeBaseRecord-taulukko
• LanguageLocale-taulukko
• Tärkeät muutokset tulevissa Microsoft Dynamics 365 -julkaisuversioissa