Del via

Arbejde med videnartikler

  • Artikel

Bemærk

Oplysninger om tilgængelighed af funktioner er følgende.

Dynamics 365 Contact Center - integreret Dynamics 365 Contact Center - enkeltstående Dynamics 365 Customer Service
Nej Ja Ja

De nye vidensoplevelse i giver dig mulighed at oprette avancerede videnartikler, og samtidig får du understøttelse af versionering og oversættelse. Den nye vidensoplevelse bruger KnowledgeArticle-objektet til at gemme og administrere viden lokalt i Dynamics 365 Customer Service.

Bemærk

Objekterne KBArticle, KBArticleTemplate og KBArticleComment frarådes nu. Det betyder, at du ikke forventes at bruge disse objekter længere. Du skal bruge det nyere KnowledgeArticle-objekt til vidensstyring i Dynamics 365 Customer Service. Du kan få flere oplysninger i afsnittet Frarådede vidensobjekter i slutningen af dette emne.

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 videnartikel, du har oprettet, sammen med alle versioner og oversættelser af artiklen, som du evt. opretter i fremtiden. Følgende diagram viser objektmodellen for KnowledgeArticle-objektet.

KnowledgeArticle-objektmodel.

Når du opretter en videnartikelpost, oprettes den i Draft-tilstand. Ved hjælp af det nye KnowledgeArticle-objekt kan du oprette en artikel ved at angive dens indhold og formatering i HTML-format. Du kan angive din egen værdi for KnowledgeArticle. ArticlePublicNumber-attributten, når du opretter en videnartikelpost via programmering. Ellers oprettes værdien automatisk baseret på det format, du har angivet i området med Dynamics 365 Customer Service-indstillinger i webklienten. KnowledgeArticle. ArticlePublicNumber-attributten indeholder det id, som kunder, partnere og andre eksterne brugere kan se som reference, og når de skal slå op i videnartikler, og det bruges på tværs af videnartikelversioner 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 post for en videnbaseartikel post, angives den overordnede version automatisk til 1 og den mindre version til 0. Brug CreateKnowledgeArticleVersion-meddelelsen (CreateKnowledgeArticleVersion Action eller CreateKnowledgeArticleVersionRequest) til at oprette en overordnet eller underordnet version af en videnartikel. Indstil i anmodningsmeddelelsen IsMajor til true for at oprette en overordnet version, og indstil den til false for at oprette en underordnet version. Den nye versionspost, der oprettes, bruger:

  • 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 du kan oprette en overordnet version af en videnartikelpost ved hjælp af 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 videnartiklen til mere end 150 sprog, og oplysninger om disse understøttede sprog er tilgængelig i det nye LanguageLocale-objekt.

Flere oplysninger: Objektet LanguageLocale.

Ved hjælp af CreateKnowledgeArticleTranslation Action (Web API) eller CreateKnowledgeArticleTranslationRequest (organisationstjeneste) kan du oprette en ny videnartikelpost, hvor titlen, indholdet, beskrivelsen og nøgleord kopieres fra kildeposten til den nye post, og hvor sproget i den nye post er det, du angav i anmodningen. Du skal også angive, om den nye post er en overordnet eller underordnet version. 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 du opretter en oversættelse af en videnartikel ved hjælp af 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));

Bemærk

GUID-værdien af den primære nøgle (LanguageLocaleId) for hver sprogpost i objektet LanguageLocale er den samme på tværs af alle Dynamics 365 Customer Service-organisationer.

Videnartikels livscyklus: Ændre tilstanden for en videnartikel

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

  • 0: Kladde (når en videnartikel oprettes)

  • 1: Godkendt (når en videnartikel er godkendt)

  • 2: Planlagt (når en videnartikel er planlagt til at blive udgivet)

  • 3: Udgivet (når en videnartikel er udgivet)

  • 4: Udløbet (når en videnartikel har passeret den udløbsdato, der blev angivet under udgivelsen)

  • 5: Arkiveret (når en videnartikel er arkiveret)

  • 6: Fjernet (når en videnartikel er fjernet)

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. Flere oplysninger: Udfør specialiserede handlinger ved hjælp af Opdater.

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

Knytte en videnartikelpost til en forekomst af et Dynamics 365 Customer Service-objekt

Når du aktiverer integreret vidensøgning for et objekt i Dynamics 365 Customer Service ved hjælp af webklienten, oprettes der automatisk en mange-til-mange-relation, msdyn_<Entity_Name>_knowledgearticle. Du kan bruge denne relation til via programmering at tilknytte eller sammenkæde en KnowledgeArticle-forekomst med en Dynamics 365 Customer Service-objektforekomst. Når du knytter en KnowledgeArticle-forekomst til en objektforekomst, oprettes der en post for relationen i et skæringsobjekt, som kaldes msdyn_<Entity_Name>_knowledgearticle. For eksempel, når du knytter en KnowledgeArticle-forekomst til en Account forekomst for første gang, oprettes der et skæringsobjekt, som kaldes msdyn_account_knowledgearticle, og en post med tilknytningen oprettes i dette skæringsobjekt. Som standard er Incident-objektet (sag) aktiveret for den integrerede vidensøgning, og når du sammenkæder en KnowledgeArticle-post med en Incident-post, oprettes der en tilknytningspost i KnowledgeArticleIncident-skæringsobjektet.

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 meddelelsen IncrementKnowledgeArticleViewCountRequest til at forøge antal visninger af en videnartikelpost for en given dag i KnowledgeArticleViews-objektet. Hvis der ikke findes en post for en videnartikel for en bestemt dag, oprettes posten, og derefter indstilles den angivne værdi for visningsantallet i KnowledgeArticleViews. KnowledgeArticleView-attribut. Hvis der allerede findes en post for en videnartikel for den bestemte dag, øges visningsantallet blot 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, er fuldtekstindekseret og understøtter SQL Server-fuldtekstsøgning. Du kan finde flere oplysninger om fuldtekstsøgning under SQL Server: Fuld tekstsøgning.

Brug FullTextSearchKnowledgeArticleRequest-meddelelsen til at søge efter en videnartikel fra dine programmer for at finde de oplysninger, du leder efter. Med FullTextSearchKnowledgeArticleRequest -meddelelsen kan du bruge bøjningsformer (giver mulighed for, at en anden tid eller bøjning erstatter søgeteksten) og angive forespørgselskriterier (og bruge FetchXML eller QueryExpression til at angive filtrering, arrangering, sortering og sideinddeling) for at finde videnartikler med den angivne 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 ældre objekter er blevet frarådet. Flere oplysninger: Frabedte vidensobjekter

Der er ikke adgang til ældre vidensobjekter pr. 1. december 2020. Vi anbefaler, at du foretager flytningen til vidensartikelobjektet. Du kan finde flere oplysninger om, hvordan du opretter en videnartikel i Unified Interface, under Oprette og administrere videnartikler.  

Brug følgende til at få hjælp til migrering:

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

Vigtigt

  • Værktøjet med åben kildekode til migrering understøttes ikke af Microsoft og skal muligvis ændres, så det passer til dine scenarier.
  • Du skal altid køre et testmiljø, før du bruger den i produktion.
  • Kontrollér licensen og filen med vigtige oplysninger, før du bruger værktøjet.

Se også