Mapping delle tabelle e dei campi da sincronizzare

La base della sincronizzazione dei dati consiste nel mapping delle tabelle e dei campi in Business Central con tabelle e colonne in Dataverse, di modo che possano scambiarsi i dati. Il mapping avviene tramite tabelle di integrazione.

Mappatura delle tabelle di integrazione

La tabella di integrazione è una tabella del database di Business Central che rappresenta una tabella, ad esempio un account, in Dataverse. Le tabelle di integrazione includono i campi corrispondenti alle colonne della tabella Dataverse. Ad esempio, la tabella di integrazione dell'account si collega alla tabella Account in Dataverse. Per ogni tabella nel Common Data Service (CDS) che si desidera sincronizzare con i dati in Business Central, deve esserci una corrispondente mappatura della tabella di integrazione.

Quando si crea la connessione tra le app, Business Central imposta alcuni mapping predefiniti. È possibile modificare i mapping di tabella se necessario. Per altre informazioni, vedere Mapping di tabelle standard per la sincronizzazione. Se sono stati modificati i mapping predefiniti e si desidera annullare le modifiche, nella pagina Mappe di integrazione delle tabelle, scegliere Utilizza configurazione predefinita per la sincronizzazione.

Annotazioni

Se si utilizza una versione locale di Business Central, i mapping della tabella di integrazione sono memorizzati nella tabella 5335 Mapping tabella integrazione dove è possibile visualizzarli e modificarli. La mappatura e regole complessi di sincronizzazione vengono definiti nella codeunit 5341.

Suggerimento

Quando un record accoppiato cambia, Business Central sincronizza automaticamente i dati con Dataverse. La sincronizzazione automatica è ottima nella maggior parte dei casi. Tuttavia, le frequenti modifiche a grandi quantità di record accoppiati in una tabella possono rallentare la sincronizzazione dei dati.

Per evitare un rallentamento delle prestazioni, nella pagina Mapping tabelle di integrazione, puoi abilitare o disabilitare la sincronizzazione dei dati basata sugli eventi per qualsiasi tabella. Per impostazione predefinita, la sincronizzazione basata sugli eventi è attivata in modo che le integrazioni esistenti non siano interessate. L'amministratore può attivarla o disattivarla per tabelle specifiche.

Aggiungere i mapping di campi e tabelle alle tabelle di integrazione esistenti.

ANTEPRIMA: Questa funzionalità è disponibile in anteprima.

Nella pagina Mapping delle tabelle di integrazione, puoi utilizzare l'azione Nuovo mapping tabella per aggiungere nuovi mapping di tabella alle tabelle di integrazione. L'azione avvia la guida all'impostazione assistita Crea nuove mappature di integrazione, che aiuta a configurare nuove mappature di tabelle e campi di integrazione.

La guida consente di eseguire il mapping delle tabelle in Business Central con le tabelle di integrazione esistenti in Dataverse. È inoltre possibile specificare l'identificatore univoco della tabella di Dataverse in Nome identificatore univoco del campo tabella di integrazione e Nome del campo data ultima modifica della tabella di integrazione, necessari per il funzionamento della sincronizzazione dei dati.

Annotazioni

La ricerca nella colonna Tabella mostra tutte le tabelle business central, incluse le tabelle personalizzate, non ancora mappate. Vengono escluse le tabelle già esistenti nella pagina delle Mappature delle Tabelle di Integrazione.

In Business Central 2025 release wave 2 (v27.0) e versioni precedenti, la ricerca nella colonna Tabella di integrazione mostra solo tabelle dataverse (tabelle proxy AL) che fanno parte di integrazioni predefinite. Per aggiungere tabelle dataverse nuove o personalizzate, è necessario fornire assistenza a uno sviluppatore per crearli e distribuirli tramite un'estensione. A partire dalla versione 2026 wave 1 (v28), le nuove tabelle Dataverse e quelle personalizzate sono facilmente disponibili per il mapping dal riferimento nella colonna Tabella di integrazione.

L'azione Avanzate apre impostazioni di mappatura delle tabelle aggiuntive che è possibile configurare. Nella sezione Avanzate, il campo Filtro tabella consente di specificare i filtri per Business Central. Utilizza il campo Filtro tabella integrazione per i dati Dataverse da considerare nella sincronizzazione dei dati insieme ai codici del modello di configurazione in Codice modello di configurazione tabella e Codice modello di configurazione tabella integrazione per precompilare i dati mancanti quando nuovi dati provengono da una delle due applicazioni.

La guida ti aiuta anche a specificare i campi che vuoi che contenga il nuovo mapping. È possibile abbinare un campo Business Central nella colonna Nome campo con un nome campo Dataverse nella colonna Nome campo integrazione. È inoltre possibile specificare una Direzione, se il campo ha sempre lo stesso valore nella colonna Costante e se è necessario applicare convalide o trasformazioni durante il mapping dei campi.

Annotazioni

Nella versione 2025 wave 2 (v27.0) e precedenti, non è possibile eseguire il mapping di campi nuovi o personalizzati con la colonna Campo tabella di integrazione; questo è possibile nelle versioni successive. Inoltre, per ridurre gli errori, la ricerca per la colonna Campo tabella di integrazione filtra un elenco di campi disponibili. Per eseguire il mapping dei campi che i filtri non includono, è necessario assistenza da parte di uno sviluppatore.

  • I campi devono essere abilitati.
  • Non è possibile utilizzare la guida per eseguire il mapping dei campi FlowField e FlowFilter.
  • È possibile mappare solo campi di tipo BigInteger, Booleano, Codice, Data, DateFormula, DateTime, Decimale, Durata, GUID, Intero, Opzione e Testo.

Suggerimento

È inoltre possibile aggiungere nuovi mapping dei campi ai mapping delle tabelle di integrazione esistenti tramite la pagina elenco Mapping dei campi di integrazione, a cui puoi accedere scegliendo Campi nella pagina Mapping delle tabelle di integrazione.

Scegli semplicemente Nuova mappatura campo per aprire la fase di mappatura dei campi della guida al setup assistito Crea nuove mappature di integrazione, quindi procedi come descritto in questo articolo.

I nuovi mapping dei campi aggiunti a un mapping di tabella esistente sono in stato Disabilitato. Puoi scegliere Modifica elenco per abilitarli in seguito.

Regole di sincronizzazione

Un mapping della tabella di integrazione include anche le regole che controllano il modo in cui i processi di sincronizzazione dell'integrazione sincronizzano i record in una tabella Business Central e una tabella in Dataverse. Per esempi di regole per un'integrazione con Sales, vai a Regole di sincronizzazione.

Strategie per la risoluzione automatica dei conflitti

I conflitti di dati possono verificarsi facilmente quando le applicazioni aziendali scambiano dati su base continuativa. Ad esempio, qualcuno potrebbe eliminare o modificare una riga in una delle applicazioni o in entrambe. Per ridurre il numero di conflitti da risolvere manualmente, è possibile specificare strategie di risoluzione. Business Central risolve automaticamente i conflitti in base alle regole delle strategie.

I mapping della tabella di integrazione includono regole che controllano il modo in cui i processi di sincronizzazione sincronizzano i record. Nella pagina Mapping tabella integrazione, nelle colonne Risolvi conflitti di eliminazione e Risolvi conflitti di aggiornamento è possibile specificare come Business Central risolve i conflitti che si verificano perché i record sono stati eliminati nelle tabelle in una o nell'altra applicazione aziendale o aggiornati in entrambe.

Nella colonna Risolvi conflitti di eliminazione è possibile scegliere di fare in modo che Business Central ripristini automaticamente i record eliminati, rimuovere l'associazione tra i record o non eseguire alcuna operazione. Se non intraprendi azioni, devi risolvere manualmente i conflitti.

Nella colonna Risolvi conflitti di aggiornamento è possibile scegliere che Business Central invii automaticamente un aggiornamento dei dati alla tabella di integrazione durante l'invio dei dati a Dataverse o ottenere un aggiornamento dei dati dalla tabella di integrazione quando si ottengono dati da Dataverse o non fare nulla. Se non intraprendi azioni, devi risolvere manualmente i conflitti.

Dopo aver specificato la strategia, nella pagina Errori di sincronizzazione dati associati è possibile scegliere l'azione Riprova tutto per risolvere automaticamente i conflitti.

Mappatura dei campi di integrazione

Il mapping delle tabelle è solo il primo passaggio. È necessario anche eseguire il mapping dei campi nelle tabelle. I mapping dei campi di integrazione collegano i campi nelle tabelle Business Central con le colonne corrispondenti in Dataverse e determinano se vengono sincronizzati i dati in ciascuna tabella. Il mapping standard delle tabelle fornito da Business Central include la mappatura dei campi, ma è possibile modificarla. Per altre informazioni, vedere Visualizzazione dei mapping delle tabelle.

Annotazioni

Se si utilizza una versione locale di Business Central, le mappature dei campi di integrazione sono definite nella tabella 5336 Integration Field Mapping.

È possibile eseguire manualmente il mapping dei campi oppure automatizzare il processo eseguendo il mapping di più campi contemporaneamente in base ai criteri per la corrispondenza dei relativi valori. Per altre informazioni, vedere Associare più record in base alla corrispondenza dei valori dei campi.

Gestione delle differenze nei valori dei campi

A volte i valori nei campi che si desidera mappare sono diversi. Ad esempio, in Dynamics 365 Sales il codice della lingua per gli Stati Uniti è "U.S.", ma in Business Central è "US". Ciò significa che è necessario trasformare il valore quando si sincronizzano i dati. Puoi specificare le regole di trasformazione per i campi sulla pagina Mappature Tabelle di Integrazione scegliendo Mappatura e poi Campi. Vengono fornite regole predefinite, ma è anche possibile creare regole personalizzate. Per altre informazioni, vedere Regole di trasformazione.

Gestione dei valori delle opzioni mancanti

Dataverse contiene colonne di set di opzioni che forniscono valori che è possibile mappare ai campi di Business Central di tipo Opzione per la sincronizzazione automatica. Durante la sincronizzazione, le opzioni non mappate vengono ignorate e le opzioni mancanti vengono aggiunte alla relativa tabella Business Central e aggiunte alla tabella di sistema Mappatura opzione CDS da gestire manualmente in seguito. Ad esempio, aggiungendo le opzioni mancanti in entrambi i prodotti e quindi aggiornando la mappatura. Per altre informazioni, vedere Gestione dei valori delle opzioni mancanti.

Associare i record

Righe dei collegamenti di associazione in Dataverse per registrare in Business Central. Ad esempio, gli account in Dataverse sono in genere associati ai clienti in Business Central. L'associazione dei record offre i seguenti vantaggi:

  • Rende possibile la sincronizzazione.
  • Gli utenti possono aprire record o righe in un'app aziendale dall'altra app.

L'accoppiamento richiede che le app siano già integrate.

Le associazioni possono essere impostate automaticamente utilizzando i processi di sincronizzazione o manualmente modificando il record in Business Central. Per altre informazioni, vedere Sincronizzazione dei dati in Business Central e Dataverse eCoppia e Sincronizzazione manuale dei record.

Filtro di record e righe

Se non si desidera sincronizzare tutte le righe di una tabella di Dataverse o di Business Central specifica, è possibile impostare i filtri per limitare i dati che vengono sincronizzati. I filtri vengono impostati nella pagina Mapping delle tabelle di integrazione.

  1. Selezionare Cerca (Alt+Q) nell'angolo superiore destro, immettere Mappature delle tabelle di integrazione e quindi scegliere il collegamento correlato.
  2. Per filtrare i record di Business Central, impostare il campo Filtro tabella.
  3. Per filtrare le righe di Dataverse, impostare il campo Filtro tabella integrazione.

Creazione di nuovi record

Per impostazione predefinita, solo i record associati di Business Central e le righe di Dataverse verranno sincronizzati dai processi di sincronizzazione di integrazione. È possibile impostare i mapping di tabella per creare nuovi record o righe nell'app di destinazione per ogni riga nell'app di origine non ancora associata.

Ad esempio, il processo di sincronizzazione AGENTI - Dynamics 365 Sales utilizza il mapping di tabella AGENTI. Il processo di sincronizzazione copia i dati dagli utenti in Dataverse negli agenti in Business Central. Se si imposta il mapping di tabella per creare nuovi record, per ogni utente di Dataverse non ancora associato a un venditore in Business Central, viene creata una nuova riga venditore in Business Central.

Per creare nuovi record durante la sincronizzazione

  1. Selezionare Cerca (Alt+Q) nell'angolo superiore destro, immettere Mappature delle tabelle di integrazione e quindi scegliere il collegamento correlato.
  2. Nella voce di mapping della tabella nell'elenco, deselezionare il campo Sincronizza solo record associati.

Uso di modelli di configurazione nei mapping tabella

Puoi specificare uno o più modelli di configurazione da utilizzare per i nuovi record di Business Central e un altro modello per utilizzare le nuove righe di Dataverse.

Se si installa il setup di sincronizzazione predefinito, la maggioranza delle volte i due modelli di configurazione vengono automaticamente creati e utilizzati nel mapping di tabella per i clienti di Business Central e i conti di Dynamics 365 Sales: CDSCUST e CDSACCOUNT.

  • CDSCUST crea e sincronizza i nuovi clienti in Business Central in base ai conti in Dynamics 365 Sales.

    Per creare questo modello, copia un modello di configurazione esistente per i clienti. CDSCUST viene creato solo se esiste un modello di configurazione e il campo Cod. valuta nel modello è vuoto. Se un campo del modello di configurazione contiene un valore, questo sostituisce il valore della colonna mappata nel conto di Dataverse. Ad esempio, se la colonna Paese/area geografica in un conto di Dataverse include Stati Uniti e il campo Paese/area geografica del modello di configurazione è GB, viene utilizzato GB come Paese/area geografica nel cliente creato in Business Central.

  • CDSACCOUNT crea e sincronizza nuovi conti in Dataverse in base a un conto di Business Central.

È possibile aggiungere altri modelli e utilizzare filtri per definire le condizioni in base alle quali Business Central li applica. I modelli si applicano ai dati che si spostano in entrambe le direzioni. Ad esempio, è possibile usare un modello per i clienti nazionali negli Stati Uniti e un altro per i clienti stranieri nell'Unione europea, o viceversa. In tal caso, quando i dati vengono sincronizzati, Business Central utilizza il codice paese/area geografica del cliente per applicare il modello appropriato.

Per specificare i modelli di configurazione in un mapping di tabella

  1. Selezionare Cerca (Alt+Q) nell'angolo superiore destro, immettere Mappature delle tabelle di integrazione e quindi scegliere il collegamento correlato.

  2. Nell'elemento di mapping della tabella nell'elenco nel campo Modelli di configurazione tabella scegli il modello di configurazione da utilizzare per i nuovi record in Business Central.

  3. Se hai più modelli, per definire le condizioni che determinano quando utilizzare il modello, immetti i criteri nel campo Filtro tabella integrazione, quindi immetti un numero nel campo Priorità. La priorità determina l'ordine in cui Business Central valuta se utilizzare i modelli.

    Annotazioni

    I campi Codice modello di configurazione tabella e Codice modello di configurazione tabella integrazione mostrano valori diversi a seconda del numero di modelli configurati per uno specifico mapping della tabella di integrazione:

    • Se configuri un singolo modello di configurazione, il nome del modello di configurazione viene visualizzato per garantire la compatibilità con le funzionalità correnti.
    • Se configuri più modelli di configurazione, viene visualizzato il numero di modelli di configurazione configurati.

  4. Imposta il campo Codice del modello di configurazione della tabella integra al modello di configurazione che deve essere utilizzato per i nuovi record in Dataverse.

Informazioni sull'integrazione di Dynamics 365 Business Central con Dataverse
Sincronizzazione di Business Central e Dataverse
Programmare una sincronizzazione

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

  • Last updated on