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
- Mode de livraison
- Client
- Condition de paiement
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. Par convention, nous utiliserons un code en lien avec le code de traitement “OAUTH”. |
| Description | Champ libre permettant de décrire le stockage partenaire. |
| Code traitement | "DEH_OAUTHWEBSERVICE” 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 |
|---|---|
| Client Id | ID d’application (Client) de l’inscription d’applications créée au préalable dans l’Azure Portal du tenant Business Central. Obtenu au chaptitre Paramétrage - Prérequis techniques |
| Client Secret | Valeur du secrets client généré à partir de l’application dans l’Azure Portal du tenant Business Central. Obtenu au chaptitre Paramétrage - Prérequis techniques |
| ID Tenant AAD | Il s’agit de l’ID de l’annuaire (locataire) décrite dans l’application créée au préalable dans l’Azure Portal du tenant Business Central. Obtenu au chaptitre Paramétrage - Prérequis techniques |
| Nom de l’environnement BC | Il s’agit du nom attribué à l’environnement (Exemple: Production, Recette, Dev) présent dans l’URL: -https://businesscentral.dynamics.com/66afbc46-2d80-444c-a0c5-b37450d2b258/Production. |
| Société | Il s’agit du systemId de la société destinataire qui est disponible dans la page Société avec la fonction Contrôle de Page (Ctrl + Alt + F1) |
consulter le chaptitre Paramétrage - Prérequis techniques
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.
Mise à jour du contrat 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 5 déclencheurs pour une synchronisation totale des données. |
| Filtre table | Vous pouvez définir ici un filtre complexe basé sur tous les champs de la table. |
| Sélection des champs | Vous pouvez définir si vous souhaitez ne synchroniser que certains champs de la table.
Il est conseillé de ne pas synchroniser les champs systèmes identifiables par des numéro >
2000000000.
Pour sélectionner les champs cliquez sur l’action Table puis Champs à synchroniser |
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 qui doit être obligatoirement identique à celui de la société , soit “OAUTH” dans notre exemple. |
| Description | Champ libre permettant de décrire le stockage partenaire. |
| Code traitement | "DEH_OAUTHWEBSERVICE” nécessaire pour le transfert direct vers une société d’un maitre 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”, permetant d’indentifier l’accord EDI concerné. |
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 du contrat 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é Fille, qui déclenche le traitement. |
| Code Stockage Partenaire | "OAUTH”, 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.