Partager via

Utiliser les paramètres pour fournir des expériences d’application personnalisées

Les paramètres sont des composants de solution qui permettent aux créateurs et aux administrateurs de configurer rapidement des applications pour offrir une expérience personnalisée. Les paramètres peuvent être utilisés pour activer ou désactiver des fonctionnalités ou configurer le comportement des fonctionnalités pour une application unique ou toutes les applications au sein d’un environnement.

Les paramètres sont constitués de trois sous-composants : définition, définition de la valeur de l’environnement et définition de la valeur de l’application.

Sous-composant Descriptif
Définition des paramètres
  • Les auteurs d’applications, les administrateurs ou les partenaires peuvent créer une définition de paramètre qui inclut des propriétés telles que le nom, la description, le type de données, la valeur par défaut, etc.
  • Ils peuvent ensuite, via du code, utiliser la valeur du paramètre pour activer ou désactiver ou configurer la fonctionnalité qu’ils fournissent.
  • Ils peuvent inclure la définition de paramètre dans la solution utilisée pour fournir la fonctionnalité à leurs clients.
  • Exemple :
    • Le gestionnaire d’enregistrement asynchrone pour les applications basées sur des modèles est une fonctionnalité de Power Apps qui utilise des paramètres.
    • Le paramètre est de type Oui/Non et la valeur par défaut de ce paramètre est Non.
    • Par conséquent, par défaut, la fonctionnalité du gestionnaire d’enregistrement Async est désactivée pour toutes les applications pilotées par modèle.
Définition de la valeur de l’environnement
  • Une valeur d’environnement de paramètre peut être utilisée pour remplacer la valeur par défaut, comme spécifié dans la définition de paramètre.
  • Exemple :
    • En prolongeant l'exemple ci-dessus, un administrateur d'environnement dans l'organisation d'un client peut ajouter une valeur de paramètre d'environnement pour le paramètre de gestionnaire d'enregistrement asynchrone et le définir sur Oui.
    • Cette valeur d’environnement de paramètre remplace la valeur par défaut et s’applique à toutes les applications de cet environnement.
    • Cela active la fonctionnalité de gestionnaire d’enregistrement asynchrone pour toutes les applications basées sur des modèles dans cet environnement.
Définition de la valeur de l’application
  • Une valeur d’application de paramètre peut être utilisée pour remplacer la valeur par défaut, comme spécifié dans la définition de paramètre, et la valeur d’environnement de paramètre (si un existe).
  • Exemple :
    • Une fois de plus, en reprenant l'exemple ci-dessus, un auteur d’application dans le même environnement peut ajouter une valeur de paramètre d'application pour le paramètre gestionnaire de sauvegarde asynchrone pour une application qu’il crée et la définir sur Non
    • Cette valeur de paramètre de l'application remplace la valeur de l'environnement de paramètres et s'applique à cette application uniquement.
    • Cela active la fonctionnalité de gestionnaire d’enregistrement asynchrone pour cette application unique.

Note

Pour suivre les étapes répertoriées ci-dessous, vous devez disposer d’un aperçu de la solution. Dans la zone Solutions de Power Apps, dans la barre de commandes, vérifiez que vous disposez d’une préversion de solution. Si l’aperçu de la solution est désactivé , sélectionnez l’option permettant d’activer l’aperçu. Plus d’informations : Vue de la solution

Définition de paramètre

Une définition de paramètre spécifie les propriétés de base d’un paramètre. La liste complète des propriétés qui peuvent être configurées sur une définition de paramètre est répertoriée ci-dessous. Certaines de ces propriétés ne peuvent pas être modifiées une fois le paramètre créé.

Propriété Descriptif
Nom d'affichage Nom affiché aux consommateurs du paramètre dans toutes les interfaces utilisateur où les paramètres sont affichés.
Nom Le nom unique du paramètre dans un environnement.
Le nom est généré automatiquement en fonction du nom d'affichage fourni, mais il peut être modifié avant la création des paramètres. Une fois qu’un paramètre est créé, le nom ne peut pas être modifié, car il peut être référencé dans des applications ou du code.
Le nom a un préfixe qui correspond à l’éditeur de solution. Ce préfixe est destiné à donner au paramètre un nom unique si vous souhaitez les importer dans une autre solution ou environnement à l’avenir (qui aurait un préfixe différent).
Description La description aide d’autres utilisateurs à comprendre ce que le paramètre est utilisé dans toutes les interfaces utilisateur où les paramètres sont affichés.
Type de données Le type de données d’un paramètre contrôle la façon dont la valeur du paramètre est stockée. Le type de données peut être défini sur Nombre, Chaîne ou Oui/Non. Le type de données ne peut pas être modifié une fois le paramètre créé.
Valeur par défaut La valeur par défaut devient disponible après avoir sélectionné un type de données. Elle spécifie la valeur du paramètre qui sera utilisée, sauf si elle est remplacée par une valeur d’environnement de paramètre ou une valeur d’application de paramètre.
La valeur peut être modifiée pour Un paramètre peut être remplacé à l’un des niveaux suivants :
  • L’environnement et l’application permettent à la fois de définir la valeur de l’environnement et de définir des valeurs d’application pour remplacer la valeur par défaut.
  • Environnement uniquement, permet uniquement à la valeur de l'environnement de remplacer la valeur par défaut.
  • L’application uniquement permet de définir uniquement les valeurs d’application pour remplacer la valeur par défaut.
  • Aucun, le paramètre ne peut pas être remplacé.
Niveau de mise en production Le niveau de version est utilisé pour informer le cadre et les autres utilisateurs du paramètre sur l’état de la fonctionnalité avec laquelle le paramètre est utilisé. Le niveau de mise en production peut être défini sur Disponibilité générale ou préversion.
URL des informations Lien vers la documentation pour aider les consommateurs du paramètre à comprendre l’objectif du paramètre. Sera utilisé comme lien En savoir plus dans toutes les interfaces utilisateur où les paramètres sont affichés.

Ajout d’une nouvelle définition de paramètre

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter le paramètre.
  4. Dans la barre de commandes, sélectionnez Nouveau > Plus > Paramètre > Définition de paramètre.
  5. Dans la boîte de dialogue Nouveau paramètre , fournissez des valeurs pour chacune des propriétés en fonction de vos besoins. Pour plus d’informations sur la définition des propriétés de définition, accédez à : Définition de la définition
  6. Lorsque vous avez terminé de fournir des valeurs pour les propriétés, sélectionnez Enregistrer.

Ajout d’une définition de paramètre existante

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter le paramètre.
  4. Dans la barre de commandes, sélectionnez Ajouter un paramètre supplémentaire > existant>.
  5. Dans la boîte de dialogue Ajouter une définition de paramètre existante , sélectionnez un ou plusieurs paramètres que vous souhaitez ajouter.
  6. Lorsque vous avez terminé de sélectionner des paramètres, sélectionnez Suivant
  7. Dans la boîte de dialogue Définition de paramètre sélectionné , pour chaque paramètre que vous avez sélectionné, vous avez la possibilité d’inclure la définition de paramètre. Vous pouvez également inclure la valeur d’environnement de paramètre pour chaque paramètre, s’il en existe un.
  8. Sélectionnez Ajouter pour ajouter la définition de paramètre et/ou définir des valeurs d’environnement.

Mise à jour d’une définition de paramètre

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution dans laquelle vous avez créé le paramètre.
  4. Dans l’arborescence, sélectionnez Paramètres > Définition des paramètres.
  5. Sélectionnez la définition de paramètre à mettre à jour.
  6. Dans la boîte de dialogue Modifier le paramètre , mettez à jour les valeurs de l’une des propriétés que vous souhaitez modifier.
    Notez que certaines propriétés ne peuvent pas être mises à jour après la création d’un paramètre. En outre, dans la plupart des cas, vous ne pourrez pas mettre à jour les définitions de paramètres que vous ne possédez pas.
  7. Lorsque vous avez terminé de mettre à jour les valeurs des propriétés, sélectionnez Enregistrer.

Suppression d’une définition de paramètre

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous avez créé ou ajouté le paramètre.
  4. Dans l’arborescence, sélectionnez Paramètres > Définitions des paramètres.
  5. Sélectionnez la définition de paramètre à supprimer.
  6. Dans la barre de commandes, sélectionnez Supprimer > de cette solution.
    La suppression de cette solution supprime la définition de paramètre de la solution actuelle, mais elle continuera d’être une partie de la solution par défaut ou toute autre solution à qui elle a été ajoutée.

Suppression d’une définition de paramètre

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous avez créé ou ajouté le paramètre.
  4. Dans l’arborescence, sélectionnez Paramètres > Définitions des paramètres.
  5. Sélectionnez la définition de paramètre à supprimer.
  6. Dans la barre de commandes, sélectionnez Retirer > Supprimer de cet environnement.
    La suppression de cet environnement supprime la définition de paramètre de l’environnement actuel et ne fait plus partie des solutions de cet environnement. Vous ne pouvez supprimer les définitions de paramètre que vous possédez.

Définition de la valeur de l’environnement

Une valeur d’environnement de paramètre est utilisée pour remplacer la valeur par défaut du paramètre pour toutes les applications d’un environnement. Utilisez une valeur d’environnement de paramètre lorsque la valeur par défaut du paramètre n’est pas ce que vous souhaitez utiliser pour les applications de votre environnement.

Ajout d'une nouvelle valeur de paramétrage d'environnement

  1. Connectez-vous à Power Apps.

  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter la valeur de l'environnement de configuration.

  4. Si la définition de paramètre est disponible dans la solution :

    1. Sélectionnez la définition du paramètre.
    2. Dans la boîte de dialogue Modifier la valeur du paramètre , dans la section Définition de la valeur de l’environnement , sélectionnez Nouvelle valeur.
    3. Indiquez la valeur, puis sélectionnez Enregistrer.

    Si la définition de paramètre n’est pas disponible dans la solution :

    1. Dans la barre de commandes, sélectionnez Nouveau > Plus > Paramètre > Valeur d’environnement de paramètre.
    2. Sélectionnez le paramètre pour lequel vous souhaitez ajouter la valeur d’environnement de paramètre, puis sélectionnez Ajouter.
    3. Dans la boîte de dialogue Nouvelle valeur d’environnement de paramètre , dans la section Définition de la valeur de l’environnement , sélectionnez Nouvelle valeur.
    4. Indiquez la valeur, puis sélectionnez Enregistrer.

Ajout d'une variable d'environnement existante

  1. Connectez-vous à Power Apps.

  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter la valeur de l'environnement de configuration.

  4. Si la définition de paramètre est disponible dans la solution :

    1. Sélectionnez la définition du paramètre.
    2. Dans la boîte de dialogue Modifier la valeur du paramètre , dans la section Définition de la valeur de l’environnement , sélectionnez Ajouter une valeur existante.
    3. Mettez à jour la valeur si nécessaire, puis sélectionnez Enregistrer.

    Si la définition de paramètre n’est pas disponible dans la solution :

    1. Dans la barre de commandes, sélectionnez Ajouter un paramètre supplémentaire > existant>.
    2. Dans la boîte de dialogue Ajouter une définition de paramètre existante , sélectionnez un ou plusieurs paramètres dont vous souhaitez ajouter des valeurs d’environnement de paramètre.
    3. Lorsque vous avez terminé de sélectionner des paramètres, sélectionnez Suivant
    4. Dans la boîte de dialogue Définition de paramètre sélectionné , pour chaque paramètre que vous avez sélectionné, vous avez la possibilité d’inclure la valeur de l’environnement de paramètre, le cas échéant. Vous pouvez également inclure la définition de paramètre pour chaque paramètre si vous le souhaitez.
    5. Sélectionnez Ajouter pour ajouter les valeurs d’environnement de paramètre et/ou les définitions de paramètre.

Mise à jour d'une valeur de l'environnement de configuration

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous avez ajouté la valeur du paramètre d'environnement.
  4. Dans l’arborescence, sélectionnez Paramètres définissant les > valeurs d’environnement.
  5. Sélectionnez la valeur d’environnement de paramètre que vous souhaitez mettre à jour.
  6. Dans la boîte de dialogue Modifier le paramètre , dans la section Définition de la valeur de l’environnement , mettez à jour la valeur, puis sélectionnez Enregistrer.

Effacement d’une valeur d’environnement de configuration

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous avez créé ou ajouté le paramètre.
  4. Dans l’arborescence, sélectionnez Paramètres définissant les > valeurs d’environnement.
  5. Sélectionnez la valeur d’environnement de paramètre à supprimer.
  6. Dans la barre de commandes, sélectionnez Supprimer > de cette solution.
    La suppression de cette solution supprime la valeur de l’environnement de paramètre de la solution actuelle, mais elle continuera d’être une partie de la solution par défaut ou toute autre solution à qui elle a été ajoutée.

Suppression d'une valeur dans l'environnement des paramètres

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous avez créé ou ajouté le paramètre.
  4. Dans l’arborescence, sélectionnez Paramètres définissant les > valeurs d’environnement.
  5. Sélectionnez la valeur d’environnement de paramètre à supprimer.
  6. Dans la barre de commandes, sélectionnez Supprimer > de cet environnement.
    Supprimer de cet environnement supprime la valeur d’environnement de paramètre de l’environnement actuel et elle ne fera plus partie des solutions de cet environnement.

Définition de la valeur de l’application

Une valeur d’application de paramètre est utilisée pour remplacer la valeur par défaut du paramètre et toute valeur d’environnement de paramètre pour une seule application. Utilisez une valeur de paramètre de l'application lorsque la valeur de l'environnement de paramètre n'est pas celle que vous souhaitez utiliser pour votre application. Si aucune valeur d’environnement de paramètre n’existe, utilisez une valeur d’application de paramètre lorsque la valeur par défaut du paramètre n’est pas ce que vous souhaitez utiliser pour votre application.

Note

Pour suivre les étapes répertoriées ci-dessous, vous devez utiliser le nouveau concepteur d’applications. Actuellement, le concepteur d’applications affiche uniquement les paramètres de la plateforme Power Apps. Pour les paramètres autres que la plateforme, utilisez l’Explorateur de solutions comme indiqué ci-dessous.

Ajout ou mise à jour d’une valeur de paramètre d'application à l’aide du concepteur d’applications

  1. Ouvrez l’application pour laquelle vous souhaitez ajouter la valeur du paramètre dans le concepteur d’application.
  2. Sur la barre de commandes, sélectionnez Paramètres.
  3. Dans la boîte de dialogue Paramètres , sélectionnez l’onglet Fonctionnalités ou À venir .
    L’onglet Fonctionnalités affiche tous les paramètres dont le niveau de mise en production est défini sur En disponibilité générale. L’onglet À venir affiche tous les paramètres dont le niveau de diffusion est réglé sur Préversion.
  4. Ajoutez ou mettez à jour une valeur d’application pour le paramètre souhaité.
  5. Enregistrez et publiez l’application.

Suppression d’une valeur d’application de paramètre à l’aide du concepteur d’application

  1. Ouvrez l’application dans le concepteur d’application pour laquelle vous souhaitez supprimer la valeur du paramètre d'application.
  2. Sur la barre de commandes, sélectionnez Paramètres.
  3. Dans la boîte de dialogue Paramètres , sélectionnez l’onglet Fonctionnalités ou À venir .
  4. Sélectionnez Réinitialiser la valeur d’environnement à côté de la valeur de l'application que vous souhaitez supprimer. Cela fait que la valeur du paramètre revienne à la valeur de l'environnement du paramètre, si elle est disponible. Si aucune valeur d’environnement de paramètre n’existe, elle revient à la valeur par défaut du paramètre.
    Notez que l’option Rétablir la valeur de l’environnement s’affiche uniquement si une valeur d’application de paramètre a été précédemment ajoutée pour ce paramètre.
  5. Enregistrez et publiez l’application.

Ajout ou mise à jour de la valeur d'une application à l'aide de l'Explorateur de solutions

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter la valeur du paramètre d'application.
  4. Si la définition de paramètre ou la valeur d’environnement de paramètre n’est pas disponible dans la solution, ajoutez l’une d’entre elles. Accédez à Ajout d’une définition de paramètre existante ou à l’ajout d’une valeur d’environnement de paramètre existante.
  5. Sélectionnez la définition de paramètre ou la valeur de l’environnement de définition.
  6. Dans la boîte de dialogue Modifier la valeur du paramètre, dans la section Définition des valeurs de l’application, recherchez l’application pour laquelle vous souhaitez ajouter la valeur de paramètre de l'application. Notez que, à l’aide de l’Explorateur de solutions, vous pouvez uniquement ajouter des valeurs d’application pour les applications qui se trouvent dans la solution actuelle.
  7. Indiquez la valeur et sélectionnez Enregistrer.
  8. Pour que la valeur de l’application définie prenne effet, vous devrez republier l’application à l’aide du concepteur d’applications ou de l’Explorateur de solutions.

Suppression d'une valeur de paramètre d'application à l'aide de l'Explorateur de solutions

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation, 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. Dans la liste des solutions, ouvrez la solution de laquelle vous souhaitez supprimer la valeur d’application de paramètre.
  4. Si la définition de paramètre ou la valeur d’environnement de paramètre n’est pas disponible dans la solution, ajoutez l’une d’entre elles. Plus d’informations : Ajout d’une définition de paramètre existante ou ajout d’une valeur d’environnement de paramètre existante.
  5. Sélectionnez la définition de paramètre ou la valeur de l’environnement de définition.
  6. Dans la boîte de dialogue Modifier la valeur du paramètre, dans la section Définition des valeurs des paramètres de l'application, recherchez l’application pour laquelle vous souhaitez supprimer la valeur du paramètre de l'application. Notez que l’utilisation de l’Explorateur de solutions vous permet de supprimer uniquement la définition des valeurs d’application pour les applications qui se trouvent dans la solution actuelle.
  7. Sélectionnez ... à côté de la valeur de paramètre d'application, puis sélectionnez Réinitialiser selon l'environnement.
  8. Cliquez sur Enregistrer.
  9. Pour que la suppression de la valeur de l’application définie prenne effet, vous devrez republier l’application à l’aide du concepteur d’application ou de l’Explorateur de solutions.

Obtention ou mise à jour d’une valeur de paramètre via du code

Pour les méthodes disponibles, accédez à Obtenir ou mettre à jour une valeur de paramètre à l’aide de l’API cliente.

Voir aussi

Pour les développeurs :

  • Last updated on