Connexions externes
Reliez un service externe au bon contexte métier
Décrivez le service à connecter, fournissez sa documentation et associez-le aux domaines métier concernés.
Réunissez documentation et informations d’accès
- Déclarer le service
Identifiez l’API externe et donnez un lien ou le texte de sa documentation.
- Séparer les accès
Fournissez les informations de test et de production demandées.
- Relier le contexte métier
Associez une connexion existante aux domaines qui l’utilisent.
Donnez les informations nécessaires à l’intégration
La connexion commence par le nom du service et sa documentation. Expliquez l’action métier concernée et les informations à échanger entre les systèmes.
La déclaration distingue les accès de test et de production. Consultez-les sur la fiche de la connexion en gardant le contexte de l’environnement clair.
Préparez l’intégration autour de l’action qu’elle soutient
Expliquer l’échange nécessaire. Un service peut fournir ou recevoir les informations d’une tâche. Déclarez nom et documentation puis expliquez l’échange dans le contexte du projet. L’intégration possède ainsi un objectif pratique au-delà d’une URL.
Distinguer test et production. Les accès peuvent appartenir à des comptes fournisseurs différents. Conservez-les dans les champs correspondants et vérifiez leur usage. Ces contextes préparent les étapes de développement et d’exploitation.
Réutiliser une connexion déclarée. Un service peut soutenir plusieurs domaines. Rattachez la connexion existante au bon endroit puis examinez ses associations. Détacher un domaine et supprimer la connexion du projet sont des décisions distinctes.
Réutilisez la connexion au bon endroit
Une connexion peut servir plusieurs domaines métier. Consultez les services liés à un domaine pour attacher ou détacher celui qui convient.
La déclaration fournit les besoins de l’intégration. Suivez son état et testez le parcours construit avant de l’utiliser en production.
Expliquez l’échange dont votre application a besoin
Précisez le service, les informations à envoyer ou recevoir et le domaine métier qui les utilise. Un lien vers la documentation actuelle aide à décrire le fonctionnement réel du service externe.
Décrivez un exemple utile et le résultat attendu si le service est indisponible. La connexion peut alors être discutée à partir du travail des utilisateurs, au-delà du seul nom du fournisseur.
De la déclaration au parcours testé
Fournir les informations du service. Fournissez la documentation du service et les accès demandés pour les environnements de test et de production. Identifiez l’opération métier à connecter et le résultat attendu de l’échange.
Associer les bons domaines. Rattachez la connexion aux domaines métier qui doivent utiliser le service. Examinez les associations existantes avant un ajout ou un retrait pour conserver un périmètre compréhensible.
Vérifier l’intégration terminée. Suivez l’état du travail, puis testez l’échange complet dans l’environnement concerné. La déclaration de la connexion apporte son contexte ; la vérification du résultat confirme son fonctionnement.
Préparez la connexion réellement utile à l’application
Partez de la documentation et du résultat métier. Gardez accès et associations compréhensibles tout au long du projet.
Questions fréquentes
Nom du service, lien ou contenu de sa documentation, puis accès demandés pour test et production. Un nom seul ne définit pas le comportement de l’intégration.
Oui. Examinez les domaines liés dans les détails pour conserver un périmètre lisible.
La connexion utilise un autre service. L’API optionnelle expose les opérations convenues de votre application. Ce sont des besoins d’intégration différents.
Le détachement concerne un domaine. La suppression du connecteur est une autre action, avec un autre périmètre ; vérifiez la confirmation.
Suivez la réalisation puis testez l’échange complet. Déclaration et activation apportent du contexte sans remplacer la vérification du résultat.