Sincronizzare i dati di Dynamics 365 con sistemi esterni

Articolo
03/03/2017

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Talvolta sarà necessario sincronizzare e integrare i dati di Microsoft Dynamics 365 con i dati archiviati in altri sistemi. I modelli di integrazione dati comuni includono il recupero dei dati dal sistema esterno e il loro push in Dynamics 365, il recupero dei dati da Dynamics 365 e la loro sincronizzazione con un archivio di dati esterno o l'aggiornamento di Dynamics 365 con dati esterni, in sicurezza senza perdere dati. Ora puoi utilizzare diverse nuove funzionalità per poter utilizzare la scrittura del codice in questi scenari con maggiore facilità.

Queste nuove funzionalità possono essere utilizzate separatamente secondo le necessità in qualsiasi situazione, ma insieme risolvono i problemi noti correlati alla sincronizzazione e all'integrazione dei dati con dati esterni. Nella seguente tabella sono illustrate queste nuove funzionalità.

Funzionalità di	Descrizione
Rimozione di messaggi specializzati	Microsoft Dynamics 365 include una serie di messaggi specializzati per operazioni specifiche che aggiornano i record. Questi messaggi sono deprecati in questa versione e ora devi semplicemente utilizzare Update per eseguire le stesse operazioni. I messaggi deprecati sono: Assign SetParentSystemUser SetParentTeam SetParentBusinessUnit SetBusinessEquipment SetBusinessUnit SetState L'aggiornamento del record è un metodo molto più semplice rispetto all'utilizzo di questi messaggi e ottimizza lo sviluppo per gli scenari di sincronizzazione e integrazione dei dati.Ulteriori informazioni:Eseguire operazioni specializzate utilizzando l'aggiornamento
Chiavi alternative	Nelle distribuzioni aziendali di Microsoft Dynamics 365 che i dati di sistemi aziendali esterni vengano caricati in Microsoft Dynamics 365 in modo da poter essere presentati agli utenti. Questi sistemi esterni spesso non possono essere estesi per archiviare gli identificatori di record di Dynamics 365, noti come GUID, necessari per la sincronizzazione del sistema. Una soluzione comune consiste nell'aggiungere un attributo personalizzato a un'entità in Microsoft Dynamics 365 che può essere utilizzata per archiviare l'identificatore del record correlato nel sistema esterno. Quando si compilano processi di caricamento dei dati che aggiornano i record in Microsoft Dynamics 365 e assegnano i riferimenti ai record correlati di Dynamics 365, devi prima eseguire una chiamata aggiuntiva del servizio Web di Dynamics 365 per recuperare il record Dynamics 365 di destinazione sulla base dell'identificatore esterno. Questa ricerca può essere lenta se non è disponibile un indice appropriato per l'attributo personalizzato e negli scenari Dynamics 365 (online) queste ricerche richiedono un round trip costoso in Internet. Questi round trip aggiuntivi possono aumentare secondo un ordine di grandezza il tempo necessario per aggiornare ogni record Dynamics 365 e possono ridurre drasticamente la velocità effettiva globale. Ora le operazioni del servizio Web possono riguardare un record Dynamics 365 mediante una o più chiavi alternative al posto di un GUID. Inoltre, i riferimenti di entità ai record correlati possono essere specificati mediante una o più chiavi alternative. Poiché le chiavi alternative sono indicizzate, le operazioni di ricerca mostrano prestazioni migliorate rispetto all'aggiunta di un attributo personalizzato come identificatore. Se si verifica un problema, il sistema genera un errore ed esegue il rollback di tutte le modifiche.Ulteriori informazioni:Definire le chiavi alternative per un'entità
Registrazione modifiche	Quando le organizzazioni devono gestire i dati di Dynamics 365 in un archivio esterno, ora è disponibile un modo per mantenere i dati sincronizzati in modalità ad alte prestazioni tramite il rilevamento dei dati modificati dopo l'estrazione iniziale o l'ultima sincronizzazione. Il messaggio RetrieveEntityChangesRequest è utilizzato per recuperare le modifiche per un'entità. Per ulteriori informazioni, vedere Utilizzare il rilevamento delle modifiche per sincronizzare i dati con sistemi esterni.
Upsert	Quando si caricano i dati in Microsoft Dynamics 365 da un sistema esterno, non puoi sapere se un record esiste già in Dynamics 365 e deve essere aggiornato o se devi creare un nuovo record. Utilizza il nuovo messaggio UpsertRequest per aggiornare il record se esiste o per creare un nuovo record se non esiste, in una chiamata API.Ulteriori informazioni:Utilizzare Upsert per inserire o aggiornare un record

Nella tabella seguente viene confrontata la complessità della sincronizzazione con e senza queste nuove funzionalità.

Prima	Descrizione
	Per ogni record: Query su Dynamics 365 per verificare se l'account esiste. Se presente, ottieni il relativo ID account (ad esempio ABC123) Query sui contatti per verificare che il contatto esista. Se presente, ottieni l'ID e-mail del contatti (ad esempio contact@company.com). Query per ottenere o impostare l'ID dell'area (ad esempio, NW). Query per ottenere l'ID utente per impostare il proprietario (ad esempio user@mycompany.com) Aggiorna l'account. Imposta lo stato dell'account tramite la chiamata all'API SetState. Assegna il proprietario tramite la chiamata all'API Assign.

Aggiornamento tramite messaggi specializzati

Per ogni record:

Query su Dynamics 365 per verificare se l'account esiste. Se presente, ottieni il relativo ID account (ad esempio ABC123)
Query sui contatti per verificare che il contatto esista. Se presente, ottieni l'ID e-mail del contatti (ad esempio contact@company.com).
Query per ottenere o impostare l'ID dell'area (ad esempio, NW).
Query per ottenere l'ID utente per impostare il proprietario (ad esempio user@mycompany.com)
Aggiorna l'account.
Imposta lo stato dell'account tramite la chiamata all'API SetState.
Assegna il proprietario tramite la chiamata all'API Assign.

Ora, con le nuove funzionalità, è sufficiente una sola chiamata al server per eseguire le stesse operazioni mostrate in precedenza.

Dopo	Descrizione
	Solo una chiamata per verificare che è presente un account con l'ID univoco ABC123, impostare il contatto primario su contact@company.com, impostare la regione su NW, impostare il proprietario su user@mycompany.com e lo stato su attivo.