Utilizzare gli articoli della Knowledge Base

Si applica a: Dynamics 365 Customer Insights - Journeys e Dynamics 365 Commerce — solo versione autonoma

La nuova esperienza della Knowledge Base consente di creare articoli dettagliati oltre a offrire supporto per il controllo delle versioni e la traduzione. La nuova esperienza di conoscenza usa l'entità KnowledgeArticle per archiviare e gestire le conoscenze in modo nativo in Dynamics 365 Customer Insights - Journeys.

Creare un articolo della Knowledge Base

Quando si crea un record dell'articolo della Knowledge Base, Dynamics 365 Customer Insights - Journeys crea internamente un articolo principale per il record. L'articolo radice funge da contenitore per l'articolo della Knowledge Base principale creato dall'utente insieme a tutte le versioni e le traduzioni degli articoli che è possibile creare in futuro. Il diagramma seguente illustra il modello di entità per l'entità KnowledgeArticle .

Quando si crea un record dell'articolo della Knowledge Base, viene creato nello stato Draft. Utilizzando la nuova entità KnowledgeArticle, puoi creare un articolo specificandone il contenuto e la formattazione in formato HTML. È possibile specificare il proprio valore per .KnowledgeArticle ArticlePublicNumber attributo durante la creazione di un record dell'articolo della Knowledge Base a livello di codice; in caso contrario, il valore viene generato automaticamente in base al formato specificato nell'area delle impostazioni Dynamics 365 Customer Insights - Journeys nel client Web. Il KnowledgeArticle ArticlePublicNumber L'attributo archivia l'ID esposto a clienti, partner e altri utenti esterni per fare riferimento e cercare gli articoli della Knowledge Base e rimane invariato nelle versioni e nelle traduzioni degli articoli della Knowledge Base.

Il seguente codice di esempio illustra come creare un record dell'articolo della Knowledge Base.

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

Creare versioni principali e secondarie di un articolo della Knowledge Base

Quando si crea un record dell'articolo della Knowledge Base, la versione principale viene impostata automaticamente su 1 e la versione secondaria su 0. Usare il CreateKnowledgeArticleVersion messaggio (CreateKnowledgeArticleVersion Action o CreateKnowledgeArticleVersionRequest) per creare una versione principale o secondaria di un articolo della Knowledge Base. Nel messaggio di richiesta, impostare IsMajor su true per creare una versione principale; impostarlo su false per creare una versione secondaria. Il nuovo record di versione creato usa:

• KnowledgeArticle. RootArticleId attributo per mantenere l'associazione con il record dell'articolo della Knowledge Base principale.

• KnowledgeArticle. PreviousArticleContentId attributo che indica la versione precedente del record.

Il seguente codice di esempio illustra come creare una versione principale di un record dell'articolo della Knowledge Base utilizzando CreateKnowledgeArticleVersionRequest.

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

Creare una traduzione di un articolo della Knowledge Base

Usare l'azione CreateKnowledgeArticleTranslation (API Web) o CreateKnowledgeArticleTranslationRequest (servizio organizzazione) per creare una traduzione per un record dell'articolo della Knowledge Base. È possibile tradurre l'articolo della Knowledge Base in più di 150 lingue e le informazioni su queste lingue supportate sono disponibili nella nuova LanguageLocale entità.

Altre informazioni: Tabella LanguageLocale.

L'uso di CreateKnowledgeArticleTranslation Action (Web API) o CreateKnowledgeArticleTranslationRequest (servizio organizzazione) crea un nuovo record dell'articolo della Knowledge Base con il titolo, il contenuto, la descrizione e le parole chiave copiati dal record di origine al nuovo record e imposta la lingua del nuovo record su quella specificata nella richiesta. È anche necessario specificare se il nuovo record sarà una versione principale o secondaria. Il nuovo record utilizza il KnowledgeArticle. ParentArticleContentId attributo per mantenere l'associazione con il record dell'articolo della Knowledge Base principale.

Dopo aver eseguito questo messaggio e ottenuto una risposta, recuperare il record dell'articolo della Knowledge Base dall'oggetto risposta e quindi aggiornare il titolo, il contenuto, la descrizione e le parole chiave per aggiungere il contenuto tradotto.

Il codice di esempio seguente illustra come creare una traduzione di un articolo della Knowledge Base usando 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));  

Ciclo di vita dell'articolo della Knowledge Base: Modificare lo stato di un articolo della Knowledge Base

Durante il ciclo di vita, un articolo della Knowledge Base può essere negli stati seguenti:

• 0: Bozza (dopo la creazione di un articolo della Knowledge Base)

• 1: Approvato (dopo l'approvazione di un articolo della Knowledge Base)

• 2: Pianificato (dopo che un articolo della Knowledge Base è pianificato per la pubblicazione)

• 3: Pubblicato (dopo la pubblicazione di un articolo della Knowledge Base)

• 4: Scaduto (dopo la scadenza di un articolo della Knowledge Base in base alla data di scadenza specificata durante la pubblicazione)

• 5: Archiviato (dopo l'archiviazione di un articolo della Knowledge Base)

• 6: Rimosso (dopo l'eliminazione di un articolo della Knowledge Base)

Per modificare lo stato dell'articolo, usare il messaggio nel record dell'articolo di conoscenza Update per aggiornare l'attributo KnowledgeArticle.StateCode. Per i tipi con associazione anticipata, utilizzare l'enumerazione KnowledgeArticleState per impostare gli stati possibili. Altre informazioni: Eseguire operazioni specializzate tramite Update.

Il codice di esempio seguente illustra come pubblicare un record di un articolo della Knowledge Base.

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

Associare un record dell'articolo della Knowledge Base a un'istanza di entità Dynamics 365 Customer Insights - Journeys

Quando si abilita la ricerca delle informazioni incorporate per un'entità in Dynamics 365 Customer Insights - Journeys usando il client Web, viene creata automaticamente una relazione molti-a-molti, msdyn_<Entity_Name>_knowledgearticle. È possibile usare questa relazione per associare o collegare a livello di codice un'istanza di KnowledgeArticle a un'istanza di entità Dynamics 365 Customer Insights - Journeys. Quando si associa un'istanza a un'istanza KnowledgeArticle di entità, viene creato un record per la relazione in un'entità interseca denominata msdyn_<Entity_Name>_knowledgearticle. Ad esempio, quando si associa un'istanza a un'istanza KnowledgeArticleAccount per la prima volta, viene creata un'entità di intersecazione denominata msdyn_account_knowledgearticle e viene creato un record con il mapping di associazione in questa entità interseca. Per impostazione predefinita, l'entità Incident (Case) è abilitata per la ricerca delle informazioni incorporata e quando si collega un KnowledgeArticle record a un Incident record, viene creato un record di associazione nell'entità interseca KnowledgeArticleIncident .

Il codice di esempio seguente illustra come associare un'istanza KnowledgeArticle a un'istanza Account di :

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

Incrementa il numero di visualizzazioni degli articoli della Knowledge Base

Usare il IncrementKnowledgeArticleViewCountRequest messaggio per incrementare il numero di visualizzazioni di un record di un articolo della Knowledge Base per un determinato giorno nell'entità KnowledgeArticleViews . Se un record non esiste per un articolo della Knowledge Base per un giorno specificato, verrà creato un record e quindi verrà impostato il valore del numero visualizzazioni specificato nell'attributo KnowledgeArticleViews. AttributoKnowledgeArticleView. Se esiste già un record per un articolo della Knowledge Base per il giorno specificato, incrementerà solo il conteggio delle visualizzazioni in KnowledgeArticleViews. KnowledgeArticleView attributo del record esistente.

Cercare articoli della Knowledge Base usando la ricerca full-text

Gli articoli della Knowledge Base in Dynamics 365 Customer Insights - Journeys, incluse le versioni e le traduzioni, sono indicizzati full-text e supportano la ricerca full-text di SQL Server. Altre informazioni sulla ricerca full-text, in SQL Server: Ricerca full-text.

Usare il messaggio FullTextSearchKnowledgeArticleRequest per cercare l'articolo di conoscenza dalle applicazioni per trovare le informazioni cercate. Il FullTextSearchKnowledgeArticleRequest messaggio consente di usare la corrispondenza di stem flessive (consente di sostituire una diversa forma del verbo o flessione per il testo di ricerca) e di specificare i criteri di query (usando FetchXML o QueryExpression per specificare filtraggio, ordinamento, e paginazione) per trovare articoli della base di conoscenza con testo specificato. È anche possibile scegliere di rimuovere più versioni degli stessi articoli nei risultati della ricerca e filtrare lo stato dell'articolo della Knowledge Base durante la ricerca di un testo.

Entità di conoscenza deprecate

Le entità legacy seguenti sono state deprecate. Maggiori informazioni: Entità della Knowledge Base obsolete

• KbArticle
• KbArticleComment
• KbArticleTemplate

Le entità della Knowledge Base legacy non sono accessibili a partire dal 1° dicembre 2020. È consigliabile effettuare il passaggio all'entità KnowledgeArticle. Per altre informazioni, vedere Creare e gestire gli articoli della Knowledge Base.  

Usare quanto segue per informazioni sulla migrazione:

• Usare SDK, WebAPI o Microsoft Power Automate a seconda degli scenari.
• Usare lo strumento di migrazione open source con licenza MIT.

Informazioni correlate

• Entità della Knowledge Base
• Entità KnowledgeArticle
• Entità KnowledgeArticleViews
• Entità KnowledgeBaseRecord
• Entità LanguageLocale
• Importanti modifiche in arrivo nelle versioni future di Microsoft Dynamics 365