Delen via

Werken met Knowledge-artikelen in Dynamics 365

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

De nieuwe Knowledge-artikelen in Microsoft Dynamics 365 stellen u in staat om uitgebreide Knowledge-artikelen te maken door de versieondersteuning en vertaalondersteuning. Wanneer u een Knowledge-artikel maakt en publiceert, worden deze beschikbaar voor gebruikers in uw exemplaar van Dynamics 365, zodat zij deze informatie in artikelen kunnen gebruiken om aan de klanten een effectieve service te verlenen. Gebruik de entiteit KnowledgeArticle om kennis in Dynamics 365 als systeemeigen kennis op te slaan en te beheren. Als u kennis van Parature gebruikt, moet u de entiteit KnowledgeBaseRecord gebruiken om de Knowledge Base-artikelen van parature via programmering te gebruiken.

Dit onderwerp biedt informatie over het gebruik van de nieuwe systeemeigen Dynamics 365-mogelijkheden voor kennisbeheer. Als u Parature als uw kennisbron in Dynamics 365 gebruikt, raadpleegt u Parature-kennis gebruiken in Dynamics 365

Notitie

Als u het entiteitsmodel van het vorige Knowledge Base-artikel (KBArticle) gebruikt, raadpleegt u Werken met vorige versies van Knowledge Base-artikelen verderop in dit onderwerp.

U kunt de functie voor Knowledge Base-beheer voor entiteiten in uw Dynamics 365-exemplaar niet via programmering inschakelen; dit kan alleen met de Dynamics 365-webclient.Meer informatie:Help en training: Kennisbeheer instellen in CRM

In dit onderwerp

Een Knowledge Base-artikel maken

Een primaire en een secundaire versie van een Knowledge-artikel maken

Een vertaling van Knowledge-artikel maken

Levenscyclus van een Knowledge-artikel: De status van een Knowledge-artikel wijzigen

Een record voor een Knowledge-artikel aan een exemplaar van een Dynamics 365-entiteit koppelen

De weergavetelling van het Knowledge-artikel verhogen

Knowledge-artikelen doorzoeken met een zoekactie in volledige tekst

Werken met vorige versies van Knowledge Base-artikelen

Een Knowledge Base-artikel maken

Wanneer u een record voor een Knowledge-artikel maakt, maakt Dynamics 365 intern een hoofdartikel voor de record aan. Het hoofdartikel doet dienst als container voor het primaire Knowledge-artikel dat u samen hebt gemaakt met alle artikelversies en -vertalingen die u mogelijk in de toekomst maakt. Het volgende diagram laat het entiteitsmodel voor de entiteit KnowledgeArticle zien.

KnowledgeArticle-entiteitsmodel

Wanneer u een record voor een Knowledge-artikel maakt, wordt deze in de Draft-status gemaakt. Door de entiteit KnowledgeArticle te gebruiken, kunt u een artikel maken door de inhoud en de opmaak in HTML-indeling op te geven, in vergelijking met het gebruik van de oude KbArticle entiteit waar u deze aan een sjabloon moest koppelen waarin de secties en opmaak van het artikel werden beschreven. U kunt uw eigen waarde opgeven voor het kenmerk KnowledgeArticleArticlePublicNumber terwijl u via programmering een Knowledge-artikel maakt. Anders wordt de waarde automatisch gegenereerd op basis van de indeling die u in het Dynamics 365-instellingengebied in de webclient hebt opgegeven. Het kenmerk KnowledgeArticle.ArticlePublicNumber slaat de id op waar deze zichtbaar is voor klanten, partners en andere externe gebruikers zodat deze Knowledge-artikelen kunnen raadplegen en zoeken. De versies en vertalingen van de Knowledge-artikelen blijven behouden.

De volgende voorbeeldcode toont hoe u een record voor een Knowledge-artikel kunt maken.

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

Een primaire en een secundaire versie van een Knowledge-artikel maken

Wanneer u een Knowledge Base-artikelrecord maakt, wordt de hoofdversie automatisch ingesteld op 1 en de secundaire versie op 0. Gebruik CreateKnowledgeArticleVersion Action (Web API) of CreateKnowledgeArticleVersionRequest (organisatieservice) om een hoofdversie of een secundaire versie van een Knowledge-artikel te maken. Stel in het aanvraagbericht IsMajor in op true om een primaire versie te maken; gebruik de instelling false om een secundaire versie te maken. De nieuwe versierecord die wordt gemaakt gebruikt het:

  • KnowledgeArticle.RootArticleId-kenmerk om de koppeling met de record van de Knowledge Base-hoofdartikelrecord te behouden.

  • KnowledgeArticle.PreviousArticleContentId-kenmerk om naar de eerdere versie van de record te verwijzen.

De volgende voorbeeldcode toont hoe u een primaire versie van een Knowledge-artikel kunt maken met behulp van CreateKnowledgeArticleVersionRequest.

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

Een vertaling van Knowledge-artikel maken

Gebruik CreateKnowledgeArticleTranslation Action (Web API) of CreateKnowledgeArticleTranslationRequest (organisatieservice) om een vertaling voor een record voor een Knowledge-artikel te maken. U kunt uw Knowledge-artikel in meer dan 150 talen vertalen, en informatie over de ondersteunde talen is beschikbaar in de nieuwe LanguageLocale-entiteit.Meer informatie:Methoden en berichten van de entiteit LanguageLocale (Taal)

Door CreateKnowledgeArticleTranslation Action (Web API) of CreateKnowledgeArticleTranslationRequest (organisatieservice) te gebruiken, wordt een nieuwe record voor een Knowledge-artikel gemaakt met de titel, inhoud, beschrijving en trefwoorden die van de bronrecord naar de nieuwe record worden gekopieerd, terwijl de taal van de nieuwe record wordt ingesteld op de taal die u hebt opgegeven in de aanvraag. U moet ook opgeven of een nieuwe record een primaire dan wel een secundaire versie is. De nieuwe record gebruikt het kenmerk KnowledgeArticle.ParentArticleContentId om de koppeling met de primaire record voor het Knowledge-artikel te behouden.

Als u dit bericht uitvoert en een respons krijgt, haalt u het Knowledge-artikel op uit het responsobject, en werk vervolgens de titel, het onderwerp, de beschrijving en de trefwoorden bij om de vertaalde inhoud toe te voegen.

De volgende voorbeeldcode toont hoe u een vertaling van een Knowledge-artikel kunt maken met behulp van 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));

Notitie

De GUID-waarde van de primaire sleutel (LanguageLocaleId) voor elke taalrecord in de LanguageLocale -entiteit is hetzelfde voor alle Dynamics 365-organisaties.

Levenscyclus van een Knowledge-artikel: De status van een Knowledge-artikel wijzigen

Tijdens de levenscyclus kan een Knowledge-artikel zich in de volgende statussen bevinden:

  • 0: Concept (nadat een Knowledge-artikel is gemaakt)

  • 1: Goedgekeurd (nadat een Knowledge-artikel is goedgekeurd)

  • 2: Gepland (nadat een Knowledge-artikel is gepland om te worden gepubliceerd)

  • 3: Gepubliceerd (nadat een Knowledge-artikel is gepubliceerd)

  • 4: Verlopen (nadat een Knowledge-artikel is verlopen op de einddatum die tijdens het publiceren is opgegeven)

  • 5: Gearchiveerd (nadat een Knowledge-artikel is gearchiveerd)

  • 6: Verwijderd (nadat een Knowledge-artikel is verwijderd)

Om de status van het artikel te wijzigen, moet u het Update-bericht in de record voor het Knowledge-artikel gebruiken om het KnowledgeArticle.StateCode kenmerk bij te werken. Voor u eerder gebonden typen gebruikt u de opsomming KnowledgeArticleState om de mogelijk statussen in te stellen.Meer informatie:Speciale bewerkingen uitvoeren via Update.

De volgende voorbeeldcode toont hoe u een record voor een Knowledge-artikel kunt publiceren.

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

Een record voor een Knowledge-artikel aan een exemplaar van een Dynamics 365-entiteit koppelen

Als u met de webclient zoeken in embedded Knowledge voor een entiteit in Dynamics 365 inschakelt, wordt automatisch een veel-op-veelrelatie, msdyn_<Entiteitnaam>_knowledgearticle, gemaakt. U kunt deze relatie gebruiken om via programmering een exemplaar van KnowledgeArticle te associëren met of te koppelen aan een exemplaar van een Dynamics 365-entiteit. Als u een exemplaar van een KnowledgeArticle-exemplaar koppelt aan een exemplaar van een entiteit, wordt een record voor de relatie gemaakt in een doorsnedenentiteit genaamd msdyn_<Entiteitnaam>_knowledgearticle. Als u bijvoorbeeld voor het eerst een exemplaar van een KnowledgeArticle koppelt aan een exemplaar van Account, wordt een doorsnedenentiteit gemaakt genaamd msdyn_account_knowledgearticle en wordt een record met de koppelingstoewijzing gemaakt in deze doorsnedenentiteit. Standaard is de entiteit Incident (Aanvraag) ingeschakeld voor zoeken in embedded Knowledge, en als u een KnowledgeArticle-record koppelt aan een Incident-record, wordt een gekoppelde record gemaakt in de doorsnedenentiteit KnowledgeArticleIncident.

In de volgende voorbeeldcode ziet u hoe u een exemplaar van KnowledgeArticle kunt koppelen aan een exemplaar van 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);

De weergavetelling van het Knowledge-artikel verhogen

Gebruik het bericht IncrementKnowledgeArticleViewCountRequest om de weergavetelling van een Knowledge-artikel voor een bepaalde dag in de entiteit KnowledgeArticleViews te verhogen. Als er geen record bestaat voor een Knowledge-artikel voor een specifieke dag, wordt er een record gemaakt en wordt vervolgens de opgegeven waarde ingesteld in bij de weergavetelling in KnowledgeArticleViews.KnowledgeArticleView-kenmerk. Als er al een record bestaat voor een Knowledge-artikel voor die specifieke dag, wordt alleen de weergavetelling in het KnowledgeArticleViews.KnowledgeArticleView-kenmerk van de huidige record verhoogd.

Knowledge-artikelen doorzoeken met een zoekactie in volledige tekst

Van Knowledge-artikelen in Dynamics 365, met inbegrip van hun versies en vertalingen, is de volledige tekst geïndexeerd, en wordt zoeken in volledige tekst van SQL Server ondersteund. Voor meer informatie over zoeken in volledige tekst, zie SQL Server: Zoekactie in volledige tekst.

Gebruik het bericht FullTextSearchKnowledgeArticleRequest om te zoeken naar een Knowledge-artikel vanuit uw toepassingen voor het vinden van de informatie waar u naar op zoek bent. Met het bericht FullTextSearchKnowledgeArticleRequest kunt u woordstamvervoegingsvergelijking gebruiken (waardoor een andere tijd of verbuiging kan worden gebruikt om de zoektekst te vervangen) en kunt u querycriteria opgeven (met behulp van FetchXML of QueryExpression om op te geven dat u wilt filteren, rangschikken, sorteren of pagineren) om Knowledge-artikelen met bepaalde tekst te vinden. U kunt ook besluiten meerdere versies van dezelfde artikelen in de zoekresultaten te verwijderen, en te filteren op de status van het Knowledge-artikel terwijl u naar een tekst zoekt.

Werken met vorige versies van Knowledge Base-artikelen

Notitie

Deze sectie biedt informatie over het gebruik van vorige versies van het entiteitsmodel voor Knowledge Base-artikelen voor kennisbeheer in Dynamics 365. Hoewel de entiteiten die in deze sectie worden vermeld in de huidige versie nog steeds beschikbaar zijn, moet u de eerder genoemde entiteiten voor kennisbeheer gebruiken om van de verbeterde ervaring van kennisbeheer te profiteren.

Tijdens de levenscyclus kan een Knowledge Base-artikel de volgende statuswaarden hebben:

  • 1: Concept (nadat een artikel is gemaakt)

  • 2: Niet goedgekeurd (tijdens het bewerken)

  • 3: Gepubliceerd (nadat een artikel is gepubliceerd)

Om de status van het artikel te wijzigen, moet u het bericht SetStateRequest. Voor u eerder gebonden typen gebruikt u de opsomming KbArticleState om de mogelijk statussen in te stellen.

Wanneer u een artikel maakt, moet u dit koppelen aan een sjabloon en een onderwerp. Een artikelsjabloon beschrijft de secties en opmaak voor het artikel. Onderwerpen worden gebruikt om de artikelen onder te verdelen in commerciële categorieën die ook worden gebruikt om aanvragen (incident), verkoopdocumentatie en producten te groeperen. Een aanbevolen procedure is het maken van een onderwerpstructuurhiërarchie en alle benodigde artikelsjablonen voordat u een artikel gaat maken.

Notitie

Microsoft Dynamics 365 biedt verschillende artikelsjablonen. Deze omvatten een standaardartikel, een oplossing voor een probleem, een procedure en andere sjablonen. De aanbevolen methode om artikelsjablonen te maken is met behulp van de Microsoft Dynamics 365-webtoepassing. Als u programmatisch een artikelsjabloon wilt maken, gebruikt u bestaande artikelsjablonen als voorbeelden van de informatie die moet worden opgenomen en van de indeling van de gegevens.

Als u een artikel wilt koppelen aan een sjabloon, gebruikt u het kenmerk KbArticle.KbArticleTemplateId. Als u een artikel in een bepaalde categorie wilt opnemen door een onderwerp op te geven, gebruikt u het kenmerk KbArticle.SubjectId.

Geef de titel van het artikel op en de trefwoorden die u in de zoekopdracht wilt gebruiken. Als u een artikel wilt beschrijven, kunt u het kenmerk KbArticle.Description gebruiken. Als u de inhoud voor het artikel wilt toevoegen, gebruikt u het kenmerk KbArticle.Content. Gebruik het kenmerk Kbarticle.ArticleXml om de XML-gegevens voor het artikel toe te voegen. De waarde KbArticle.LanguageCode wordt verkregen van de sjabloon om u te helpen de query's te schrijven die het artikel sorteren op de taal.

Wanneer een artikel wordt gemaakt, wordt het opgeslagen als concept. Daarna kunt u de status van het artikel wijzigen van Concept in Niet-goedgekeurd. U kunt de inhoud van een niet-goedgekeurd artikel wijzigen en gereed maken voor publicatie. Als het artikel gereed is om te worden gepubliceerd, wijzigt u de status van "Ter goedkeuring" in "Gepubliceerd".

Een niet-gepubliceerd artikel verkrijgt de indelingsinstellingen van een sjabloon. Als u een sjabloonindeling wijzigt, worden de wijzigingen automatisch overgebracht naar artikelen in de statussen "Concept" en "Ter goedkeuring".

Nadat u een artikel hebt gepubliceerd, kunt u opmerkingen (KbArticleComment) toevoegen, maar u kunt deze niet bewerken, ongeacht uw bevoegdheden. De opmerkingen kunnen worden toegevoegd aan het artikel dat zich in een van de statussen bevindt.

Notitie

De opmerkingen kunnen in elke status worden toegevoegd aan het artikel: Concept, Ter goedkeuring of Gepubliceerd.

Als u het artikel wilt herzien of bijwerken, moet u de publicatie ongedaan maken. U kunt de publicatie van een artikel ongedaan maken door de status van het artikel te wijzigen van "Gepubliceerd" in "Ter goedkeuring". Als u een artikel wilt verwijderen uit de Microsoft Dynamics 365-database, wijzigt u de status van het artikel van Gepubliceerd in Ter goedkeuring of Concept.

Notitie

Een Knowledge Base-artikel kan niet worden verwijderd als het de status Gepubliceerd heeft.

Voor meer informatie over het maken, bijwerken, bewerken en zoeken van een artikel in de Knowledge Base, raadpleegt u Help en training: Artikelen in de Knowledge Base gebruiken.

Zie ook

Kennisbeheer-entiteiten
Parature-kennis gebruiken in Dynamics 365
Berichten en methoden van de entiteit KnowledgeArticle
KnowledgeArticleViews entiteitberichten en methoden
Berichten en methoden van de entiteit KnowledgeBaseRecord
Methoden en berichten van de entiteit LanguageLocale (Taal)
Berichten en methoden van de entiteit KbArticle (artikel)

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht