Partager via


Mappage des tables et des champs pour la synchronisation

La base de la synchronisation des données consiste à mapper les tables et les champs dans Business Central avec des tables et des colonnes dans Dataverse afin qu’ils échangent les données. Le mappage s’effectue via des tables d’intégration.

Mappage de tables d’intégration

Une table d’intégration est une table dans la base de données Business Central qui représente une table, par exemple un compte, dans Dataverse. Les tables d’intégration incluent des champs qui correspondent aux colonnes de la table Dataverse. Par exemple, la table d’intégration Compte se connecte à la table Comptes dans Dataverse. Il doit y avoir un mappage de table d’intégration pour chaque table dans CDS à synchroniser avec les données dans Business Central.

Lorsque vous créez la connexion entre les applications, Business Central configure quelques mappages par défaut. Si vous le souhaitez, vous pouvez modifier les mappages de tables. Pour en savoir plus, consultez Mappage de table standard pour la synchronisation. Si vous avez modifié les mappages par défaut et souhaitez annuler vos modifications, sur la page Mappages de table d’intégration, choisissez Utiliser la configuration de synchronisation par défaut.

Noter

Si vous utilisez une version locale de Business Central, les mappages de tables d’intégration sont stockés dans la table 5335 Mappages de tables d’intégration, où vous pouvez afficher et modifier les mappages. Les règles de synchronisation et mappages complexes sont définis dans le codeunit 5341.

Astuce

Lorsqu’un enregistrement couplé change, Business Central synchronise automatiquement les données avec Dataverse. La synchronisation automatique est excellente dans la plupart des cas. Toutefois, des modifications fréquentes apportées à de grandes quantités d’enregistrements couplés dans une table peuvent ralentir la synchronisation des données.

Pour éviter un ralentissement des performances, sur la page Mappages de table d’intégration, vous pouvez activer ou désactiver la synchronisation des données basée sur les événements pour n’importe quelle table. Par défaut, la synchronisation basée sur les événements est activée afin que les intégrations existantes ne soient pas affectées. Votre administrateur peut l’activer ou le désactiver pour des tables spécifiques.

Ajouter des mappages de table et de champ aux tables d’intégration existantes

VERSION PRÉLIMINAIRE : Cette fonctionnalité est disponible actuellement en version préliminaire.

Sur la page Mappages de table d’intégration, vous pouvez utiliser l’action Nouveau mappage de table pour ajouter de nouveaux mappages de table aux tables d’intégration. L’action démarre le guide de configuration assistée Créer de nouveaux mappages d’intégration, qui vous aide à configurer de nouveaux mappages de table d’intégration et de champ.

Le guide vous permet de mapper les tables de Business Central avec les tables d’intégration existantes dans Dataverse. Vous pouvez également spécifier l’identificateur unique de la table Dataverse dans Nom du champ Identificateur unique de la table d’intégration et Nom du champ Date de modification de la table d’intégration, qui sont nécessaires au bon fonctionnement de la synchronisation des données.

Remarque

La recherche dans la colonne Table affiche toutes les tables Business Central, y compris les tables personnalisées, qui ne sont pas encore mappées. Elle exclut celles qui existent déjà sur votre page Mappages de table d’intégration. La recherche dans la colonne Table d’intégration affiche uniquement les tables Dataverse (tables de proxy AL) qui font partie des intégrations prédéfinies. Pour ajouter des tables Dataverse supplémentaires ou personnalisées, vous aurez besoin de l’aide d’un développeur pour les créer et les déployer via une extension.

L’action Avancé ouvre des paramètres de mappage de table supplémentaires que vous pouvez configurer. Dans la section Avancé, le champ Filtre de table vous permet de spécifier des filtres pour Business Central. Utilisez le champ Filtre de table d’intégration pour les données Dataverse à prendre en compte dans la synchronisation des données avec les codes du modèle de configuration dans Code modèle config. table et Code config. table int pour préremplir les données manquantes lorsque de nouvelles données proviennent de l’une ou l’autre application.

Le guide vous aide également à spécifier les champs que le nouveau mappage doit contenir. Vous pouvez mettre en correspondance un champ Business Central dans la colonne Nom du champ avec un nom de champ Dataverse dans la colonne Nom du champ d’intégration. Vous pouvez également spécifier une Direction, si le champ a toujours la même valeur dans la colonne Constante, et si des validations ou des transformations doivent être appliquées pendant le mappage de champ.

Remarque

Pour réduire les erreurs, la recherche pour la colonne Champ de la table d’intégration est filtrée sur une liste de champs disponibles. Pour mapper les champs que les filtres n’incluent pas, vous aurez besoin de l’aide d’un développeur.

  • Les champs doivent être activés.
  • Vous ne pouvez pas utiliser le guide pour mapper les champs FlowField et FlowFilter.
  • Vous ne pouvez mapper que des champs de type BigInteger, booléen, Code, Date, DateFormula, DateTime, Decimal, Duration, GUID, Integer, Option et Text.

Astuce

Vous pouvez également ajouter de nouveaux mappages de champ aux mappages de table d’intégration existants via la page de liste Mappages de champ d’intégration, à laquelle vous pouvez accéder en choisissant Champs sur la page Mappages de table d’intégration.

Choisissez simplement Nouveau mappage de champ pour ouvrir l’étape de mappage de champ du guide de configuration assistée Créer de nouveaux mappages d’intégration, puis procédez comme décrit dans cet article.

Les nouveaux mappages de champ que vous ajoutez à un mappage de table existant sont à l’état désactivé. Vous pouvez choisir Modifier la liste pour les activer ultérieurement.

Règles de synchronisation

Un mappage de table d’intégration comprend également des règles qui contrôlent comment les travaux de synchronisation d’intégration synchronisent les enregistrements dans une table dans Business Central et une table dans Dataverse. Pour des exemples de règles pour une intégration avec Sales, accédez à Règles de synchronisation.

Stratégies de résolution automatique des conflits

Les conflits de données peuvent facilement se produire lorsque les applications métier échangent des données de manière continue. Par exemple, quelqu’un peut supprimer ou modifier une ligne dans l’une des applications, ou les deux. Pour réduire le nombre de conflits à résoudre manuellement, vous pouvez spécifier des stratégies de résolution. Business Central résout automatiquement les conflits selon les règles des stratégies.

Les mappages de table d’intégration incluent des règles qui contrôlent la façon dont les tâches travaux de synchronisation synchronisent les enregistrements. Sur la page Mappage de table d’intégration, dans les colonnes Résoudre les conflits de suppression et Résoudre les conflits de mise à jour, vous pouvez spécifier comment Business Central résout les conflits qui se produisent parce que les enregistrements ont été supprimés dans les tables de l’une ou l’autre application métier, ou mis à jour dans les deux.

Dans la colonne Résoudre les conflits de suppression, vous pouvez choisir que Business Central restaure automatiquement les enregistrements supprimés, supprime le couplage entre les enregistrements ou ne fasse rien. Si vous ne faites rien, vous devez résoudre manuellement les conflits.

Dans la colonne Résoudre les conflits de mise à jour, vous pouvez choisir que Business Central envoie automatiquement une mise à jour des données à la table d’intégration lors de l’envoi de données à Dataverse, obtienne une mise à jour des données à partir de la table d’intégration lors de l’obtention de données à partir de Dataverse ou ne fasse rien. Si vous ne faites rien, vous devez résoudre manuellement les conflits.

Après avoir spécifié la stratégie, sur la page Erreurs de synchronisation de données couplées, vous pouvez choisir l’action Réessayer tout pour résoudre automatiquement les conflits.

Mappage de champs d’intégration

Le mappage de tables ne constitue que la première étape. Vous devez également mapper les champs des tables. Les mappages de champs d’intégration associent les champs dans les tables Business Central avec les colonnes correspondantes dans Dataverse, et déterminent s’il faut synchroniser les données dans chaque table. Le mappage de table standard fourni par Business Central inclut des mappages de champ, mais vous pouvez modifier les mappages. Pour plus d’informations, voir Affichage des mappages de tables.

Remarque

Si vous utilisez une version locale de Business Central, les mappages de champs d’intégration sont définis dans la table 5336 Mappage de champs d’intégration.

Vous pouvez mapper manuellement les champs, ou automatiser le processus en mappant plusieurs champs en même temps en fonction de critères de correspondance de leurs valeurs. Pour plus d’informations, consultez Pour coupler plusieurs enregistrements en fonction de la correspondance de leurs valeurs de champ.

Gérer les différences de valeurs de champ

Parfois, les valeurs des champs que vous souhaitez associer sont différentes. Par exemple, le code langue Dynamics 365 Sales pour les États-Unis est « U.S. » dans une application métier et « US » dans Business Central. Autrement dit, vous devez transformer la valeur lorsque vous synchronisez les données. Vous pouvez spécifier des règles de transformation pour les champs sur la page Mappages de table d’intégration en choisissant Mappage, puis Champs. Des règles prédéfinies sont fournies, mais vous pouvez également créer les vôtres. Pour plus d’informations, voir Règles de transformation.

Gérer les valeurs option manquantes

Dataverse contient des colonnes d’ensembles d’options qui fournissent des valeurs que vous pouvez mapper à des champs Business Central de type Option pour la synchronisation automatique. Lors de la synchronisation, les options non mappées sont ignorées et les options manquantes sont ajoutées à la table Business Central associée et à la table système Mappage option CDS pour une gestion manuelle ultérieure. Par exemple, en ajoutant les options manquantes dans l’un ou l’autre des produits, puis en mettant à jour le mappage. Pour en savoir plus, consultez Gestion des valeurs option manquantes.

Coupler les enregistrements

Le couplage associe des lignes dans Dataverse à des enregistrements dans Business Central. Par exemple, les comptes dans Dataverse sont généralement associés aux clients dans Business Central. Le couplage d’enregistrements offre les avantages suivants :

  • Il rend la synchronisation possible.
  • Les utilisateurs peuvent ouvrir des enregistrements ou des lignes dans une application métier, puis une autre.

Le couplage nécessite que les applications soient déjà intégrées.

Les couplages peuvent être configurés automatiquement à l’aide des projets de synchronisation, ou manuellement en modifiant l’enregistrement dans Business Central. Pour plus d’informations, voir Synchronisation des données dans Business Central et Dataverse et Couplage et synchronisation manuels d’enregistrements.

Filtrer les enregistrements et les lignes

Si vous ne souhaitez pas synchroniser toutes les lignes pour une table spécifique dans Dataverse ou une table dans Business Central, vous pouvez définir des filtres pour limiter les données synchronisées. Vous configurez des filtres sur la page Mappages de table d’intégration.

  1. Choisissez l’icône Icône en forme d’ampoule qui ouvre la fenêtre de recherche., saisissez Mappages de table d’intégration, puis choisissez le lien associé.
  2. Pour filtrer les enregistrements Business Central, définissez le champ Filtre table.
  3. Pour filtrer les lignes Dataverse, définissez le champ Filtre table intégration.

Créer des enregistrements

Par défaut, seuls les enregistrements couplés dans Business Central et les lignes dans Dataverse sont synchronisés par les projets de synchronisation de l’intégration. Vous pouvez définir des mappages de table pour créer des enregistrements ou lignes dans l’application de destination pour chaque ligne dans l’application source qui n’est pas encore couplée.

Par exemple, le projet de synchronisation Dynamics 365 Sales - VENDEURS utilise le mappage de table VENDEURS. Le projet de synchronisation copie les données des utilisateurs dans Dataverse vers les vendeurs dans Business Central. Si vous définissez le mappage de table pour créer des enregistrements, pour chaque utilisateur dans Dataverse qui n’est pas encore couplé à un vendeur dans Business Central, une ligne de vendeur est créée dans Business Central.

Pour créer des enregistrements durant la synchronisation

  1. Choisissez l’icône Icône en forme d’ampoule qui ouvre la fenêtre de recherche., saisissez Mappages de table d’intégration, puis choisissez le lien associé.
  2. Dans l’écriture de mappage de table de la liste, désactivez le champ Synch. uniquement les enregistrements couplés.

Utiliser des modèles de configuration dans les mappages de table

Vous pouvez spécifier un ou plusieurs modèles de configuration à utiliser pour les nouveaux enregistrements Business Central et un autre modèle à utiliser pour les nouvelles lignes Dataverse.

Si vous installez la configuration de synchronisation par défaut, deux modèles de configuration sont automatiquement créés et utilisés dans le mappage de table pour les clients Business Central et les comptes Dynamics 365 Sales : CDSCUST et CDSACCOUNT.

  • CDSCUST crée et synchronise de nouveaux clients dans Business Central sur la base des comptes dans Dynamics 365 Sales.

    Pour créer ce modèle, copiez un modèle de configuration existant pour les clients. Le compte CDSCUST est créé seulement s’il existe un modèle de configuration et si le champ Code devise du modèle est vide. Si un champ du modèle de configuration contient une valeur, celle-ci remplace la valeur de la colonne mappée dans le compte Dataverse. Par exemple, si la colonne Pays/Région d’un compte dans Dataverse a la valeur États-Unis et le champ Pays/Région du modèle de configuration a la valeur Grande-Bretagne, alors Grande-Bretagne est utilisé comme Pays/Région pour le client dans Business Central.

  • Le compte CDSACCOUNT crée et synchronise de nouveaux comptes dans Dataverse sur la base d’un compte dans Business Central.

Vous pouvez ajouter d’autres modèles et utiliser des filtres pour définir les conditions selon lesquelles Business Central les applique. Les modèles s’appliquent aux données transférées dans les deux sens. Par exemple, vous pouvez utiliser un modèle pour les clients nationaux aux États-Unis et un autre pour les clients étrangers dans l’Union européenne, ou vice versa. Dans ce cas, lorsque les données sont synchronisées, Business Central utilise le code pays/région du client pour appliquer le modèle approprié.

Pour spécifier des modèles de configuration dans un mappage de table

  1. Choisissez l’icône Icône en forme d’ampoule qui ouvre la fenêtre de recherche., saisissez Mappages de table d’intégration, puis choisissez le lien associé.

  2. Dans l’écriture de mappage de table de la liste, dans le champ Modèles config. table, choisissez le modèle de configuration à utiliser pour les nouveaux enregistrements dans Business Central.

  3. Si vous disposez de plusieurs modèles, pour définir les conditions qui déterminent quand utiliser le modèle, saisissez des critères dans le champ Filtre table d’intégration, puis saisissez un numéro dans le champ Priorité. La priorité détermine l’ordre dans lequel Business Central évalue si les modèles doivent être utilisés.

    Remarque

    Les champs Code modèle config. table et Code modèle config. table int affichent des valeurs différentes selon le nombre de modèles que vous configurez pour un mappage de table d’intégration spécifique :

    • Si vous configurez un seul modèle de configuration, le nom du modèle de configuration s’affiche afin de rester compatible avec les fonctionnalités actuelles.
    • Si vous configurez plusieurs modèles de configuration, le nombre de modèles de configuration configurés s’affiche.
  4. Configurez le champ Code modèle config. table int. dans le modèle de configuration à utiliser pour les nouveaux enregistrements dans Dataverse.

Voir aussi

À propos de l’intégration de Dynamics 365 Business Central avec Dataverse
Synchronisation de Business Central et de Dataverse
Planification d’une synchronisation

Trouvez des modules d’apprentissage en ligne gratuits pour Business Central ici