Creare o modificare un'entità virtuale contenente dati da un'origine dati esterna
Questo argomento si applica a Dynamics 365 Customer Engagement (on-premises). Per la versione Power Apps di questo argomento, vedi: Creare e modificare entità virtuali che contengono dati da un'origine dati esterna
Un'entità virtuale è un'entità personalizzata di Dynamics 365 Customer Engagement (on-premises) con campi contenenti dati provenienti da un'origine dati esterna. Le entità virtuali vengono visualizzate nell'app agli utenti come normali record di entità, ma contengono dati provenienti da un database esterno, ad esempio il database SQL di Azure. I record basati sulle entità virtuali sono disponibili in tutti i client, inclusi i client personalizzati sviluppati tramite i servizi Web Dynamics 365 Customer Engagement.
In passato, integrare le origini dati disparate avrebbe richiesto la creazione di un connettore per spostare i dati o lo sviluppo di un plug-in personalizzato, lato client o server. Tuttavia, con le entità virtuali è possibile connettersi direttamente a un'origine dati esterna in fase di esecuzione in modo che i dati specifici dell'origine dati esterna siano disponibili in un ambiente, senza necessità di replica dei dati.
Le entità virtuali sono costituite da tre componenti principali, un provider di dati, un record origine dati e una entità virtuale. Il provider di dati consiste di plug-in e un'entità di origine dati. L'origine dati è un record di entità di Dynamics 365 Customer Engagement (on-premises) che include i metadati che rappresentano lo schema dei parametri di connessione. Ogni entità virtuale fa riferimento a un'origine dati nella definizione dell'entità.
Dynamics 365 Customer Engagement (on-premises) include un Provider dati OData utilizzabile per connettersi a un servizio Web OData v4 che accede ai dati esterni.
In alternativa, gli sviluppatori possono creare i propri provider di dati. I provider di dati sono installati in un ambiente come una soluzione. Ulteriori informazioni: Introduzione alle entità virtuali
Vantaggi delle entità virtuali
Gli sviluppatori possono implementare i plug-in per leggere dati esterni utilizzando i servizi Web Dynamics 365 Customer Engagement e plug-in Registration tool di Customer Engagement.
Gli addetti alla personalizzazione del sistema utilizzano Dynamics 365 Customer Engagement (on-premises) per configurare il record di origine dati e creare entità virtuali utilizzate per accedere ai dati esterni senza scrivere codice.
Gli utenti finali utilizzano i record creati dall'entità virtuale per visualizzare i dati in campi, griglie, risultati della ricerca e report e dashboard basati su FetchXML.
Aggiungere un'origine dati da utilizzare per le entità virtuali
Gli sviluppatori creano un plug-in personalizzato da utilizzare come provider di dati per un'entità virtuale. In alternativa, è possibile utilizzare il Provider dati OData v4 fornito. Ulteriori informazioni: Configurazione, requisiti e procedure consigliate per il Provider dati OData v4
Passare a Impostazioni>Amministrazione>Origini dati entità virtuali.
Sulla barra degli strumenti Azioni seleziona Nuovo.
Nella finestra di dialogo Seleziona provider dati, selezionare una delle seguenti origini dati e quindi seleziona OK.
Provider di dati personalizzato. Se è stato importato un plug-nei provider di dati, il provider di dati verrà visualizzato qui. Ulteriori informazioni: Introduzione alle entità virtuali
Provider dati OData v4. Dynamics 365 Customer Engagement (on-premises) include un Provider dati OData che può essere utilizzato per i servizi Web OData v4. Ulteriori informazioni: Configurazione, requisiti e procedure consigliate per il Provider dati OData v4
Aggiungere un campo protetto a un'origine dati
I campi per un'origine dati vengono creati come qualsiasi altra entità. Per i dati crittografati o sensibili, abilitare l'attributo Segreto origine dati nel campo personalizzato dell'origine dati. Ad esempio, per proteggere un campo contenente una stringa di connessione al database.
Nota
L'attributo Segreto origine dati è disponibile solo con campi aggiunti a un modulo Origine dati.
Creare un'entità virtuale
Un'entità virtuale viene creata come qualsiasi altra entità in Customer Engagement con l'aggiunta di alcuni attributi ulteriori descritti di seguito.
Nota
Benché sia possibile creare un'entità virtuale selezionando Nessuno come origine dati, per acquisire i dati un'entità virtuale richiede un'origine dati. Ulteriori informazioni: Aggiungere un'origine dati da utilizzare per le entità virtuali
Vai a Impostazioni>Personalizzazione>Personalizza il sistema.
In Esplora soluzioni, creare una nuova entità. A tale scopo, nel riquadro di navigazione a sinistra, seleziona Entità e quindi Nuovo.
Nella scheda Generale della Definizione dell'entità, seleziona Entità virtuale, quindi nell'elenco a discesa Origine dati, selezionare l'origine dati desiderata.
Durante la definizione dell'entità, compilare i seguenti campi obbligatori.
Nome esterno. Immettere il nome della tabella nell'origine dati esterna a cui l'entità è mappata.
Nome raccolta esterno. Immettere il nome plurale della tabella nell'origine dati esterna a cui l'entità è mappata.
Di seguito viene riportato un esempio di un'entità virtuale denominata Film che utilizza un provider di dati Azure Cosmos DB per accedere ai file del documento.
Importante
Molte opzioni, ad esempio Team di accesso, Code e Creazione rapida, non sono disponibili con le entità virtuali. Ulteriori informazioni: Considerazioni sull'utilizzo delle entità virtuali
Completare le proprietà obbligatorie e facoltative aggiuntive, come visualizzazione e nomi plurali, in base alle esigenze. Per ulteriori informazioni su queste proprietà, vedere Creare e modificare entità.
Creare e aggiungere uno o più campi per l'entità virtuale. Oltre alle proprietà dei campi standard necessarie per creare un campo personalizzato, sono disponibili queste proprietà facoltative per ogni campo personalizzato creato per un'entità virtuale.
- Nome esterno. Corrisponde in genere al nome univoco per identificare i dati da visualizzare nel campo.
Nota
Se il tipo di campo creato è OptionSet, sono disponibili i seguenti campi aggiuntivi.
- Nome tipo esterno. Questa proprietà esegue il mapping al nome esterno del set di valori nel servizio esterno per il set di opzioni. In genere, questo può essere un valore di enumerazione o il nome di una classe di valore stringa. La funzionalità Nome tipo esterno può essere utilizzata quando il nome completo è obbligatorio. Ad esempio, il Nome tipo con OData dove i parametri di una query richiedono il nome completo, come [Nome tipo].[Valore].
- Valore esterno. Questa proprietà esegue il mapping al valore corrispondente nell'origine dati esterna per l'elemento del set di opzioni. Il valore immesso viene utilizzato per determinare quale elemento del set di opzioni visualizzare nell'app.
Completare le proprietà aggiuntive in base alle esigenze. Per ulteriori informazioni su queste proprietà, vedere Creare e modificare campi.
Seleziona Salva e chiudi nella pagina delle proprietà Campo.
Nella barra degli strumenti Esplora soluzione, seleziona Salva.
Nella barra degli strumenti Esplora soluzione, seleziona Pubblica.
Chiudere Esplora soluzioni.
Considerazioni sull'utilizzo delle entità virtuali
Le entità virtuali hanno queste limitazioni.
Tutte le entità virtuali sono di sola lettura.
Le entità esistenti non possono essere convertite in entità virtuali.
Per impostazione predefinita, le entità virtuali contengono solo un campo Nome e ID. Non sono supportati altri campi gestiti dal sistema, come Stato o Data di creazione/modifica.
Le entità virtuali non supportano campi personalizzati con i tipi di dati Valuta, Immagine o Cliente.
Le entità virtuali non supportano il controllo.
I campi delle entità virtuali non possono essere utilizzati in campi rollup o calcolati.
Un'entità virtuale non può essere un tipo di impegno di entità.
Molte funzionalità che influiscono sulle righe della tabella dell'entità non possono essere abilitate con le entità virtuali. Alcuni esempi includono le code, la gestione delle informazioni, i contratti di servizio, il rilevamento duplicati, la registrazione delle modifiche, la funzionalità Mobile Offline, la sicurezza dei campi, la Ricerca per pertinenza, i portali per le soluzioni per portali Web di Dynamics 365 Customer Engagement (on-premises) e le relazioni N:N tra entità virtuali.
Le entità virtuali sono di proprietà dell'organizzazione e non supportano i concetti di sicurezza Common Data Service per le app a livello di riga. È consigliabile implementare un modello di sicurezza personale per l'origine dati esterna.
È consigliabile cercare una sola origine dati quando si utilizzanono le entità virtuali nelle ricerche avanzate. Ad esempio, non è supportata la creazione di una ricerca avanzata che genera un'unione tra i dati nativi Dataverse e i dati esterni dell'entità virtuale.
Le proprietà dei metadati di campo che vengono convalidate all'aggiornamento non si applicano alle entità virtuali. Ad esempio, un campo Numero intero sul campo di un'entità virtuale potrebbe essere impostato per avere un valore minimo pari a zero. Tuttavia, poiché il valore proviene da un'origine dati esterna, una query restituirà valori inferiori a zero se recuperata da un'entità virtuale. La proprietà del valore minimo non è implicita nella query. Potrebbe essere comunque necessario filtrare i valori in modo che siano maggiori di 0, se si desidera eseguire tale operazione.
Le entità virtuali non supportano la registrazione delle modifiche e non possono essere sincronizzate utilizzando una funzionalità di Customer Engagement, ad esempio il Servizio di esportazione dati.
I processi aziendali non sono supportati con le entità virtuali. Maggiori informazioni: Errore imprevisto ricevuto quando un utente attiva un processo aziendale
Errore imprevisto ricevuto quando un utente attiva un processo aziendale
Quando un utente tenta di attivare un processo aziendale, potrebbe ricevere un messaggio di "errore imprevisto". Visualizzando il file di registro viene visualizzata la seguente voce di registro.
ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: l'ccezione di tipo 'System.Web.HttpUnhandledException' è stata generata. ---> Microsoft.Crm.CrmException: il processo aziendale non può essere abilitato per l'entità virtuale
Questo problema si verifica perché le entità virtuali non supportano i processi aziendali.
Vedi anche
Requisiti e procedure consigliate per il Provider dati OData v4
Creare e modificare le entità
Creare e modificare campi