Utiliser des variables d’environnement de source de données dans les applications canevas

Dans cet article, vous allez découvrir comment utiliser des variables d’environnement de source de données dans les applications de canevas. Vous pouvez utiliser des variables d’environnement de source de données préexistantes ou créer des variables d’environnement de source de données automatiquement lors de la connexion aux données.

Utiliser des variables d’environnement de source de données préexistante

Vous pouvez réutiliser des variables d’environnement dans d’autres applications et même différents types de ressources, comme les flux cloud. Vous pouvez commencer par les créer dans votre solution et les utiliser ultérieurement lors de la création d’applications canevas et de flux de cloud. Les étapes suivantes utilisent SharePoint Online comme exemple.

1. Suivez les étapes pour créer manuellement une variable d’environnement dans une solution.
2. Modifiez ou créez une application canevas à partir de votre solution.
3. Ajoutez une nouvelle source de donnée pour SharePoint Online.
4. Sélectionnez l’onglet Avancé . Vous voyez une liste filtrée de variables d’environnement disponibles auxquelles vous avez accès et qui correspondent au paramètre défini. Par exemple, lorsque vous sélectionnez le site SharePoint, la liste contient des variables d’environnement de source de données avec Connector comme SharePoint et le type de paramètre en tant que site. La même chose est vraie lors de la sélection de listes SharePoint pour un site donné. Si une variable existante n’apparaît pas, consultez Limitations et résolution des problèmes.
5. Sélectionnez la ou les variables d’environnement sélectionnées, puis sélectionnez Connecter.

Créer automatiquement des variables d’environnement de source de données pendant la connexion aux données

Cette option offre une simplicité et garantit que les variables d’environnement sont toujours utilisées pour les sources de données, telles que SharePoint Online. Cependant, certains clients préfèrent fournir leurs propres noms de schéma et doivent donc les créer à partir de solutions.

1. Modifiez ou créez une application canevas à partir de votre solution.

2. Sélectionnez Paramètres>Général et activez le paramètre pour Créer automatiquement des variables d’environnement lors de l’ajout de sources de données.

3. Ajoutez une nouvelle Nouvelle source de donnée pour SharePoint Online.

4. Sélectionnez un site SharePoint, une ou plusieurs listes, puis Connecter.

   Note

   Pour empêcher la création de variables d’environnement en double, vous êtes invité à utiliser la variable d’environnement existante lorsque des doublons sont identifiés. Vous pouvez désactiver l’option pour utiliser la variable d’environnement existante si la création d’un doublon est souhaitée.

5. Cliquez sur Enregistrer.

Limitations et résolution des problèmes

Une variable d’environnement peut exister dans votre environnement sans apparaître dans le sélecteur de source de données Canvas Studio. Vérifiez les limites suivantes lorsque vous ne trouvez pas de variable.

Limitations du sélecteur Canvas Studio

Cette limitation s’applique lors de la sélection de variables d’environnement de source de données pour les connecteurs pris en charge, y compris SharePoint et SQL Server. Pour SQL Server, il s’applique aux types de connexion qui prennent en charge les variables d’environnement de source de données, telles que les connexions Microsoft Entra.

Le sélecteur de source de données Canvas Studio récupère uniquement la première page des définitions et valeurs des variables d’environnement qui correspondent au connecteur et au type de paramètre sélectionnés. Elle ne récupère pas les pages suivantes. Chaque requête Dataverse retourne jusqu’à 5 000 enregistrements correspondants. Par conséquent, certaines variables peuvent ne pas apparaître sous l’onglet Advanced ou ses résultats de recherche. La recherche d’une variable manquante ne la récupère pas à partir d’une page ultérieure.

Cette limitation concerne le sélecteur, et non une limite de 5 000 variables d’environnement dans Dataverse. Le nombre pertinent est le nombre de définitions ou de valeurs correspondantes pour chaque requête, et non le nombre total de variables dans tous les connecteurs de l’environnement.

Pour atténuer cette limitation, réutilisez les variables existantes et supprimez les variables obsolètes après avoir vérifié leurs dépendances. Ne supprimez pas les variables que les applications ou les flux utilisent toujours. Si vous ne pouvez pas réduire le nombre de variables, envisagez un environnement plus petit qui contient les variables et les applications dont vous avez besoin. Le déplacement de variables dans différentes solutions dans le même environnement ne réduit pas le nombre de variables dans cet environnement.

vérifications de configuration spécifiques à SharePoint

Outre la limitation de pagination qui s’applique dans l’ensemble des connecteurs pris en charge, les variables SharePoint doivent répondre à ces exigences de configuration :

• Une variable de site a besoin d’une valeur actuelle non vide ou d’une valeur par défaut qui contient l’URL du site SharePoint. Le sélecteur ne répertorie pas les variables de site dont les deux valeurs sont vides.
• La valeur d’une variable de liste doit correspondre à l’identificateur unique (GUID) d’une liste retournée pour le site sélectionné et la connexion, et non au nom d’affichage de la liste. Vérifiez que la connexion a accès à la liste et que la variable contient son identificateur.

Voir aussi

Créer une application canevas à partir de zéro à l’aide de Dataverse.
Utiliser les variables d’environnement dans les flux de cloud de la solution Power Automate
Vue d’ensemble des variables d’environnement