Connexions externes

Les connexions décrivent l’utilisation d’un autre service par votre application. Ouvrez Connecteurs pour déclarer sa documentation et les accès nécessaires en test et en production.

Avant de commencer — Préparez la documentation du fournisseur et les accès demandés pour le test et la production. Identifiez l’opération métier concernée. La déclaration, l’association et un échange vérifié constituent des étapes distinctes.

Déclarer le service à intégrer

Décrivez le fournisseur et fournissez sa documentation ainsi que les accès nécessaires.

1. Cliquez sur Ajouter une connexion API.
2. Renseignez Nom du service externe.
3. Fournissez Lien de la documentation API ou collez le contenu dans Documentation API.
4. Complétez Identifiants de test et Identifiants de production selon les accès demandés.
5. Utilisez Ajouter un secret pour des paires nom/valeur supplémentaires.
6. Cliquez sur Ajouter.

La déclaration est enregistrée. Une documentation ou son lien est nécessaire ; le nom du service seul n’explique pas l’intégration.

Vérifier la connexion déclarée

Vérifiez les informations du fournisseur et les associations existantes avant une modification.

1. Ouvrez le service depuis la liste.
2. Consultez Documentation et le contenu fourni.
3. Vérifiez que les accès de test et de production correspondent aux bons comptes du fournisseur.
4. Consultez Modules liés.

Placez les accès dans leurs champs dédiés plutôt que dans une description publique ou une page du site.

Rattacher le service à un domaine métier

Associez la connexion au domaine responsable de l’opération qui en a besoin.

1. Ouvrez le domaine puis Connecteur.
2. Cliquez sur Ajouter un connecteur.
3. Choisissez la connexion existante.
4. Cliquez sur Ajouter.

L’association indique quel domaine utilise le service. Une connexion peut servir plusieurs domaines.

Détacher une connexion d’un domaine

Vérifiez l’association à retirer et les autres usages de la même connexion.

1. Ouvrez les connecteurs liés au domaine.
2. Cliquez sur Détacher pour l’association concernée.
3. Vérifiez la confirmation puis cliquez sur Détacher le connecteur.
4. Vérifiez les associations restantes.

L’association concernée est retirée. La connexion reste déclarée dans Connecteurs et vous pouvez la rattacher à tout moment.

Remarque — Détacher une association et supprimer la connexion du projet sont deux opérations distinctes. Déclaration et activation ne prouvent pas non plus un parcours fonctionnel. Testez l’intégration terminée avant son utilisation en production.

Une connexion de livraison peut servir les commandes et le suivi client. Retirer son association à un domaine ne définit pas les besoins de l’autre. Vérifiez les liens restants et testez l’échange réalisé dans le bon environnement avant de vous appuyer sur son résultat.

Désactiver ou supprimer une connexion

Désactivez une connexion pour que vos modules cessent de l’utiliser tout en conservant sa déclaration, ou supprimez-la pour la retirer du projet.

1. Ouvrez le service depuis la liste, puis l’onglet Paramètres.
2. Cliquez sur Activation, vérifiez État actuel, puis cliquez sur Désactiver (ou Activer pour la réactiver).
3. Pour la retirer, cliquez plutôt sur Suppression, vérifiez la confirmation puis cliquez sur Supprimer.

Une connexion désactivée reste déclarée mais n’est pas utilisée par vos modules ; vous pouvez la réactiver à tout moment. Une connexion supprimée quitte la liste des connecteurs et est détachée de tous les modules qui l’utilisaient.

Résoudre un problème de préparation de connexion