Connettersi a Microsoft Dataverse
Nota
Azure Active Directory è ora Microsoft Entra ID. Saperne di più
Questo articolo descrive come impostare una connessione tra Business Central e Dataverse. In genere, le aziende creano la connessione per integrare e sincronizzare i dati con un'altra app aziendale di Dynamics 365, ad esempio Dynamics 365 Sales.
Operazioni preliminari
Prima di creare la connessione, è necessario disporre di alcune informazioni:
- L'URL per l'ambiente Dataverse a cui vuoi connetterti. Se usi la guida setup assistito Setup connessione a Dataverse per creare la connessione troveremo i tuoi ambienti. Puoi anche inserire l'URL di un altro ambiente nel tenant.
- Il nome utente e la password di un account che dispone di autorizzazioni di amministratore in Business Central e Dataverse.
- Se disponi del primo ciclo di rilascio del 2020 di Business Central locale, versione 16.5, leggi l'articolo Alcuni problemi noti. Dovrai completare la soluzione alternativa descritta prima di poter creare la connessione a Dataverse.
- Le valute locali utilizzate da ciascuna società. Le aziende Business Central possono Connetti in un Dataverse ambiente con una valuta di base diversa dalla loro valuta locale. Per saperne di più su come gestire le configurazioni multi-valuta, vai a Consenti valute diverse.
Importante
L'ambiente Dataverse non deve essere in modalità di amministrazione. La modalità di amministrazione causerà la mancata connessione perché l'account utente di integrazione per la connessione non dispone delle autorizzazioni di amministratore. Per ulteriori informazioni, vedere Modalità di amministrazione.
Nota
Tali passaggi descrivono la procedura per Business Central Online. Se utilizzi Business Central in locale e non utilizzi un Microsoft Entra account per Connetti per Dataverse, devi anche specificare un nome utente e una password di un account utente per l'integrazione. Questo account viene definito account "utente integrazione". Se stai usando un account Microsoft Entra l'account utente di integrazione non è richiesto o visualizzato. L'utente dell'integrazione verrà impostato automaticamente e non richiede una licenza.
Collegare gli ambienti Business Central e Dataverse
Le aziende desiderano mantenere i propri dati al sicuro e protetti entro i limiti della privacy, soprattutto quando la loro applicazione di gestione aziendale si integra con altre app. Collegando Business Central e gli ambienti, non solo soddisferai queste esigenze, ma offrirai anche ai tuoi amministratori un modo più semplice per creare e gestire le tue integrazioni con altre app Dynamics 365. Dataverse
Nel Business Central interfaccia di amministrazione, puoi collegare il tuo Business Central ambiente nel tuo Dataverse ambiente. Business Central può utilizzare le informazioni contenute in collegare per semplificare e rendere più sicura l'integrazione con altre app Dynamics 365, come Sales e Field Service. Ad esempio, l'URL collegato Dataverse ambiente è disponibile per impostazione predefinita nella pagina Dataverse Configurazione connessione e quando si esegue la configurazione assistita Dataverse Configurazione connessione guida.
Consentire valute diverse
Le aziende Business Central possono Connetti in un Dataverse ambiente con una valuta di base diversa dalla loro valuta locale.
Nota
Per sincronizzare più valute è necessario utilizzare una sincronizzazione unidirezionale, da Business Central a Dataverse.
Per saperne di più sulla valuta di base in Dataverse, vai a Entità Valuta di transazione (valuta).
Per saperne di più sulle valute in Business Central, vai a Valute in Business Central.
Per consentire valute diverse, prima di connetterti, assicurati di aver specificato le seguenti impostazioni:
- L'impostazione della valuta di base della transazione in Dataverse ha il codice valuta specificato nella pagina Valute in Business Central.
- Nella pagina Tassi di cambio delle valute di Business Central è specificato almeno un tasso di cambio per la valuta.
Quando si abilita la connessione a Dataverse, Business Central aggiunge il suo valuta locale all'entità Currency in Dataverse. Valuta locale utilizza il tasso di cambio dal campo Fattore valuta nella pagina Tassi di cambio valuta .
Poiché la sincronizzazione della valuta è unidirezionale, da Business Central a Dataverse, gli importi monetari vengono convertiti e sincronizzati come segue:
- Se espressi nella valuta di base, gli importi vengono convertiti nella valuta valuta locale di Business Central in base all'ultimo tasso di cambio sincronizzato da Business Central. Dataverse
- Se nel Business Central valuta locale, gli importi vengono sincronizzati con il Business Central valuta locale in una delle valute aggiuntive non di base in Dataverse.
Imposta una connessione a Dataverse
Per tutti i tipi di autenticazione diversi dall'autenticazione di Microsoft 365, imposti la connessione a Dataverse nella pagina Setup connessione a Dataverse. Per l'autenticazione di Microsoft 365, è consigliabile utilizzare la guida del setup assistito Setup connessione a Dataverse. La guida rende più semplice configurare la connessione e specificare le funzionalità avanzate, ad esempio il modello di proprietà e la sincronizzazione iniziale.
Importante
Durante il setup della connessione a Dataverse, all'amministratore verrà chiesto di concedere le autorizzazioni seguenti per un'applicazione Azure registrata denominata Business Central Integration a Dataverse:
- È necessaria l'autorizzazione Access Dataverse come preferisci affinché Business Central possa, per conto dell'amministratore, creare automaticamente un utente dell'applicazione Business Central Integration non interattiva e senza licenza, assegnare ruoli di sicurezza a tale utente e distribuire Business Central Integration Solution a Dataverse. Questa autorizzazione viene utilizzata una sola volta durante il setup della connessione a Dataverse.
- È necessario avere accesso completo all'autorizzazione Dynamics 365 Business Central affinché l'utente dell'applicazione Business Central Integration creata automaticamente possa accedere ai dati Business Central che verranno sincronizzati.
- accedi e leggi il tuo profilo l'autorizzazione è necessaria per verificare che all'utente che effettua l'accesso sia effettivamente assegnato il ruolo di sicurezza di amministratore di sistema in Dataverse.
Fornendo il consenso per conto dell'organizzazione, l'amministratore autorizza l'applicazione Azure registrata chiamata Business Central Integration per Dataverse a sincronizzare i dati usando le credenziali dell'utente dell'applicazione Business Central Integration creato automaticamente.
Utilizzare la guida al setup assistito Setup connessione a Dataverse
La guida Setup connessione a Dataverse può semplificare la connessione delle applicazioni e può persino aiutarti a eseguire una sincronizzazione iniziale. Se scegli di eseguire la sincronizzazione iniziale, Business Central esaminerà i dati in entrambe le applicazioni e fornirà suggerimenti sulla sincronizzazione iniziale. Nella seguente tabella vengono illustrati i suggerimenti.
| Suggerimento | Descrizione |
|---|---|
| Sincronizzazione completa | I dati esistono solo in Business Central o solo in Dataverse. Il suggerimento è di sincronizzare tutti i dati dal servizio in cui si trovano all'altro servizio. |
| Nessuna sincronizzazione | I dati esistono in entrambe le applicazioni e l'esecuzione della sincronizzazione completa duplicherebbe i dati. Il suggerimento è di associare i record. |
| Dipendenza non soddisfatta | I dati esistono in entrambe le applicazioni, ma la riga o la tabella non possono essere sincronizzate perché dipende da una riga o da una tabella con il suggerimento Nessuna sincronizzazione. Ad esempio, se i clienti non possono essere sincronizzati, non è possibile sincronizzare neanche i dati per i contatti che dipendono dai dati del cliente. |
Importante
In genere, utilizzi la sincronizzazione completa solo quando si integrano le applicazioni per la prima volta e solo un'applicazione contiene dati. La sincronizzazione completa può essere utile in un ambiente dimostrativo perché crea e associa automaticamente i record in ciascuna applicazione, il che rende più veloce iniziare a lavorare con i dati sincronizzati. Tuttavia, devi eseguire la sincronizzazione completa solo se desideri una riga in Business Central per ogni riga in Dataverse per i mapping di tabella. In caso contrario, il risultato può essere record duplicati.
- Selezionare l'icona
, immettere Configurazione assistita, quindi selezionare il file collegare correlato. - Scegliere Impostare una connessione a Microsoft Dataverse per avviare la guida al setup assistito.
- Compila i campi in base alle esigenze.
Nota
Se non viene richiesto di accedere con il proprio account amministratore, è probabile che i popup siano bloccati. Per accedere, consentire i popup da https://login.microsoftonline.com.
Per creare o gestire la connessione manualmente
La procedura seguente illustra come configurare la connessione manualmente nella pagina Setup connessione a Dataverse. La pagina Setup connessione a Dataverse è dove gestisci le impostazioni di integrazione.
Selezionare l'icona
, immettere Dataverse Configurazione connessione, quindi scegliere il file collegare correlato.Immettere le seguenti informazioni per la connessione da Business Central a Dataverse.
Campo Descrizione ambiente URL Se sei proprietario di ambienti in Dataverse, li troveremo per te quando esegui la guida al setup. Se desideri connetterti a un altro ambiente in un altro tenant, puoi immettere le credenziali di amministratore per l'ambiente e verranno individuate. Abilitato Iniziare a utilizzare l'integrazione. Se non abiliti la connessione subito, le impostazioni di connessione verranno salvate, ma gli utenti non potranno accedere ai dati di Dataverse da Business Central. È possibile tornare a questa pagina e abilitare la connessione in un secondo momento. Nel campo Modello proprietà, scegli se vuoi che una tabella team in Dataverse sia proprietaria di nuovi record o uno o più utenti specifici. Se scegli Persona, devi specificare ciascun utente. Se scegli Team, la Business Unit predefinita verrà visualizzata nel campo Business Unit associata.
Per verificare le impostazioni di connessione, scegli Connessione, quindi Test connessione.
Nota
Se la crittografia dei dati non è abilitata in Business Central, verrà richiesto se si desidera abilitarla. Per abilitare la crittografia dei dati, scegliere Sì e immettere le informazioni necessarie. In caso contrario, scegliere No. È possibile abilitare la crittografia dei dati in un secondo momento. Per ulteriori informazioni, vedere Crittografia di dati in Dynamics 365 Business Central nella Guida per sviluppatori e amministratori.
Se la sincronizzazione di Dataverse non è ancora impostata, verrà richiesto se si desidera utilizzare l'impostazione di sincronizzazione predefinita. A seconda se si desidera conservare o meno i record allineati in Dataverse e Business Central scegliere Sì o No.
Personalizzare l'accoppiamento basato sulla corrispondenza
A partire dal secondo ciclo di rilascio del 2021, un amministratore può immettere i criteri per abbinare i record in base alle corrispondenze. Puoi avviare l'algoritmo per la corrispondenza dei record dai seguenti punti in Business Central:
Elenca le pagine che mostrano i record sincronizzati con Dataverse, come le pagine Clienti e Articoli.
Seleziona più record, quindi scegli l'azione Correlato, scegli Dataverse, scegli Accoppiamentoe poi scegli Accoppiamento basato sulla corrispondenza.
Quando il processo di accoppiamento basato sulla corrispondenza è avviato da un elenco di dati master, un lavoro di accoppiamento sarà programmato subito dopo aver selezionato i criteri di accoppiamento.
Il Dataverse Full Synch. Pagina direvisione .
Quando il processo di sincronizzazione completa rileva che hai disaccoppiato i record sia in Business Central che in Dataverse, appare un collegamento Seleziona criteri di accoppiamento per la relativa tabella di integrazione.
Puoi iniziare il processo Esegui sincronizzazione completa dalle pagine Setup connessione a Dataverse e Setup connessione a Dynamics 365. Puoi anche avviarlo nella guida setup assistito Impostare una connessione a Dataverse al termine del setup.
Quando il processo di accoppiamento basato sulla corrispondenza viene avviato dalla pagina Revisione sincronizzazione completa Dataverse, un processo di accoppiamento sarà programmato subito dopo aver completato il setup.
L'elenco delle mappature delle tabelle di integrazione .
Seleziona una mappatura, scegli l'azione Coupling e poi scegli Accoppiamento basato su corrispondenza.
Quando il processo di accoppiamento basato sulla corrispondenza viene avviato da una mappatura della tabella di integrazione, un processo di accoppiamento verrà eseguito per tutti i record non accoppiati in quella mappatura. È inoltre possibile selezionare i record non accoppiati nell'elenco per eseguire il processo solo per tali record.
In tutti e tre i casi, la pagina Select Coupling Criteria si apre in modo da poter definire i criteri di accoppiamento pertinenti. In questa pagina, personalizza l'accoppiamento con i seguenti compiti:
Scegli i campi da utilizzare per la corrispondenza dei record Business Central con le entità Dataverse. Puoi specificare se la corrispondenza fa distinzione tra maiuscole e minuscole.
Specifica se eseguire la sincronizzazione dopo aver accoppiato i record. Se i record utilizzano la mappatura bidirezionale, puoi anche specificare cosa succede se i conflitti sono elencati nella pagina Risolvi conflitti di aggiornamento.
Dare priorità all'ordine di ricerca dei record specificando una priorità di corrispondenza per i campi di mappatura pertinenti. Business Central cercherà una corrispondenza in ordine crescente in base al valore nel campo Priorità corrispondenza. Un valore vuoto nel campo Priorità corrispondenza equivale alla priorità 0, che è la priorità più alta. I campi con priorità 0 vengono considerati per primi.
Specifica se creare una nuova istanza di entità in Dataverse nel caso in cui non sia possibile trovare una corrispondenza unica non accoppiata utilizzando i criteri di corrispondenza. Per attivare questa capacità, scegli l'azione Crea nuovo se non si trova accoppiamento .
Visualizza i risultati del lavoro di accoppiamento
Per visualizzare i risultati del lavoro di accoppiamento, aprire la pagina Mappatura tabella integrazione, selezionare la mappatura pertinente, scegliere l'azione Accoppiamento e poi scegliere l'azione Registro lavoro accoppiamento integrazione .
Se i record non si sono accoppiati, puoi scegliere il valore nella colonna Non completato per aprire un elenco di errori che descrivono il motivo per cui ciò è accaduto.
In genere, l'accoppiamento non riesce per i seguenti motivi:
Non è stato definito alcun criterio di corrispondenza
Esegui di nuovo l'accoppiamento basato sulla corrispondenza, ma ricordati di definire i criteri di accoppiamento.
Non è stata trovata alcuna corrispondenza per i campi specificati nei criteri di corrispondenza
Ripeti l'accoppiamento utilizzando diversi campi.
Sono state trovate più corrispondenze per diversi record, in base ai campi specificati nei criteri di corrispondenza
Ripeti l'accoppiamento utilizzando diversi campi.
È stata trovata una corrispondenza, ma il record è già accoppiato a un record in Business Central
Ripeti l'accoppiamento usando campi differenti o indaga perché quell'entità Dataverse è accoppiata a quel record in Business Central.
Gratifica
Per aiutarti ad avere una panoramica sul progresso dell'accoppiamento, il campo Associato a Dataverse mostra se un record è accoppiato a un'entità Dataverse. Puoi usare il campo Associato a Dataverse per filtrare l'elenco dei record che stai sincronizzando.
Aggiornare le connessioni da Business Central Online per utilizzare l'autenticazione basata su certificato
Nota
Questa sezione è pertinente solo per i tenant di Business Central online ospitati da Microsoft. I tenant online ospitati dagli ISV e le installazioni locali non sono interessati.
Ad aprile 2022, Dataverse depreca il tipo di autenticazione di Office365 (nome utente/password). Per ulteriori informazioni, vedi Deprecazione del tipo di autenticazione Office365. Inoltre, a marzo 2022, Business Central depreca l'uso dell'autenticazione da servizio a servizio basata sul segreto client per i tenant online. È necessario utilizzare l'autenticazione da servizio a servizio basata su certificato per le connessioni a Dataverse. I tenant Business Central Online ospitati da ISV e le installazioni locali possono continuare a utilizzare i segreti client per l'autenticazione.
Per evitare di interrompere le integrazioni, devi aggiornare la connessione per utilizzare l'autenticazione basata su certificato. Sebbene la modifica sia prevista per marzo 2022, ti consigliamo vivamente di eseguire l'upgrade il prima possibile. I passaggi seguenti descrivono come eseguire l'aggiornamento all'autenticazione basata su certificato.
Per aggiornare la connessione di Business Central online per utilizzare l'autenticazione basata su certificato
- A seconda dell'integrazione o meno con Dynamics 365 Sales, esegui una delle seguenti operazioni:
- Se integri, apri la pagina Setup connessione a Microsoft Dynamics 365.
- In caso contrario, apri la pagina Setup connessione a Dataverse.
- Scegli Connessione, poi Usa autenticazione certificato per aggiornare la connessione e utilizzare l'autenticazione basata su certificato.
- Accedi con le credenziali di amministratore per Dataverse. L'accesso dovrebbe richiedere meno di un minuto.
Nota
Devi ripetere questi passaggi in ciascun ambiente Business Central, compresi gli ambienti di produzione e sandbox, e in ogni azienda per cui hai una connessione a Dataverse.
Connessione alle versioni locali
Per connettere Business Central locale a Dataverse, è necessario specificare alcune informazioni nella pagina Setup connessione a Dataverse.
Per connettersi usando un account Microsoft Entra, devi registrare un'applicazione in Microsoft Entra ID. Dovrai fornire l'ID applicazione, il segreto del key vault e l'URL di reindirizzamento da usare. L'URL di reindirizzamento è precompilato e dovrebbe funzionare per la maggior parte delle installazioni. È necessario configurare l'installazione per utilizzare HTTPS. Per ulteriori informazioni, vedere Configurazione di SSL per proteggere la connessione client Web di Business Central. Se stai configurando il server in modo da avere una home page diversa, puoi cambiare l'URL. Il segreto del client verrà salvato come stringa crittografata nel database.
Per registrare un'applicazione in Microsoft Entra ID per la connessione da Business Central a Dataverse
I seguenti passaggi presuppongono che si stia utilizzando Microsoft Entra ID per gestire identità e accesso. Per ulteriori informazioni sulla registrazione di un'applicazione in Microsoft Entra ID, vedere Guida introduttiva: registrare un'applicazione con la piattaforma di identità Microsoft.
Nel portale di Azure, in Gestisci nel riquadro di navigazione, selezionare Autenticazione.
In URL di reindirizzamento, aggiungere l'URL di reindirizzamento suggerito nella pagina Setup connessione a Dataverse in Business Central.
In Gestisci, scegliere Autorizzazioni API.
In Autorizzazioni configurate, scegliere Aggiungi un'autorizzazione e quindi aggiungere le autorizzazioni delegate nella scheda API Microsoft come segue:
- Per Business Central, aggiungere le autorizzazioni Financials.ReadWrite.All.
- Per Dynamics CRM, aggiungere le autorizzazioni user_impersonation.
Nota
Il nome dell'API Dynamics CRM potrebbe cambiare.
In Gestisci, scegli Certificati e segreti, quindi crea un nuovo segreto per la tua app. Il segreto viene utilizzato in Business Central, nel campo Segreto client della pagina Setup connessione a Dataverse o archiviato in un archivio sicuro e fornito in una sottoscrizione di eventi come descritto in precedenza in questo argomento.
Scegliere Panoramica, quindi trovare il valore ID applicazione (client). Questo ID è l'ID client dell'applicazione. È necessario inserirlo nella pagina Setup connessione a Dataverse nel campo ID client o archiviarlo in un archivio sicuro e fornirlo in una sottoscrizione di eventi.
In Business Central, nella pagina Setup connessione a Dataverse nel campo URL ambiente inserire l'URL per l'ambiente Dataverse.
Per abilitare la connessione a Dataverse, attivare l'interruttore Abilitato.
Accedi con il tuo account amministratore per Microsoft Entra ID (questo account deve avere una licenza valida per Dataverse ed essere un amministratore nel tuo Dataverse ambiente). Dopo aver effettuato l'accesso, verrà richiesto di consentire all'applicazione registrata l'accesso a Dataverse per conto dell'organizzazione. È necessario fornire il consenso per completare il setup.
Nota
Se non viene richiesto di accedere con l'account amministratore, è probabile che i popup siano bloccati. Per accedere, consenti i popup da
https://login.microsoftonline.com.
Per disconnettersi da Dataverse
- Selezionare l'icona , immettere Dataverse Configurazione connessione, quindi scegliere il file collegare correlato.
- Nella pagina Setup connessione a Dataverse, disattiva l'opzione Abilitato.
Vedere anche
Visualizza lo stato di una sincronizzazione
Trova qui moduli di e-learning gratuiti per Business Central