Références de connexion

Effectué

Les références de connexion permettent de transporter plus facilement les flux de cloud dans des solutions entre les différents environnements Microsoft Power Platform, en faisant abstraction des dépendances spécifiques à l’environnement. Cette fonction vous permet de mettre en œuvre des pratiques saines d’Application Lifecycle Management (ALM). Les références de connexion sont créées automatiquement pour les nouveaux flux de cloud qui sont créés dans des solutions. Cependant, si vous comprenez l’utilité des références de connexion et savez comment les configurer manuellement, vous pouvez les utiliser de manière optimale.

Les flux de cloud Power Automate utilisent des connecteurs pour les déclencheurs et pour effectuer des actions dans un flux. Lorsque vous utilisez un connecteur, une connexion est établie avec le service sous-jacent à l’aide des informations de votre compte. Dans cet exemple de flux de cloud qui ne se trouve pas dans une solution, votre flux de cloud dépend directement de la connexion. Les connexions sont spécifiques à un environnement Microsoft Power Platform. Le schéma suivant montre la façon dont un flux de cloud dépend directement de la connexion lorsqu’il n’utilise pas de références de connexion.

Schéma d’un flux de cloud avec des connexions.

Si cette architecture était utilisée avec un flux de cloud dans une solution, il faudrait modifier la définition du flux de cloud transportée entre les environnements dans chacun des environnements. Les bonnes pratiques d’ALM exigent de modifier la définition du flux uniquement dans un environnement de développement et non dans les environnements en aval, comme ceux de test et de production. Pour une ALM saine et pour faciliter le déploiement de solutions, vous devez utiliser des références de connexion avec des flux de cloud dans des solutions.

Les références de connexion sont des composants de solution contenant des informations sur un connecteur. Elles permettent de lier le déclencheur et les actions du flux de cloud à une référence de connexion au lieu de les lier directement à une connexion. La référence de connexion est alors liée à une connexion de manière unique, sans modifier la définition du flux et tout en maintenant des pratiques d’ALM saines. Le schéma suivant montre comment sont utilisées les références de connexion.

Schéma d’un flux de cloud avec des références de connexion.

Une solution avec des flux de cloud utilisant des références de connexion répertorie le flux de cloud et une ou plusieurs références de connexion dans la liste des objets de la solution.

Capture d’écran des types de références de connexion et de flux de cloud.

Lorsque la solution est importée dans un autre environnement, lors du premier ajout d’une référence de connexion, un message vous invite à ajouter une connexion.

Capture d’écran de l’option Nouvelle connexion du menu.

Aucune configuration supplémentaire n’est nécessaire une fois l’importation terminée. La relation entre la référence de connexion et la connexion sera conservée pour les futures mises à jour. Pour modifier une connexion spécifique associée à un flux, vous pouvez modifier la référence de connexion et changer la connexion sélectionnée.

Configurer des déclencheurs et des actions

Lorsque vous sélectionnez un déclencheur ou une action à ajouter à votre flux, le concepteur de flux vérifie si une référence de connexion est déjà disponible pour le connecteur. Si ce n’est pas le cas, une référence de connexion est ajoutée. À partir d’un déclencheur ou d’une carte d’action, vous pouvez sélectionner les points de suspension (...) pour afficher la référence de connexion qui est utilisée et celles qui sont disponibles. À partir de ce menu, vous pouvez sélectionner une autre référence de connexion ou en ajouter une nouvelle. Si vous ajoutez une nouvelle référence de connexion à partir de ce menu, vous n’aurez aucun contrôle sur le nom utilisé.

Capture d’écran du menu références de connexion.

En règle générale, vous souhaitez que toutes les étapes d’un flux utilisent la même référence de connexion. Dans certains cas, il est important d’utiliser plusieurs références de connexion. Par exemple, le fait d’avoir plusieurs références de connexion vous permet de configurer des informations de compte d’utilisateur différentes pour chaque connexion. Si vous avez l’intention d’utiliser plusieurs références de connexion, il est préférable de les créer manuellement au préalable, comme décrit plus loin dans cette rubrique, afin d’avoir des noms uniques et significatifs.

De plus, plusieurs flux de cloud peuvent utiliser des références de connexion. Ce détail est important à retenir si vous modifiez ultérieurement la connexion que vous utilisez, car elle changera pour tous les flux de cloud qui utilisent la référence de connexion.

Créer au préalable des références de connexion

En créant au préalable des références de connexion dans votre solution, vous pouvez contrôler leur dénomination. Vous pouvez créer une référence de connexion à partir de l’Explorateur de solutions en sélectionnant + Nouveau > Plus > Référence de connexion.

Capture d’écran des détails de la nouvelle référence de connexion.

L’exemple précédent montre la création d’une référence de connexion pour un compte de service administrateur qui doit servir à effectuer des opérations de niveau élevé dans des flux. Nommer la référence de connexion Étendue d’administration des utilisateurs d’Office 365 permet de préciser qu’il faut configurer une connexion pour cette référence de connexion à l’aide d’un compte de service administrateur. Le Nom d’affichage est important pour connaître la finalité d’une référence de connexion. Il doit être concis et unique pour expliquer l’objectif visé.

Si vous n’avez pas créé au préalable une référence de connexion ou si vous souhaitez seulement modifier le nom d’une référence de connexion existante, vous pouvez la modifier et modifier tout son contenu, sauf le champ Nom qui sert à l’identifier de manière unique. Par défaut, le nom d’une référence de connexion comprend le connecteur cible, le nom de la solution actuelle pour le contexte et un suffixe aléatoire pour garantir l’unicité. Pensez à modifier le nom par défaut de la référence de connexion pour le rendre unique et pour en indiquer l’utilisation.

Utiliser des références de connexion existantes

Power Automate essaie d’utiliser les références de connexion existantes de la solution actuelle, mais utilise également celles d’autres solutions du même environnement. Si vous consultez votre liste d’objets de solution et que vous ne trouvez pas de référence de connexion pour les connexions que vous utilisez après avoir créé votre flux, c’est probablement parce que votre flux utilise une référence de connexion d’une autre solution. Si ce n’est pas intentionnel, vous devez utiliser le processus de création préalable pour ajouter une nouvelle référence de connexion dans votre solution, puis modifier vos actions de flux afin d’utiliser cette référence de connexion. Si vous avez l’intention de partager la connexion, sélectionnez Ajouter existant > Plus > Références de connexion, puis choisissez la référence de connexion existante à ajouter à votre solution actuelle.

Supprimer des références de connexion

Comme pour d’autres composants de solution, vous pouvez supprimer les références de connexion de la solution actuelle ou les supprimer physiquement de l’environnement. Le plus souvent, vous supprimez les références de connexion lorsqu’elles ne sont plus nécessaires ou si vous regroupez des références de connexion qui ont été créées automatiquement. Avant de retirer ou de supprimer une référence de connexion, vous devez d’abord vérifier si un composant l’utilise. Pour cela, sélectionnez la référence de connexion, puis sélectionnez Afficher les dépendances.

Capture d’écran de l’option Afficher les dépendances.

L’image suivante montre un exemple de page de Dépendances qui répertorie tout composant de solution dépendant de cette référence de connexion.

Capture d’écran des dépendances de la référence de connexion.

Si aucune des dépendances ne provient de votre solution actuelle, vous pouvez supprimer la référence de connexion de la solution sans problème. Si des dépendances sont répertoriées, vous ne serez pas en mesure de supprimer physiquement la référence de connexion. Dans ce cas, vous devez d’abord modifier chaque composant dépendant pour supprimer son utilisation de la référence de connexion afin de pouvoir supprimer celle-ci.