Vue d’ensemble des variables d’environnement pour Power Platform

Les variables d’environnement activent le scénario de gestion du cycle de vie des applications (ALM) de base pour déplacer une application entre les environnements Power Platform. Dans ce scénario, l’application reste exactement la même, à l’exception de quelques références d’applications externes clés (comme les tables, connexions et clés) qui sont différentes entre l’environnement source et l’environnement de destination. L’application exige que la structure des tables ou des connexions soit exactement la même entre l’environnement source et l’environnement de destination, à quelques différences près. Les variables d’environnement vous permettent de spécifier laquelle de ces différentes références externes doit être mise à jour lorsque l’application est déplacée entre différents environnements.

Les variables d’environnement stockent les clés et les valeurs des paramètres, qui servent ensuite d’entrée à divers autres objets d’application. La séparation des paramètres des objets qui les consomment vous permet de modifier les valeurs dans le même environnement ou lorsque vous migrez des solutions vers d’autres environnements. L’alternative consiste à laisser les valeurs des paramètres codées en dur dans les composants qui les utilisent. Cela est souvent problématique, surtout lorsque les valeurs doivent être modifiées pendant les opérations ALM. Les variables d’environnement étant des composants de solution, vous pouvez transporter les références (clés) et modifier les valeurs lorsque les solutions sont migrées vers d’autres environnements.

Avantages d’utiliser des variables de l’environnement :

• Fournir de nouvelles valeurs de paramètres pendant l’importation de solutions dans d’autres environnements.
• Configurer le magasin pour les sources de données utilisées dans les applications canevas et les flux. Par exemple, les paramètres de liste et de site SharePoint peuvent être stockés en tant que variables d’environnement ; cela vous permet ainsi de vous connecter à différents sites et listes dans différents environnements sans avoir à modifier les applications et les flux.
• Emballer et transporter votre personnalisation et votre configuration ensemble et les gérer dans un seul endroit.
• Emballer et transporter les clés secrètes, telles que les informations d’identification utilisées par différents composants, de façon distincte des composants qui les utilisent.
• Une variable d’environnement peut être utilisée dans de nombreux composants de solution différents, qu’ils soient du même type de composant ou différents. Par exemple, une application canevas et un flux peuvent utiliser la même variable d’environnement. Lorsque la valeur de la variable d’environnement doit changer, vous ne devez modifier qu’une seule valeur.
• De plus, si vous devez retirer une source de données d’environnements de production, vous pouvez simplement mettre à jour les valeurs des variables d’environnement avec des informations concernant la nouvelle source de données. Les applications et les flux ne nécessitent aucune modification et commencent à utiliser la nouvelle source de données.
• La prise en charge par les outils SolutionPackager et DevOps permet une intégration continue et une livraison continue.
• Les variables d’environnement peuvent être décompressées et stockées dans le contrôle de code source. Vous pourriez également stocker différents fichiers de valeurs de variables d’environnement pour la configuration distincte nécessaire dans chaque environnement. Solution Packager peut accepter le fichier correspondant à l’environnement dans lequel la solution est importée.

Comment fonctionnent les variables d’environnement ?

Les variables d’environnement peuvent être créées et modifiées dans l’interface de solution moderne, automatiquement créées lors de la connexion à certaines sources de données dans les applications canevas, ou à l’aide de code. Elles peuvent également être importées dans un environnement via des solutions. Une fois que les variables d’environnement sont présentes dans un environnement, elles peuvent être utilisées comme entrées lors de la création d’applications canevas, de flux Power Automate, lors du développement de plug-ins, ainsi qu’à de nombreux autres endroits, comme pour ajouter un tableau de bord Power BI à une application pilotée par modèle. Lorsque ces types d’objets utilisent des variables d’environnement, les valeurs sont ensuite dérivées des variables d’environnement et peuvent être modifiées lorsque des solutions sont importées dans d’autres environnements.

Créer une variable d’environnement dans une solution

1. Connectez-vous à Power Apps (make.powerapps.com), puis dans le volet de 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é.
2. Ouvrez la solution souhaitée ou créez-en une nouvelle.
3. Dans la barre de commandes, sélectionnez Nouveau>Plus, puis sélectionnez Variable d’environnement.
4. Dans le volet de droite, renseignez les colonnes suivantes, puis sélectionnez Enregistrer :

   • Nom complet. Entrez un nom pour la variable d’environnement.

   • Nom. Le nom unique est généré automatiquement à partir du Nom d’affichage, mais vous pouvez le changer.

   • Type de données. Sélectionnez depuis Nombre décimal, Texte, JSON, Deux options, Source de données ou Clé secrète.

     Note

     • Si Source de données est le type sélectionné, vous devrez également sélectionner le connecteur, une connexion valide pour le connecteur sélectionné, et le type de paramètre. Toutefois, la connexion n’est pas stockée dans le cadre de la variable d’environnement. La connexion n’est utilisée que pour récupérer les valeurs de paramètres disponibles telles que les sites SharePoint auxquels vous avez accès ou les listes associées à un site. Pour certains paramètres tels que les listes SharePoint, vous devrez également sélectionner une variable d’environnement de source de données parente telle que le site SharePoint. Une fois enregistrés, ceux-ci seront liés dans la base de données.
     • Si Clé secrète est le type sélectionné, des informations supplémentaires pour installer et configurer Azure Key Vault sont nécessaires pour permettre à Power Platform d’accéder à la clé secrète.

   • Current Value. Aussi connu sous le nom de valeur. Cette propriété est facultative et fait partie de la table de valeur des variables d’environnement. Lorsqu’une valeur est présente, elle est utilisée, même si une valeur par défaut est également présente. Supprimez la valeur de votre solution si vous ne souhaitez pas l’utiliser dans le prochain environnement. Les valeurs sont également séparées dans des fichiers JSON distincts au sein du fichier solution.zip exporté et peuvent être modifiées hors connexion. Plus d’informations : Comment supprimer une valeur d’une variable d’environnement ?

   • Valeur par défaut. Cette colonne fait partie de la table de définition des variables d’environnement et n’est pas obligatoire. La valeur par défaut est utilisée s’il n’y a pas de valeur en cours.

     La séparation de la valeur par défaut et de la valeur actuelle vous permet de traiter la définition et la valeur par défaut séparément de la valeur. Par exemple, un éditeur d’application peut répertorier son offre sur AppSource avec une valeur par défaut. Ensuite, de manière facultative, le client peut fournir une nouvelle valeur. Lorsque l’éditeur de l’application publie des mises à jour de l’application, la valeur définie par le client ne sera pas écrasée.

     

     Note

     Une valeur ne peut pas exister sans définition. L’interface permet uniquement de créer une valeur par définition.

Saisir de nouvelles valeurs lors de l’importation de solutions

L’interface d’importation de solution moderne inclut la possibilité de saisir des valeurs pour les variables d’environnement. Cela définit la propriété de valeur sur la table environmentvariablevalue.

À partir d’une mise à jour du 7 décembre 2023, toutes les valeurs des variables d’environnement sont visibles lors de l’importation de solutions (ou lors de utilisation de Pipelines pour déployer). Les variables d’environnement sans valeur ou valeur par défaut seront invitées à saisir une valeur, mais celles qui autrement sont pré-remplies avec une étiquette sous la zone de texte indiquant la source de la valeur : valeur de la solution, valeur de l’environnement cible ou valeur par défaut.

Notification

Une notification s’affiche lorsque les variables de l’environnement n’ont pas de valeur. Ceci est un rappel pour définir les valeurs afin que les composants dépendant de variables d’environnement n’échouent pas.

Sécurité

La table environmentvariabledefinition appartient à l’utilisateur ou à l’équipe. Lorsque vous créez une application qui utilise des variables d’environnement, veillez à attribuer aux utilisateurs le niveau de privilège approprié à cette table. L’autorisation d’accès à la table environmentvariablevalue est héritée de la table environmentvariabledefinition parent et ne nécessite donc pas de privilèges distincts. Les privilèges pour les tables environmentvariabledefinition sont inclus par défaut dans les rôles de sécurité Créateur d’environnement et utilisateur de base. Pour plus d’informations : Rôles de sécurité dans Dataverse.

Affectation de noms

Assurez-vous que les noms de variables d’environnement sont uniques afin qu’ils puissent être référencés avec précision. Les noms d’affichage des variables d’environnement en double rendent les variables d’environnement difficiles à différencier et à utiliser. Assurez-vous que les noms de variables d’environnement sont uniques afin qu’ils puissent être référencés avec précision. Les noms $authentification et $connection sont des paramètres spécialement réservés aux flux et doivent être évités. La sauvegarde du flux est bloquée si des variables d’environnement portant ces noms sont utilisées. Si une variable d’environnement est utilisée dans un flux et que le nom complet de la variable d’environnement est modifié, alors le concepteur montrera à la fois l’ancien et le nouveau jeton de nom d’affichage pour aider à l’identification. Lors de la mise à jour du flux, il est recommandé de supprimer la référence de variable d’environnement et de l’ajouter à nouveau.

Limitations actuelles

• La validation des valeurs des variables d’environnement se produit dans les interfaces utilisateur et dans les composants qui les utilisent, mais pas dans Dataverse. Par conséquent, assurez-vous que les valeurs appropriées sont définies si elles sont modifiées via le code.
• Les Tâches Power Platform Build Tools ne sont pas encore disponibles pour la gestion des variables d’environnement de source de données. Cependant, cela ne bloque pas leur utilisation dans les outils fournis par Microsoft et dans les systèmes de contrôle de code source.
• L’interaction avec les variables d’environnement via un code personnalisé nécessite un appel d’API pour récupérer les valeurs ; il n’y a pas de cache exposé pour le code non Microsoft à utiliser.
• Pour utiliser avec succès les variables d’environnement avec les listes SharePoint, le nom complet et le nom logique de chaque colonne correspondante dans les environnements source et cible doivent correspondre.
• Les variables d’environnement sont limitées à un maximum de 2 000 caractères.

Questions fréquentes

Pourquoi ne puis-je pas voir la valeur de ma variable d’environnement ?

Si la variable d’environnement se trouve dans un solution gérée, vous ne pourrez pas voir la valeur à moins de regarder à l’intérieur de la Solution par défaut. Ce comportement est inhérent à la conception, puisque la valeur de la variable d’environnement est une personnalisation non gérée.

Comment puis-je voir où les variables d’environnement sont utilisées ?

Soit en sélectionnant Afficher les dépendances dans l’interface de la solution, lors de la création de composants, soit dans le contrôle de code source et dans le fichier de solution en affichant les métadonnées de l’application ou du flux.

Les variables d’environnement de la source de données sont-elles identiques aux connexions ?

Non Bien qu’elles soient liées, une connexion représente une information d’identification ou une authentification requise pour interagir avec le connecteur. Les variables d’environnement de source de données stockent les paramètres requis par une ou plusieurs actions dans le connecteur, et ces paramètres varient souvent en fonction de l’action. Par exemple, une connexion à SharePoint Online ne stocke aucune information sur les sites, les listes ou les bibliothèques de documents. Par conséquent, l’appel du connecteur nécessite à la fois une connexion valide ainsi que certains paramètres supplémentaires.

Les variables d’environnement de source de données peuvent-elles être utilisées avec des connexions partagées telles que SQL Server avec l’authentification SQL ?

En règle générale, non. Les connexions partagées avec SQL Server stockent les paramètres requis pour se connecter aux données au sein de la connexion. Par exemple, le nom du serveur et de la base de données sont fournis lors de la création de la connexion et sont donc toujours dérivés de la connexion.

Les variables d’environnement de la source de données sont utilisées pour les connecteurs qui dépendent de l’authentification basée sur l’utilisateur, telle que Microsoft Entra ID, car les paramètres ne peuvent pas être dérivés de la connexion. Pour ces raisons, l’authentification avec SQL Server, qui est une connexion partagée, n’utilisera pas les variables d’environnement de la source de données.

Mon pipeline ALM automatisé peut-il utiliser des fichiers de valeurs différents pour différents environnements ?

Oui. Le Packager de solution accepte le nom de fichier comme paramètres d’entrée afin que votre pipeline puisse intégrer un autre fichier de valeurs dans la solution, en fonction du type d’environnement sur lequel il s’exécute.

Dois-je inclure la valeur dans ma solution ?

Non Les variables d’environnement sont destinées à être utilisées par des applications qui doivent avoir des valeurs différentes dans différents environnement où la solution est déployée. Les définitions de variables d’environnement doivent être incluses dans votre solution, mais les valeurs de l’environnement cible doivent être fournies lors du déploiement. Ce comportement fait que la définition de la variable Sélectionner est un objet solution gérée dans la cible Sélectionner tandis que la variable Sélectionner est un enregistrement non géré.

Pourquoi ne puis-je pas supprimer une valeur dans mon environnement ?

Si la valeur a été incluse dans un solution gérée, la seule façon de supprimer la valeur est de mettre à jour la solution dans la source environnement pour exclure la valeur, puis d’exporter une nouvelle version de la solution. Cette nouvelle version peut ensuite être importée dans l’environnement à l’aide d’une opération de mise à niveau (et non d’une mise à jour), ce qui entraîne la suppression de l’enregistrement de la valeur.

Que faire si quelqu’un supprime une valeur par inadvertance ?

Si ce n’est pas rendu impossible par le système de dépendance, le runtime utilise la dernière valeur connue comme solution de secours.

Si une valeur est modifiée, quand la nouvelle valeur est-elle utilisée dans les applications canevas et les flux cloud ?

La publication complète des variables d’environnement mises à jour peut prendre jusqu’à une heure, car la valeur est transmise aux applications et circule de manière asynchrone.

Des licences Premium sont-elles requises ?

Non Tant que ALM nécessite Dataverse (ou applications Dynamics 365), l’utilisation de connecteurs premium n’est pas requise. La seule mise en garde concerne le cas où vous utilisez le connecteur Dataverse pour interagir avec les variables d’environnement comme vous le feriez avec d’autres enregistrements de données tels que des comptes ou des contacts. Auparavant, c’était la seule façon d’utiliser des variables d’environnement dans les applications canevas et les flux.

Y a-t-il une limite au nombre de variables d’environnement que je peux avoir ?

Non Cependant, la taille maximale d’une solution est de 95 Mo. Pour plus d’informations, voir Créer une solution

Les noms d’affichage et les descriptions des variables d’environnement peuvent-ils être localisés ?

Oui.

Dois-je utiliser des variables d’environnement au lieu de stocker des données de configuration dans des tables personnalisées ?

Oui si vos données de configuration ne sont pas relationnelles. Les variables d’environnement doivent être utilisées pour les paires clé-valeur et lorsque la valeur doit probablement être différente dans d’autres environnements. D’autres outils tels que l’utilitaire de migration de configuration conviennent mieux à la migration des données de configuration relationnelles stockées dans des tables personnalisées. Contrairement aux autres données de configuration, les variables d’environnement sont migrées au sein des solutions et donc beaucoup plus simples à gérer et leur importation est plus performante.

Pourquoi ma connexion n’est-elle pas enregistrée pour les variables source de données environnement ?

Les connexions ne servent qu’à générer l’interface utilisateur. Par exemple, pour récupérer des noms conviviaux pour les listes SharePoint associées à un site. Lorsque vous modifiez une variable source de données environnement, assurez-vous d’établir une connexion avec accès à source de données. Si vous n’avez plus accès à la connexion, vous pouvez saisir manuellement une valeur. Par exemple, entrez l’URL du site SharePoint ou l’identificateur unique (GUID) d’une liste.

Lorsque plusieurs connexions sont disponibles pour une seule variable d’environnement (type de source de données), une mise en place intentionnelle permet de sélectionner la première connexion dans la liste des connexions. Comme il n’y a généralement qu’une seule connexion associée à une variable d’environnement, il n’est pas nécessaire de la valider. En outre, grâce aux récents changements apportés à la visibilité des valeurs des variables d’environnement, il est plus facile de les valider lors de l’importation.

Comment supprimer une valeur d’une variable d’environnement ?

Vous souhaiterez peut-être supprimer la valeur d’une variable d’environnement de votre solution avant d’exporter la solution. Ensuite, cela garantit que la valeur existante reste dans votre environnement de développement, mais n’est pas exportée dans la solution. Cette approche permet d’apporter une nouvelle valeur lors de l’importation de la solution dans un autre environnement.

Pour supprimer la valeur, procédez comme suit :

1. Dans la solution où se trouve la variable d’environnement, sélectionnez la variable d’environnement pour afficher les propriétés.

2. Sous Valeur actuelle, sélectionnez ...>Supprimer de cette solution.

   

Puis-je utiliser des variables d’environnement dans des connecteurs personnalisés ?

Oui. Prise en charge d’une variable d’environnement dans un connecteur personnalisé

Voir aussi

Utiliser des variables d’environnement de source de données dans les applications canevas
Utiliser les variables d’environnement dans les flux de cloud de la solution Power Automate
Référence de table/entité EnvironmentVariableDefinition
Exemples d’API web
Utiliser les variables de l’environnement de source de données dans les applications canevas
Utiliser les variables d’environnement dans les flux de cloud de solution Power Automate
Utiliser les secrets Azure Key Vault
Support de variable d’environnement dans les connecteurs personnalisés
Blog Power Apps : Variables d’environnement disponibles en version préliminaire !