Configuration du module

Premier paramétrage

Le module propose un assistant de configuration lors de la première mise en place.

Cet assistant aide à installer les éléments nécessaires au bon fonctionnement du module et à définir les règles de conservation des données.

Étapes proposées par l'assistant

L'assistant permet de :

• installer les packages de configuration disponibles ;
• choisir une politique de rétention pour les erreurs ;
• choisir une politique de rétention pour les messages ;
• choisir une politique de rétention pour les archives de messages ;
• finaliser la mise en route du module.

L'assistant est conçu pour guider rapidement les utilisateurs en début de mise en service.

Définir un partenaire

Un partenaire est la base de chaque échange.

Il faut généralement renseigner :

• un code unique ;
• une description ;
• l'interprétation ou logique de traitement à appliquer ;
• les délais d'archivage automatique si nécessaire.

Le partenaire est ensuite associé à différents flux selon les échanges à réaliser.

Définir un flux

Chaque flux doit répondre à plusieurs questions :

• quel type de document ou de donnée est concerné ;
• dans quel sens l'échange se fait-il ;
• comment est-il déclenché ;
• par quel canal il passe ;
• si l'utilisateur peut modifier le message avant l'envoi ou l'intégration.

Direction du flux

Il existe deux directions :

• entrant : le message vient du partenaire et doit être intégré dans Business Central ;
• sortant : le message part de Business Central vers le partenaire.

Déclenchement du flux

Le déclenchement du flux peut être :

• manuel ;
• au moment d'une validation de document ;
• lors d'un enregistrement ou d'une modification ;
• à partir d'une file d'attente ;
• ou encore selon un événement spécifique du système.

Ce paramètre permet d'automatiser les échanges sans intervention manuelle.

Définir une connexion

La connexion donne au flux le canal de transport des fichiers.

Les champs de configuration dépendent du type de connexion choisi.

FTP et SFTP

Les paramètres les plus courants sont :

• hôte ;
• port ;
• utilisateur ;
• chemin du dossier ;
• filtre de fichiers ;
• mot de passe ;
• nom de fichier.

API

Le mode API demande généralement l'adresse du service et les identifiants ou paramètres d'authentification nécessaires.

Azure Blob Storage et Azure File Storage

Ces modes demandent les éléments de connexion au stockage Azure, ainsi que le chemin ou le conteneur de destination ou de source.

Définir la rétention des données

Le module permet de gérer la durée de conservation des données d'échange.

La rétention peut être appliquée à :

• les erreurs ;
• les messages ;
• les archives de messages.

Ces règles évitent de conserver indéfiniment des données devenues inutiles, tout en gardant suffisamment d'historique pour le suivi.

Vérifier le bon fonctionnement

Après configuration, il est conseillé de vérifier :

• qu'un partenaire est bien enregistré ;
• qu'un flux est bien associé ;
• qu'une connexion a bien été sélectionnée ;
• que le message est bien créé lorsqu'un événement métier se produit ;
• que les journaux et erreurs sont bien visibles dans le tableau de bord.

Bonnes pratiques de configuration

• Créez un partenaire distinct pour chaque interlocuteur externe.
• Organisez les flux par type d'échange pour faciliter le suivi.
• Testez chaque connexion avec un petit volume avant de passer en production.
• Définissez une politique de rétention adaptée au besoin métier et au volume d'échanges.
• Limitez l'édition des messages aux profils autorisés.

À retenir

La configuration du module repose sur quatre éléments clés : le partenaire, le flux, la connexion et la politique de gestion des messages. Une bonne configuration facilite non seulement le traitement des échanges, mais aussi le suivi, la traçabilité et la correction des anomalies.