Paramétrage pour une synchronisation de réferentiel

Nous décrivons ici le processus de paramétrage pour une synchronisation de référentiel article. Le même principe peut être utilisé pour tout type de synchronisation de référentiel.

Pour ce scénario il convient d’avoir au minimum deux sociétés - une maitre dans laquelle le référentiel sera géré et une(des) fille(s) dans lequel le référentiel sera répliqué - créées dans Dynamics 365 Business Central (dans un même environnement ou plusieurs environnements différents).

Nous allons effectuer une synchronisation de quelques paramétres comptables/commerciaux :

  • Modes de réglement
  • Condition de paiement
  • Client
Il s’agit d’un exemple de synchronisation. Si vous souhaitez effectuer une synchronisation des clients, il sera sans doute nécessaire d’y ajouter d’autres éléments.

Activation du module Data Exchange Hub

Le module Data Exchange Hub peut être activé ou désactivé au besoin. Pour cela vous devez accéder via le menu de recherche à l'écran Paramètrage du Data Exchange Hub et activer le champ correspondant:

Installation automatique

A partir de la page Paramètrage du Data Exchange Hub, sélectionner l’option Installation Automatique.

Cette fonction alimente automatiquement les tables suivantes:

  • Traitements: La table des traitements a été complétée avec deux traitements. Un traitement de processus de synchronisation (qui détermine le type de message qui sera utilisé pour la synchronisation) et un traitement de communication qui permet de gérer la communication par service Web.
  • Actes : Deux actes sont créés. Un pour la synchronisation sortante, et un pour la synchonisation entrante.
  • Ecriture de file d’attente: Une écriture de file d’attente est également créée. Elle est paramétrée pour d’exécuter toutes les 2 minutes. C’est cette file d’attente qui traitement l’envoi et la réception des messages de synchronisation. Dans le cas présent, une modification dans une société mettra donc au maximum 4 minutes pour être effective dans une autre société.

Prérequis

Veillez à ce que l’activation du module et l’Installation automatique soient effectuées dans la société maître. Consultez les sections précédentes en cas de besoin.

Veillez également à créer la(les) société(s) fille(s) avant de continuer le paramétrage. Dans notre exemple, il s’agit de la société “zCronus FR”.

Veillez enfin à ce que l’activation du module et l’Installation automatique soient effectuées dans la(les) société fille(s). Consultez les sections précédentes en cas de besoin.

Paramétrage dans la société “Maitre”

Dans la société “Maitre”, nous nous focaliserons sur l’acte “Sortant”. Mais avant cela nous devons paramètrer les éléments périphériques.

Création du Stockage Partenaire à destination de la société fille

Il s’agit d’ajouter le Stockage partenaire suivant :

Général

Champ Description
Code Le code du stockage partenaire. Pour simplifier, nous avons mis le nom de la société mais ce champ est libre.
Description Champ libre permettant de décrire le stockage partenaire.
Code traitement "DEH_WEBSERVICE” nécessaire pour le transfert direct vers une société d’un même tenant ou d’un autre tenant Microsoft 365 Business Central.
Descriptin du traitement Valeur automatiquement récupérée.

Paramètres

Champ Description
Utilisateur Identification d’un utilisateur dans la société destinatrice.
Cet utilisateur doit avoir les droits suffisant pour écrire dans les tables que vous souhaitez synchroniser et lire dans les paramètres de Data Exchange Hub.
Mot de passe Mot de passe de l’utilisateur dans la société destinatrice.
Il doit être en cohérence avec votre système d’authentification.
Pour les utilisateurs de Microsoft 365 Dynamics Business Central Online, il faut y mettre la Clé d’accès service web de l’utilisateur.
URL de base du service Web Il s’agit de l’URL de base d’accès au Web Services du tenant de destination.
Pour les utilisateurs de Microsoft 365 Dynamics Business Central Online, il est sous la forme :
"https://api.businesscentral.dynamics.com/v2.0/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/yyyyyyy/WS"
"xxx” étant l’identifiant de votre tenant de destination
"yyy” étant le code tenant de destination.
Société Nom de la société de destination dans le tenant destinataire.

Création de la société maitre en tant que partenaire

Le partenaire est l’entité qui est à l’origine de l’action et déclenche le traitement. Il s’agit d’ajouter le Partenaire suivant :

Champ Description
Code Le code du partenaire, ici la société maitre. Pour simplifier, nous avons mis le nom de la société.
Type "Société” afin d’indiqué au système que nous travaillons avec une société connue de notre base de donnée.
Code Partenaire "Cronus FR” étant la société maitre émettrice.

La liste en dessous est pour l’instant vide. Ce qui est tout à fait normal.

Création de l’accord EDI dans la société maitre

Il s’agit de modifier L’acte “SYNC_150_OUT” de la façon suivante :

Général

Champ Description
Active Modifier le champ à Vrai pour activer l’accord EDI.

Tables

Champ Description
N° Tables Les numéros de tables que l’on souhaite synchroniser.
Priorité Il est nécessaire d’avoir notre table principale “Client” avec un priorité inférieure. Ainsi les tables annexes seront à jour avant la table principale. Evitant ainsi des erreurs.
Déclencheurs de modification On active les 4 déclencheurs pour une synchronisation totale des données.

Partenaires

Champ Description
Code Partenaire Notre société Maitre, qui déclenche le traitement.
Code Stockage Partenaire Notre société destinataire, on indique ici le moyen de communication avec le partenaire.

Paramétrage dans la(les) société(s) “Fille(s)”

Dans chaque société “Fille”, voici les étapes à réalisées. Nous nous focaliserons sur l’accord EDI “Entrant”. Mais, comme pour la société “Maitre”, paramètrons avant tout les éléments périphériques.

Création du Stockage Partenaire de la société fille

Il s’agit d’ajouter le Stockage partenaire suivant :

Général

Champ Description
Code Le code du stockage partenaire. Pour simplifier, nous avons mis WEB, car la transmission s’effectuera par WebService.
Description Champ libre permettant de descrire le stockage partenaire.
Code traitement "DEH_WEBSERVICE” nécessaire pour le transfert direct vers une société d’un même tenant ou d’un autre tenant Microsoft 365 Business Central.
Description du traitement Valeur automatiquement récupérée.
Code Acte Nous y mettons le code de l’accord EDI entrant “SYNC_150_IN”. Ce mode de communication ne permet pas a coup sûr d’indentifier l’accord EDI concerné. On l’indique donc ici le code de l’accord EDI.

Paramètres

Aucun paramètre n’est nécessaire en réception de données.

Création de la société fille en tant que partenaire

Le partenaire est l’entité qui est à l’origine ou à destination de l’action et déclenche le traitement. Il s’agit d’ajouter le Partenaire suivant :

Général

Champ Description
Code Le code du partenaire, ici la société fille. Pour simplifier, nous avons mis le nom de la société.
Type "Société” afin d’indiqué au système que nous travaillons avec une société connue de notre base de donnée.
Code Partenaire "zCronus FR” étant la société fille réceptrice.

La liste en dessous est pour l’instant vide. Ce qui est tout à fait normal.

Modification de l’accord EDI dans la société fille

Il s’agit de modifier L’acte “SYNC_150_IN” de la façon suivante :

Général

Champ Description
Active Modifier le champ à Vrai pour activer l’accord EDI.

Partenaires

Champ Description
Code Partenaire Notre société Maitre, qui déclenche le traitement.
Code Stockage Partenaire "WEB”, on indique ici le moyen de stockage/communication avec le partenaire.

Paramètres

Il ne faut apporter aucune modification. ces éléments permettent d’identifier le message.

Correspondance

Nous ne réalisons aucune conversion de données, la liste est donc vide.

Paramètrage effectué

Votre paramètrage est réalisé.

Toute insertion, modification ou suppression dans les tables définies de la société “Maitre” seront transmise dans la(les) société(s) “fille(s)” dans un délai de 4 min.

Précédent