# 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.

![Assistant de configuration - politique de rétention](setup-wizard-retention-policy.png)

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 :

![Exemple de configuration de flux](setup-define-flow.png)

* 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.