Arbejd med KnowledgeArticle-tabellen

Gælder for: Dynamics 365 Kundeservice og Dynamics 365 Contact Center—kun selvstændigt

Brug KnowledgeArticle tabellen til at indbygge vidensstyringsfunktioner i dine Dynamics 365 Customer Service-løsninger. Denne artikel beskriver, hvordan man opretter artikler, administrerer versioner og oversættelser, publicerer indhold og integrerer vidensartikler med andre kundeserviceenheder.

Forudsætninger

Sørg for, at du har de nødvendige roller og privilegier.

Oprette en vidensbaseartikel

Når du opretter en videnartikelpost, opretter Dynamics 365 Customer Service internt en rodartikel til posten. Rodartiklen fungerer som en beholder for den primære vidensartikel, du skriver, sammen med alle de artikelversioner og oversættelser, du eventuelt kan lave i fremtiden. Følgende diagram viser tabelmodellen for tabellen KnowledgeArticle .

Når du opretter en knowledge article record, opretter du den i staten Draft . Ved at bruge den nye KnowledgeArticle tabel kan du oprette en artikel ved at specificere dens indhold og formatering i HTML-format. Du kan angive din egen værdi for KnowledgeArticle. ArticlePublicNumber Tilskriv mens du opretter en vidensartikel-registrering programmæssigt. Ellers genereres værdien automatisk baseret på det format, du har angivet i Dynamics 365 Customer Service-indstillingsområdet i webklienten. KnowledgeArticle. ArticlePublicNumber attributten gemmer ID'et, der er eksponeret for kunder, partnere og andre eksterne brugere til at henvise til og slå op i vidensartikler. Det forbliver det samme på tværs af vidensartikelversioner og oversættelser.

Følgende eksempelkode viser, hvordan du kan oprette en videnartikelpost.

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

Oprette overordnede og underordnede versioner af en videnartikel

Når du opretter en knowledge article record, sættes hovedversionen automatisk til 1, og minor-versionen til 0. Brug CreateKnowledgeArticleVersion-meddelelsen (CreateKnowledgeArticleVersion Action eller CreateKnowledgeArticleVersionRequest) til at oprette en overordnet eller underordnet version af en videnartikel. I anmodningsbeskeden skal du sætte IsMajor til true for at oprette en hovedversion, eller til false at oprette en mindre version. Den nye versionspost bruger følgende attributter:

• KnowledgeArticle. RootArticleId -attributten til at bevare tilknytningen til videnartikelposten i roden.

• KnowledgeArticle. PreviousArticleContentId-attributten til at pege på den tidligere version af posten.

Følgende eksempelkode viser, hvordan man opretter en hovedversion af en knowledge article record ved at bruge CreateKnowledgeArticleVersionRequest.

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

Oprette en oversættelse af en videnartikel

Brug CreateKnowledgeArticleTranslation Action (Web API) eller CreateKnowledgeArticleTranslationRequest (organisationstjeneste) til at oprette en oversættelse for en videnartikelpost. Du kan oversætte din vidensartikel til mere end 150 sprog. Information om disse understøttede sprog er tilgængelig i den nye LanguageLocale tabel.

Lær mere i LanguageLocale-tabellen.

Ved at bruge CreateKnowledgeArticleTranslation Action (Web API) eller CreateKnowledgeArticleTranslationRequest (organisationstjeneste) opretter du en ny knowledge article-post med titel, indhold, beskrivelse og nøgleord kopieret fra kildeposten til den nye post. Du angiver sproget for den nye post som det, du angiver i anmodning. Du skal også specificere, om den nye plade er en major- eller minorversion. Den nye post bruger KnowledgeArticle. ParentArticleContentId-attribut til at bevare tilknytningen til den primære videnartikelpost.

Når du har sendt denne meddelelse og fået et svar, kan du hente videnartikelposten fra svarobjektet og derefter opdatere titel, indhold, beskrivelse og nøgleord for at tilføje det oversatte indhold.

Følgende eksempelkode viser, hvordan man opretter en oversættelse af en vidensartikel ved at bruge 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));  

Videnartikels livscyklus: Ændre tilstanden for en videnartikel

I løbet af sin livscyklus kan en videnartikel være i følgende tilstande:

• 0: Udkast (efter du har lavet en vidensartikel)

• 1: Godkendt (efter du har godkendt en vidensartikel)

• 2: Planlagt (efter du har planlagt en vidensartikel til udgivelse)

• 3: Udgivet (efter du har udgivet en vidensartikel)

• 4: Udløbet (efter at en vidensartikel udløber i henhold til den udløbsdato, der blev angivet under udgivelsen)

• 5: Arkiveret (efter du har arkiveret en vidensartikel)

• 6: Kasseret (efter du har kasseret en vidensartikel)

For at ændre tilstanden for artiklen skal du bruge Update-meddelelsen i videnartikelposten til at opdatere KnowledgeArticle.StateCode-attributten. For tidligt bundne typer skal du bruge KnowledgeArticleState-optællingen til at angive de mulige tilstande. Lær mere i Udfør specialiserede operationer ved hjælp af Update.

Følgende eksempelkode viser, hvordan du udgiver en videnartikelpost.

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

Knyt en videnartikelpost til en Dynamics 365 Customer Service objektforekomst

Når du aktiverer indlejret videnssøgning for en tabel i Dynamics 365 Customer Service ved at bruge webklienten, opretter systemet automatisk en mange-til-mange-relation kaldet msdyn_<Entity_Name>_knowledgearticle. Brug denne relation til programmatisk at tilknytte eller linke en KnowledgeArticle instans med en Dynamics 365 Customer Service-tabelinstans. Når du associerer en KnowledgeArticle instans med en tabelinstans, opretter du en post for relationen i en intersect-tabel kaldet msdyn_<Entity_Name>_knowledgearticle. For eksempel, når du associerer en KnowledgeArticle instans med en Account instans første gang, opretter du en intersect-tabel kaldet msdyn_account_knowledgearticle, og du opretter en post med associationsmappingen i denne intersect-tabel. Som standard Incident er (Case)-tabellen aktiveret til den indlejrede videnssøgning. Når du linker en KnowledgeArticle post til en Incident post, opretter du en associationspost i KnowledgeArticleIncident intersect-tabellen.

Følgende eksempelkode viser, hvordan du knytter en KnowledgeArticle-forekomst til en Account-forekomst:

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

Forøge antal visninger af videnartikel

Brug beskeden IncrementKnowledgeArticleViewCountRequest til at øge antallet af visninger af en videnartikelpost for en given dag i tabellen KnowledgeArticleViews . Hvis der ikke findes en post for en vidensartikel på en bestemt dag, opretter operationen en post og sætter den angivne værdi for visningsantal i .KnowledgeArticleViews KnowledgeArticleView-attribut. Hvis der allerede findes en post for en vidensartikel for den angivne dag, øger operationen visningstallet i .KnowledgeArticleViews KnowledgeArticleView-attribut for den eksisterende post.

Søge i videnartikler ved hjælp af fuldtekstsøgning

Videnartikler i Dynamics 365 Customer Service, herunder deres versioner og oversættelser, indekseres i fuld tekst og understøtter SQL Server fuldtekstsøgning. Få mere at vide om fuldtekstsøgning i SQL Server: Fuldtekstsøgning.

Brug beskeden FullTextSearchKnowledgeArticleRequest til at søge i vidensartikler fra dine ansøgninger for at finde den information, du søger. Beskeden FullTextSearchKnowledgeArticleRequest lader dig bruge bøjningsstem-matching (som tillader en anden tid eller bøjning at erstatte søgeteksten) og specificere forespørgselskriterier (ved at bruge FetchXML eller QueryExpression til at specificere filtrering, rækkefølge, sortering og pageing) for at finde vidensartikler med specificeret tekst. Du kan også vælge at fjerne flere versioner af de samme artikler i søgeresultaterne og filtrere på videnartiklens tilstand under søgningen efter en tekst.

Frarådede vidensobjekter

Følgende legacy-enheder er forældede. Få mere at vide i Udfasede videnenheder.

• KbArticle
• KbArticleComment
• KbArticleTemplate

Fra 1. december 2020 kan du ikke få adgang til ældre vidensenheder. Gå til tabellen KnowledgeArticle. Få mere at vide i Opret og administrer vidensartikler.    

For hjælp til migration kan du bruge følgende ressourcer:

• Brug SDK, WebAPI eller Microsoft Power Automate afhængigt af dine scenarier.
• Brug overførselsværktøjet til åben kildekode med MIT-licens.

Relaterede oplysninger

• Videnbaseobjekter
• KnowledgeArticle-tabel
• KnowledgeArticleViews-tabel
• KnowledgeBaseRecord-tabel
• LanguageLocale-tabel
• Vigtige ændringer, der kommer i fremtidige versioner af Microsoft Dynamics 365