Utiliser une référence de connexion dans une solution avec Microsoft Dataverse

Un connecteur est un proxy ou un wrapper autour d’une API qui permet au service sous-jacent de communiquer avec Microsoft Power Automate, Microsoft Power Apps et Azure Logic Apps. Cela permet aux utilisateurs de se connecter à leurs comptes et d’utiliser un ensemble d’actions et de déclencheurs prédéfinis pour créer leurs applications et leurs workflows.

Une connexion est un ensemble d’informations d’authentification pour un connecteur, par exemple les informations d’identification OAuth pour le connecteur SharePoint.

Une référence de connexion est un composant de solution qui contient une référence à une connexion sur un connecteur spécifique. Les applications canevas et les opérations dépendantes de solutions au sein d’un flux dépendant d’une solution se lient à une référence de connexion plutôt qu’à une connexion directe. Lors de l’importation de la solution dans un environnement cible, une connexion est fournie pour toutes les références de connexion afin que tous les flux de référencement puissent être activés automatiquement une fois l’importation terminée. Pour modifier une connexion spécifique associée à une application canevas ou à un flux, vous devez modifier le composant de référence de connexion dans la solution.

Ajouter des références de connexion à une solution

Vous pouvez ajouter des références de connexion à une solution de différentes manières :

• Lorsque vous utilisez l’explorateur de solutions pour créer une nouvelle référence de connexion dans une solution.

• Lorsque vous importez une solution. En apprendre davantage, accédez à Importer des solutions.

• Implicitement, lorsque vous créez vos applications canevas et vos flux qui sont définis dans une solution Microsoft Dataverse.

Notes

• Les flux et les applications de canevas gèrent les connexions différemment. Les flux utilisent des références de connexion pour tous les connecteurs, tandis que les applications canevas ne les utilisent que pour les connexions implicitement partagées (non OAuth), telles que l’authentification SQL Server. Plus d’information : Sécurité et types d’authentification
• Une référence de connexion est automatiquement créée lorsque vous créez de nouvelles connexions à partir des concepteurs d’applications de flux et de canevas.
• Les applications de canevas et les flux ajoutés à partir de solutions externes ne seront pas automatiquement mis à niveau pour utiliser les références de connexion.
• Les références de connexion ne sont associées aux applications de canevas qu’au moment où un source de données est ajouté à l’application. Pour mettre à niveau des applications, vous devez supprimer la connexion de l’application, puis ajouter une connexion contenant une référence de connexion associée.

Ajouter manuellement une référence de connexion à l’aide de l’explorateur de solutions

1. Connectez-vous à Power Apps ou Power Automate.

2. Dans le volet gauche, sélectionnez Solutions. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.

3. Créez une nouvelle commande ou ouvrez une solution existante.

4. Dans la barre de commandes, sélectionnez Nouveau > Plus > Référence de connexion.

5. Dans le volet Nouvelle référence de connexion, entrez les informations suivantes. Les colonnes obligatoires sont désignées par un astérisque (*).

   • Nom d’affichage : saisissez un nom unique et explicite pour différencier facilement cette référence de connexion des autres.
   • Ajouter une description : saisissez le texte décrivant la connexion.
   • Connecteur : sélectionnez un connecteur existant dans la liste, comme dans la capture d’écran ici. Vous pouvez également sélectionner Nouveau pour créer une nouvelle connexion pour cette référence de connexion. Une fois que vous avez fini de créer une nouvelle connexion, sélectionnez Rafraîchir pour sélectionner votre connexion dans la liste.
   • Connexion : Basé sur Connecteur vous avez sélectionné, sélectionnez une connexion existante ou sélectionnez Nouvelle connexion pour en créer.

6. Cliquez sur Créer.

   

Dénomination d’une référence de connexion

Le nom complet d’une référence de connexion doit être unique afin que différentes références de connexion puissent être différenciées uniquement par leur nom. 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 à définir le nom de la référence de connexion comme une chose unique et explicite de son utilité.

Réutiliser des connexions dans un flux de solution

Les flux créés en dehors d’une solution utilisent directement les connexions. Les flux créés dans une solution utilisent les références de connexion et les points de référence de connexion au niveau de la connexion. Pour réutiliser une connexion dans un flux de solution, vous devez d’abord créer une référence de connexion pointant vers cette connexion.

Mettre à jour un flux pour utiliser des références de connexion au lieu de connexions

Lorsqu’un flux n’est pas dans une solution, il utilise des connexions. Si ce flux est ensuite ajouté à la solution, il continue à utiliser les connexions initialement. Les flux peuvent être mis à jour pour utiliser des références de connexions au lieu de connexions de l’une des deux manières suivantes :

1. Si le flux est exporté dans une solution non gérée et importé, les connexions sont supprimées et remplacées par des références de connexion.

2. Lorsqu’un flux de solution est ouvert, le vérificateur de flux sur la page des détails du flux affiche un avertissement pour Utiliser les références de connexion. Le message d’avertissement contient une action pour Supprimer les connexions afin que des références de connexion puissent être ajoutées. La sélection de cette action supprime les connexions du déclencheur et les actions dans le flux et permet de sélectionner et de créer des références de connexion.

Utilisation automatique des références de connexion dans un flux de solution

Lorsqu’une action est ajoutée à un flux de solution, Power Automate essaiera de réutiliser les références de connexion existantes de la solution actuelle ou d’autres solutions avant de créer une nouvelle référence de connexion. Pour vous assurer que la référence de connexion se trouve dans la même solution que le flux, créez ou ajoutez une référence de connexion dans la même solution et référencez cette référence de connexion à partir du flux.

Partager des connexions avec un autre utilisateur afin que les flux puissent être activés

Lorsqu’un flux est activé, l’utilisateur qui active le flux doit être propriétaire ou avoir l’autorisation d’utiliser toutes les connexions du flux. Ceci est généralement accompli en demandant au propriétaire du flux de créer les connexions à l’intérieur de toutes les références de connexion que le flux utilise. Si un utilisateur autre que le propriétaire du flux fournit les connexions dans un flux, le flux doit être activé par le propriétaire de ces connexions ou les connexions doivent être partagées avec l’utilisateur qui active le flux.

Notes

Les connexions OAuth ne peuvent être explicitement partagées qu’avec un utilisateur représentant un principal de service.

Partage manuel des connexions pour l’activation du flux

Le partage de connexions peut être accompli en suivant les étapes suivantes.

1. Accédez à Power Apps, et sélectionnez l’environnement contenant la connexion.

2. Sélectionnez Connexions sur le volet de navigation de gauche, puis sélectionnez la connexion à partager. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.

3. Dans la barre de menu, sélectionnez Partager.

4. Dans l’écran de partage, entrez le nom de l’utilisateur (principal du service) qui activera le flux.

5. Pour les autorisations, sélectionnez Peut utiliser.

6. Pour terminer le partage, sélectionnez Enregistrer.

Partage automatique des connexions pour l’activation du flux

Pour automatiser le partage des connexions, utilisez l’action Modifier l’attribution du rôle de connexion sur le connecteur Power Apps pour les créateurs.

Limites

• Les références de connexion sont désormais enregistrées de manière asynchrone. Contrairement à la période de version préliminaire, il n’y a plus de limite au nombre de flux pouvant faire référence à la même référence de connexion. Lorsque les références de connexion sont mises à jour, une bannière d’informations qui contient un volet contenant les détails de la mise à jour asynchrone s’affiche.
• Il n’y a pas non plus de limite au nombre d’actions dans chaque flux qui peuvent être associées à la référence de connexion.
• Les applications canevas ne reconnaissent pas les références de connexion sur les connecteurs personnalisés. Pour contourner cette limitation, une fois qu’une solution est importée dans un environnement, l’application doit être modifiée pour supprimer puis rajouter la connexion du connecteur personnalisé. Notez que si cette application est dans un solution gérée, la modification de l’application créera une couche non gérée. Plus d’informations : Couches de solution

Problèmes connus

Cette section décrit les problèmes connus avec les références de connexion.

L’environnement de copie interrompt les références de connexion pour les connecteurs personnalisés

Les connecteurs personnalisés utilisent un identifiant spécifique à l’environnement pour référencer un connecteur personnalisé. Après une opération de copie de l’environnement, une nouvelle référence de connexion doit être créée pour le nouveau connecteur personnalisé. Ensuite, les applications ou flux qui utilisent les anciennes références de connexion devront être corrigés.

Les connecteurs personnalisés doivent être importés dans une solution distincte de leurs références de connexion

Les connecteurs personnalisés doivent être importés dans une solution distincte, avant les références de connexion ou les flux. Exportez une solution contenant uniquement le connecteur personnalisé au préalable.

FAQ

Comment corriger une erreur « Connexion non valide » ?

Si la référence de connexion indique « non valide » lorsqu’un point d’exclamation rouge apparaît sur la page des détails du flux, cela signifie que la connexion sous-jacente est dans un état incorrect. Lorsque cela se produit, vérifiez et corrigez la connexion sous-jacente en mettant à jour la connexion, ou remplacez la connexion.

Qu’est-ce que l’erreur ConnectionAuthorizationFailed ? Pourquoi ne puis-je pas activer un flux ?

L’erreur « ConnectionAuthorizationFailed » indique que l’utilisateur qui tente d’activer le flux ne dispose pas d’autorisations pour au moins une des connexions utilisées par le flux. Pour résoudre la situation, sélectionnez l’une des résolutions suivantes :

• Les utilisateurs propriétaires des connexions doivent partager toutes les connexions avec l’utilisateur qui active le flux.
• Si un utilisateur est propriétaire de toutes les connexions du flux, cet utilisateur peut activer le flux.

Une fois que le flux a été activé par le propriétaire des connexions, il dispose des autorisations nécessaires pour utiliser ces connexions. À partir de ce moment, tout copropriétaire du flux peut activer le flux.

Un flux peut-il être activé par le propriétaire de ses connexions, puis la propriété peut-elle être transférée à un autre utilisateur ?

Oui. Lorsqu’un flux est activé par le propriétaire des connexions utilisées par le flux, le flux obtient l’autorisation explicite d’utiliser ces connexions. Les copropriétaires du flux peuvent ensuite activer et désactiver le flux selon leurs besoins.

Les autorisations accordées aux applications et aux flux qui utilisent une connexion sont visibles dans la page des détails de cette connexion dans les onglets Applications qui utilisent cette connexion et Flux qui utilisent cette connexion.

Si le flux est modifié pour ajouter de nouvelles actions qui utilisent des références de connexion supplémentaires avec de nouvelles connexions, le propriétaire de ces nouvelles connexions doit activer initialement le flux lui-même ou partager les connexions avec le propriétaire qui active le flux. Pour plus d’informations : Partager les ressources d’une application

La propriété d’une référence de connexion peut-elle être transférée à un autre utilisateur ?

La propriété d’une référence de connexion ne peut pas être transférée à un autre utilisateur à partir de la zone Solutions dans Power Apps (make.powerapps.com).

Cependant, l’explorateur de solutions classique peut être utilisé pour modifier les privilèges d’une référence de connexion, y compris le partage.

Voir aussi

Connecteurs

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).