Connettersi a Microsoft Dataverse

Nota

Azure Active Directory è ora Microsoft Entra ID. Altre informazioni

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 società Business Central possono connettersi a un ambiente Dataverse che ha una valuta di base diversa dalla valuta locale. Per ulteriori informazioni su come gestire configurazioni multivaluta, vedi Consentire 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 stai utilizzando Business Central locale e non stai utilizzando un account Microsoft Entra per connetterti a 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 gli ambienti Business Central e Dataverse , non solo otterrai tali considerazioni, ma offrirai anche ai tuoi amministratori un modo più semplice per creare e gestire le tue integrazioni con altre app Dynamics 365.

Nell'interfaccia di amministrazione di Business Central, puoi collegare il tuo ambiente Business Central al tuo ambiente Dataverse. Business Central può utilizzare le informazioni del collegamento per rendere più semplice e sicura l'integrazione con altre app Dynamics 365, come Sales e Field Service. Ad esempio, l'URL dell'ambiente Dataverse collegato è disponibile per impostazione predefinita nella pagina Setup connessione Dataverse e quando esegui la guida al setup assistito Setup connessione Dataverse.

Consentire valute diverse

Le società Business Central possono connettersi a un ambiente Dataverse che ha una valuta di base diversa dalla valuta locale.

Nota

La sincronizzazione di più valute richiede l'utilizzo di una sincronizzazione unidirezionale, da Business Central a Dataverse.

Per ulteriori informazioni sulla valuta di base in Dataverse, vedi Entità della valuta (valuta) di transazione.

Per ulteriori informazioni sulle valute in Business Central, vedi Valute in Business Central.

Per consentire valute diverse, prima di connetterti, assicurati di aver specificato le seguenti impostazioni:

• L'impostazione della valuta della transazione di base in Dataverse ha il codice valuta specificato nella pagina Valute in Business Central.
• Esiste almeno un tasso di cambio specificato per la valuta in Business Central nella pagina Tassi di cambio valuta.

Quando abiliti la connessione a Dataverse, Business Central aggiunge la valuta locale all'entità Valuta in Dataverse. La valuta locale utilizza il tasso di cambio indicato nel 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 nella valuta di base Dataverse, gli importi vengono convertiti nella valuta locale Business Central in base all'ultimo tasso di cambio sincronizzato da Business Central.
• Se nella valuta locale Business Central, gli importi si sincronizzano con la valuta locale Business Central in una delle altre valute non di base in Dataverse.

Impostazione 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:

• L'autorizzazione di accesso a Dataverse come utente corrente è necessaria affinché Business Central possa, per conto dell'amministratore, creare automaticamente un utente dell'applicazione di integrazione Business Central senza licenza e non interattivo, assegnare ruoli di sicurezza a tale utente e distribuire la soluzione di integrazione Business Central in Dataverse. Questa autorizzazione viene utilizzata una sola volta durante il setup della connessione a Dataverse.
• L'autorizzazione Accesso completo a Dynamics 365 Business Central è necessaria in modo che l'utente dell'applicazione Business Central Integration creato automaticamente possa accedere ai dati di Business Central che verranno sincronizzati.
• L'autorizzazione Accedi e leggi il profilo è necessaria per verificare che l'accesso dell'utente abbia effettivamente assegnato il ruolo di sicurezza 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.

1. Scegli l'icona a forma di immetti Setup assistito, quindi scegli il collegamento correlato.
2. Scegliere Impostare una connessione a Microsoft Dataverse per avviare la guida al setup assistito.
3. Compilare 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.

1. Scegli la immetti Setup connessione a Dataverse, quindi scegli il collegamento correlato.

2. Immettere le seguenti informazioni per la connessione da Business Central a Dataverse.

   Campo	Descrizione
   URL ambiente	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.

3. 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.

4. 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.

5. 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 link 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.

Suggerimento

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 è rilevante solo per i locatari online Business Central che sono 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

1. 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.
2. Scegli Connessione, poi Usa autenticazione certificato per aggiornare la connessione e utilizzare l'autenticazione basata su certificato.
3. 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 on-premises 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, vedi Avvio rapido: registrare un'applicazione con la piattaforma di identità Microsoft.

1. Nel portale di Azure, in Gestisci nel riquadro di navigazione, selezionare Autenticazione.

2. In URL di reindirizzamento, aggiungere l'URL di reindirizzamento suggerito nella pagina Setup connessione a Dataverse in Business Central.

3. In Gestisci, scegliere Autorizzazioni API.

4. 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.

5. In Gestisci, scegliere Certificati e segreti, quindi creare un nuovo segreto per l'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.

6. 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.

7. In Business Central, nella pagina Setup connessione a Dataverse nel campo URL ambiente inserire l'URL per l'ambiente Dataverse.

8. Per abilitare la connessione a Dataverse, attivare l'interruttore Abilitato.

9. Accedere con l'account amministratore per Microsoft Entra ID (questo account deve avere una licenza valida per Dataverse ed essere un amministratore nell'ambiente Dataverse). 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, consentire i popup da https://login.microsoftonline.com.

Per disconnettersi da Dataverse

1. Scegli l'icona a forma di immetti Setup connessione a Dataverse, quindi scegli il collegamento correlato.
2. Nella pagina Setup connessione a Dataverse, disattiva l'opzione Abilitato.

Vedere anche

Visualizzare lo stato di una sincronizzazione

I moduli di e-learning gratuiti per Business Central sono disponibili qui