Lavora con la tabella KnowledgeArticle

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

Usa la KnowledgeArticle tabella per integrare capacità di gestione della conoscenza nelle tue soluzioni Dynamics 365 Customer Insights - Journeys. Questo articolo descrive come creare articoli, gestire versioni e traduzioni, pubblicare contenuti e integrare articoli di conoscenza con altre entità di servizio clienti.

Prerequisiti

Assicurati di avere i ruoli e i privilegi richiesti.

Creare un articolo della Knowledge Base

Quando crei un record di un articolo della Knowledge Base, Dynamics 365 Customer Insights - Journeys crea internamente un articolo radice per il record. L'articolo principale funge da contenitore per l'articolo di conoscenza principale che crei, insieme a tutte le versioni e traduzioni degli articoli che potresti realizzare in futuro. Il diagramma seguente rappresenta il modello della tabella per la KnowledgeArticle tabella.

Quando crei il record di un articolo della knowledge base, lo crei nello stato Draft. Utilizzando la nuova KnowledgeArticle tabella, 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 tramite codice di un record di articolo della Knowledge Base. Altrimenti, il valore viene generato automaticamente in base al formato specificato nell'area delle impostazioni di Dynamics 365 Customer Insights - Journeys nel client web. Il KnowledgeArticle. ArticlePublicNumber attributo memorizza l'ID esposto a clienti, partner e altri utenti esterni per fare riferimento agli articoli della knowledge base e cercarli. Rimane invariata sia nelle versioni degli articoli informativi che nelle traduzioni.

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 crei un record di un articolo di conoscenza, la versione principale viene impostata automaticamente a 1 e quella minore a 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, imposta IsMajor su true per creare una versione principale, oppure impostalo su false per creare una versione secondaria. Il nuovo record di versione utilizza i seguenti attributi:

• 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 mostra come creare una versione principale di un record di articolo di conoscenza 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

Utilizza CreateKnowledgeArticleTranslation Action (API web) o CreateKnowledgeArticleTranslationRequest (servizio di organizzazione) per creare una traduzione del record di un articolo della Knowledge Base. Puoi tradurre il tuo articolo di conoscenza in più di 150 lingue. Le informazioni su questi linguaggi supportati sono disponibili nella nuova LanguageLocale tabella.

Scopri di più nella tabella LanguageLocale.

Utilizzando CreateKnowledgeArticleTranslation Action (Web API) o CreateKnowledgeArticleTranslationRequest (servizio organizzativo), si crea un nuovo record di articolo di conoscenza con titolo, contenuto, descrizione e parole chiave copiati dal record sorgente al nuovo record. Impostate la lingua del nuovo record su quella specificata nella richiesta. Devi anche specificare se il nuovo disco è una versione maggiore o minore. Il nuovo record utilizza il KnowledgeArticle. ParentArticleContentId per gestire l'associazione al record dell'articolo della Knowledge Base primario.

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 seguente codice di esempio mostra come creare una traduzione di un articolo di conoscenza utilizzando 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 aver creato un articolo di conoscenza)

• 1: Approvato (dopo aver approvato un articolo di conoscenza)

• 2: Programmato (dopo aver programmato la pubblicazione di un articolo di conoscenza)

• 3: Pubblicato (dopo aver pubblicato un articolo di conoscenza)

• 4: Scaduto (dopo che un articolo di conoscenza scade secondo la data di scadenza specificata durante la pubblicazione)

• 5: Archiviato (dopo aver archiviato un articolo di conoscenza)

• 6: Scartato (dopo aver scartato un articolo di conoscenza)

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. Scopri di più su Eseguire operazioni specializzate usando Aggiornamento.

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à di Dynamics 365 Customer Insights - Journeys

Quando abiliti la ricerca della knowledge base incorporata per una tabella in Dynamics 365 Customer Insights - Journeys tramite il client Web, il sistema crea automaticamente una relazione molti-a-molti denominata msdyn_<Entity_Name>_knowledgearticle. Usa questa relazione per associare o collegare programmaticamente un'istanza KnowledgeArticle con un'istanza di tabella Dynamics 365 Customer Insights - Journeys. Quando associ un'istanza KnowledgeArticle a un'istanza di tabella, crei un record per la relazione in una tabella intersezione chiamata msdyn_<Entity_Name>_knowledgearticle. Ad esempio, quando associ un'istanza KnowledgeArticle a un'istanza Account per la prima volta, crei una tabella intersezione chiamata msdyn_account_knowledgearticle, e crei un record con la mappatura associativa in questa tabella intersezione. Per impostazione predefinita, la tabella Incident (Case) è abilitata per la ricerca nella knowledge base incorporata. Quando colleghi un record KnowledgeArticle a un record Incident, crei un record di associazione nella tabella di intersezione 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

Usa il IncrementKnowledgeArticleViewCountRequest messaggio per incrementare il numero di visualizzazioni di un record di articolo di conoscenza per un dato giorno nella KnowledgeArticleViews tabella. Se un record non esiste per un articolo di conoscenza per un giorno specificato, l'operazione crea un record e imposta il valore di conteggio delle visualizzazioni specificato nel KnowledgeArticleViews. AttributoKnowledgeArticleView. Se esiste già un record per un articolo della knowledge base per il giorno specificato, l'operazione incrementa il numero di visualizzazioni nel KnowledgeArticleViews. attributo KnowledgeArticleView 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.

Usa il messaggio FullTextSearchKnowledgeArticleRequest per cercare articoli della knowledge base nelle tue applicazioni e trovare le informazioni desiderate. Il messaggio FullTextSearchKnowledgeArticleRequest consente di utilizzare la corrispondenza per radice flessionale, che permette di sostituire il testo di ricerca con una forma flessa o un tempo verbale diversi, e di specificare criteri di query, usando FetchXML o QueryExpression per definire filtraggio, ordinamento, ordinamento dei risultati e paginazione, per trovare articoli della knowledge base contenenti il 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 seguenti entità legacy sono obsolete. Altre informazioni sono disponibili in Entità di conoscenza deprecate.

• KbArticle
• KbArticleComment
• KbArticleTemplate

Dal 1° dicembre 2020, non puoi accedere alle entità di conoscenza legacy. Passa alla tabella KnowledgeArticle. Per altre informazioni, vedere Creare e gestire gli articoli della Knowledge Base.    

Per aiuto con la migrazione, utilizza le seguenti risorse:

• 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
• Tabella KnowledgeArticle
• Tabella KnowledgeArticleViews
• Tabella KnowledgeBaseRecord
• tabella LanguageLocale
• Importanti modifiche in arrivo nelle versioni future di Microsoft Dynamics 365