Del via

Arbejde med videnartikler i Dynamics 365

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

De nye videnartikler i Microsoft Dynamics 365 giver dig mulighed at oprette avancerede videnartikler, og samtidig får du understøttelse af versionering og oversættelse. Når du opretter og udgiver en videnartikel, bliver den tilgængelig for brugerne i din forekomst af Dynamics 365, så de kan bruge oplysninger i artiklerne til at behandle kunderne effektivt. Brug objektet KnowledgeArticle til at gemme og styre viden med indbyggede funktioner i Dynamics 365. Hvis du bruger viden fra Parature, kan du bruge KnowledgeBaseRecord-objektet til automatisk at bruge videnbaseartikler fra Parature.

Dette emne indeholder oplysninger om at arbejde med de nye indbyggede Dynamics 365-vidensstyringsfunktioner. Hvis du bruger Parature som videnkilde i Dynamics 365, skal du se under Bruge Parature-viden i Dynamics 365.

Bemærk

Hvis du bruger tidligere objektmodel til videnbaseartikler (KBArticle), skal du se under Arbejde med tidligere Dynamics 365-videnbaseartikler senere i dette emne.

Du kan ikke via programmering aktivere funktionen til styring af videnbasen for objekter i din Dynamics 365-forekomst. Det kan kun gøres ved hjælp af Dynamics 365-webklienten.Flere oplysninger:Hjælp og undervisning: Opsætning af vidensstyring i CRM

Dette emne indeholder

Oprette en vidensbaseartikel

Oprette overordnede og underordnede versioner af en videnartikel

Oprette en oversættelse af en videnartikel

Videnartikels livscyklus: Ændre tilstanden for en videnartikel

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

Forøge antal visninger af videnartikel

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

Arbejde med tidligere Dynamics 365-videnbaseartikler

Oprette en vidensbaseartikel

Når du opretter en videnartikelpost, opretter Dynamics 365 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, mens du i det gamle KbArticle-objekt skulle knytte dette til en skabelon, der beskrev afsnit og formatering for artiklen. Du kan angive din egen værdi for attributten KnowledgeArticle.ArticlePublicNumber, 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-indstillinger i webklienten. Attributten KnowledgeArticle.ArticlePublicNumber 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 Action (Web API) eller CreateKnowledgeArticleVersionRequest (organisationstjeneste) til at oprette en overordnet eller mindre version af den videnbaseartikel. 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 opretter 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:LanguageLocale (sprog) objektmeddelelser og -metoder

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 attributten KnowledgeArticle.ParentArticleContentId til at bevare tilknytningen til den overordnede 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 LanguageLocale-objektet er den samme på tværs af alle Dynamics 365-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øre særlige handlinger 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 = new OptionSetValue((int)KnowledgeArticleState.Published);
UpdateRequest updateKnowledgeArticle = new UpdateRequest
{
    Target = myKnowledgeArticle
};
_serviceProxy.Execute(updateKnowledgeArticle);

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

Når du aktiverer integreret vidensøgning for et objekt i Dynamics 365 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-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 attributten KnowledgeArticleViews.KnowledgeArticleView. Hvis der allerede findes en post for en videnartikel for den bestemte dag, øges visningsantallet blot i attributten KnowledgeArticleViews.KnowledgeArticleView for den eksisterende post.

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

Videnartikler i Dynamics 365, 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.

Arbejde med tidligere Dynamics 365-videnbaseartikler

Bemærk

Dette afsnit indeholder oplysninger om, hvordan du arbejder med den tidligere objektmodel for videnbaseartikler, når du bruger vidensstyring i Dynamics 365. De objekter, der er nævnt i dette afsnit, er stadig tilgængelige i den aktuelle version, men du skal bruge de vidensstyringsobjekter, der blev nævnt tidligere, for at kunne udnytte den forbedrede vidensstyringsoplevelse.

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

  • 1: Kladde (når en artikel oprettes)

  • 2: Ikke-godkendt (under redigering)

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

Hvis du vil ændre artiklens tilstand, skal du bruge meddelelsen SetStateRequest. For tidligt bundne typer skal du bruge KbArticleState-optællingen til at angive de mulige tilstande.

Når du opretter en artikel, skal du tilknytte den til en skabelon og et emne. En artikelskabelon beskriver sektioner og formatering for artiklen. Emner bruges til at organisere artiklerne efter forretningskategorier, som også bruges til at gruppere sager (hændelser), salgsmateriale og produkter. En bedste praksis er at oprette et emnetræ-hieraki og alle nødvendige artikelskabeloner, før du opretter en artikel.

Bemærk

Microsoft Dynamics 365 indeholder flere artikelskabeloner. De omfatter en standardartikel, en løsning på et problem, en procedure og andre skabeloner. Den anbefalede metode til oprettelse af artikelskabeloner er at bruge webprogrammet Microsoft Dynamics 365. Hvis du vil oprette en artikelskabelon via programmering, skal du bruge eksisterende artikelskabeloner som eksempler på, hvilke oplysninger der skal inkluderes, og hvordan data skal formateres.

Hvis du vil tilknytte en artikel til en skabelon, skal du bruge attributten KbArticle.KbArticleTemplateId. Hvis du vil placere en artikel i en bestemt kategori ved at angive et emne skal du bruge attributten KbArticle.SubjectId.

Angiv artiklens titel og de nøgleord, du vil bruge i søgningen. Hvis du vil beskrive en artikel, kan du bruge attributten KbArticle.Description. Hvis du vil tilføje indholdet for artiklen, kan du bruge attributten KbArticle.Content. Brug attributten Kbarticle.ArticleXml for at tilføje XML-data for artiklen.KbArticle.LanguageCode-værdien hentes fra skabelonen for at hjælpe dig med at skrive de forespørgsler, som sorterer artiklerne efter sprog.

Når en artikel er oprettet, gemmes den som kladde. Herefter kan du ændre tilstanden på artiklen fra "Kladde" til "Ikke-godkendt." Du kan ændre indholdet af en ikke-godkendt artikel og gøre den klar til udgivelse. Når artiklen er klar til at blive udgivet, skal du ændre tilstanden fra "Ikke-godkendt" til "Udgivet".

En uudgivet artikel henter formatindstillingerne fra en skabelon. Hvis du ændrer et skabelonformat, anvendes ændringerne automatisk for artikler i tilstandene "Kladde" og "Ikke-godkendt".

Når du har udgivet en artikel, kan du tilføje kommentarer (KbArticleComment), men du kan ikke redigere artiklen, uanset hvilke rettigheder du har. Kommentarerne kan tilføjes til artiklen i en af de tre tilstande

Bemærk

Kommentarerne kan tilføjes til artiklen i alle tilstande: Kladde, Ikke-godkendt eller Udgivet.

Hvis du vil revidere eller opdatere artiklen, skal du annullere udgivelsen. Hvis du vil annullere udgivelsen af en artikel, skal du ændre artiklens tilstand fra Udgivet til Ikke-godkendt. Hvis du vil slette en artikel fra Microsoft Dynamics 365-databasen, skal du ændre artiklens tilstand fra Udgivet til Ikke-godkendt eller Kladde.

Bemærk

En vidensbaseartikel kan ikke slettes, hvis den er i tilstanden Udgivet.

Se Hjælp og undervisning: Bruge artikler i videnbase for at få flere oplysninger om at oprette, opdatere, redigere og finde en artikel i videnbasen.

Se også

Vidensstyringsobjekter
Bruge Parature-viden i Dynamics 365
KnowledgeArticle-objektmeddelelser og -metoder
KnowledgeArticleViews-objektmeddelelser og -metoder
Meddelelser og metoder for objektet KnowledgeBaseRecord
LanguageLocale (sprog) objektmeddelelser og -metoder
Objektmeddelelser og metoder for vidensbaseartikel (artikel)

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret