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

  • Article

Les paramètres sont des composants de solution qui permettent aux fabricants et 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 seule application ou toutes les applications d’un environnement.

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

Sous-composant Description
Définition de paramètre
  • 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 un code, utiliser la valeur du paramètre pour activer, désactiver ou configurer la fonctionnalité qu’ils proposent.
  • Ils peuvent inclure la définition de paramètre dans la solution utilisée pour fournir la fonctionnalité à leurs clients.
  • Exemple :
    • Le Gestionnaire save asynchrone pour les applications pilotées par modèle 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é Gestionnaire save asynchrone sera 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 développant l’exemple ci-dessus, un environnement administrateur dans l’organisation d’un client peut ajouter une valeur d’environnement de paramètre pour le paramètre Gestionnaire save asynchrone et définissez-le sur Oui.
    • Cette valeur d’environnement de paramètre remplacera la valeur par défaut et s’appliquera à toutes les applications de cet environnement.
    • Cela permettra à la fonctionnalité Gestionnaire save asynchrone pour toutes les applications pilotées par modèle 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 :
    • Encore une fois, le fait de développer l’exemple ci-dessus, un auteur d’application dans le même environnement ci-dessus, permet d’ajouter une valeur d’application de paramètre pour le paramètre Gestionnaire save asynchrone pour une application qu’il crée et de le définir sur Non
    • Cette valeur d’application de paramètre remplacera la valeur d’environnement de paramètre et ne s’appliquera qu’à cette seule application.
    • Cela permettra à la fonctionnalité Gestionnaire save asynchrone pour cette seule application.

Notes

Pour suivre les étapes énumérées ci-dessous, vous devez avoir Aperçu de la solution activé. De la zone Solutions dans Power Apps, dans la barre de commandes, assurez-vous d’avoir Aperçu de la solution activé. Si Aperçu de la solution désactivé s’affiche, sélectionnez l’option pour activer l’aperçu. Plus d’informations : Vue 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 pouvant ê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éé.

Property Description
Nom d’affichage Le 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 complet fourni, mais peut être modifié avant la création du paramètre. Une fois un paramètre créé, le Nom ne peut pas être modifié, car il peut être référencé dans vos applications ou votre code.
Nom a un préfixe qui correspond à l’éditeur de solutions. Ce préfixe est destiné à donner au paramètre un nom unique si vous souhaitez les importer dans une autre solution ou un autre environnement à l’avenir (qui aurait un préfixe différent).
Description La description aide les autres à comprendre à quoi sert le paramètre 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 manière 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 une fois que vous avez sélectionné un Type de données. Elle spécifie la valeur du paramètre qui sera utilisée à moins qu’elle ne soit 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 :
  • Environnement et application, permet à la fois à la valeur d’environnement de définition et aux valeurs d’application de définir la valeur par défaut.
  • Environnement uniquement, autorise uniquement la valeur de l’environnement de paramètre à remplacer la valeur par défaut.
  • Application uniquement, autorise uniquement les valeurs d’application de paramètre à remplacer la valeur par défaut.
  • Aucun, le paramètre ne peut pas être remplacé.
Niveau de publication Le niveau de version est utilisé pour informer l’infrastructure et les autres consommateurs du paramètre de l’état de la fonctionnalité avec laquelle le paramètre est utilisé. Le niveau de publication peut être défini sur Généralement disponible ou Aperçu.
URL d’information Un 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 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é.
  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 du paramètre
  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 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é.
  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 élément existant > Plus > Paramètre.
  5. Dans la boîte de dialogue Ajouter une définition de paramètre existant, sélectionnez un ou plusieurs paramètres que vous souhaitez ajouter.
  6. Lorsque vous avez terminé de sélectionner les paramètres, sélectionnez Suivant
  7. Dans la boîte de dialogue Définition du paramètre sélectionné, pour chaque paramètre que vous avez sélectionné, vous aurez la possibilité d’inclure la définition du paramètre. Vous pouvez également Inclure la valeur de l’environnement de paramètre pour chaque paramètre, s’il en existe.
  8. Sélectionnez Ajouter pour ajouter la définition de paramètre et/ou les valeurs d’environnement de paramètre.

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

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation 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é.
  3. Dans la liste des solutions, ouvrez la solution à laquelle vous avez créé 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 que vous souhaitez mettre à jour.
  6. Dans la boîte de dialogue Modifier le paramètre, mettez à jour les valeurs de toutes les 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. De plus, 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 pour les 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 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é.
  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 du paramètre à supprimer.
  6. Dans la barre de commandes, sélectionnez Supprimer > Supprimer de cette solution.
    Supprimer de cette solution supprime la définition de paramètre de la solution actuelle, mais elle continuera à faire partie de la solution par défaut ou de toute autre solution à laquelle elle a été ajoutée.

Suppression d’une définition de paramètre

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation 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é.
  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 du paramètre à supprimer.
  6. Dans la barre de commandes, sélectionnez Supprimer > Supprimer de cet environnement.
    Supprimer de cet environnement supprime la définition de paramètre de l’environnement actuel et elle ne fera plus partie des solutions de cet environnement. Vous pouvez supprimer uniquement 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 dans 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 d’environnement de définition

  1. Connectez-vous à Power Apps.

  2. Dans le volet de navigation 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é.

  3. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter la valeur d’environnement de paramètre.

  4. Si la définition du 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 Valeur de l’environnement du paramètre, sélectionnez Nouvelle valeur.
    3. Fournissez la valeur, puis sélectionnez Enregistrer.

    Si la définition du 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 auquel 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 Valeur de l’environnement du paramètre, sélectionnez Nouvelle valeur.
    4. Fournissez la valeur, puis sélectionnez Enregistrer.

Ajout d’une valeur d’environnement de paramètre existante

  1. Connectez-vous à Power Apps.

  2. Dans le volet de navigation 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é.

  3. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter la valeur d’environnement de paramètre.

  4. Si la définition du 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 Valeur de l’environnement du paramètre, sélectionnez Ajouter une valeur existante.
    3. Mettez à jour la valeur, le cas échéant, puis sélectionnez Enregistrer.

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

    1. Dans la barre de commandes, sélectionnez Ajouter un élément existant > Plus > Paramètre.
    2. Dans la boîte de dialogue Ajouter une définition de paramètre existant, sélectionnez un ou plusieurs paramètres que vous souhaitez ajouter aux valeurs d’environnement de paramètre.
    3. Lorsque vous avez terminé de sélectionner les paramètres, sélectionnez Suivant
    4. Dans la boîte de dialogue Définition du paramètre sélectionné, pour chaque paramètre que vous avez sélectionné, vous aurez la possibilité d’Inclure la valeur d’environnement du 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 d’environnement de paramètre

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

Suppression d’une valeur d’environnement de paramètre

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation 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é.
  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 > Valeurs d’environnement de paramètre.
  5. Sélectionnez la valeur d’environnement de paramètre que vous souhaitez supprimer.
  6. Dans la barre de commandes, sélectionnez Supprimer > Supprimer de cette solution.
    Supprimer de cette solution supprime la valeur d’environnement de paramètre de la solution actuelle, mais elle continuera à faire partie de la solution par défaut ou de toute autre solution à laquelle elle a été ajoutée.

Suppression d’une valeur d’environnement de paramètre

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation 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é.
  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 > Valeurs d’environnement de paramètre.
  5. Sélectionnez la valeur d’environnement de paramètre que vous souhaitez supprimer.
  6. Dans la barre de commandes, sélectionnez Supprimer > 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 d’application de paramètre lorsque la valeur par défaut de l’environnement du paramètre n’est pas ce que vous souhaitez utiliser pour votre application. Si une valeur d’environnement de paramètre n’existe pas, 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.

Notes

Pour suivre les étapes ci-dessous, vous devez utiliser le nouveau concepteur d’application. Actuellement, le concepteur d’application affiche uniquement les paramètres de plateforme Power Apps. Pour les paramètres non liés à la plate-forme, veuillez utiliser l’explorateur de solutions comme indiqué ci-dessous.

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

  1. Ouvrez l’application pour laquelle vous souhaitez ajouter la valeur de l’application de 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 version est défini sur Généralement disponible. L’onglet À venir affiche tous les paramètres dont le niveau de version est défini sur Aperçu.
  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 pour laquelle vous souhaitez supprimer la valeur de l’application de 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.
  4. Sélectionnez Rétablir la valeur de l’environnement en regard de la valeur de l’application de réglage que vous souhaitez supprimer. Cela ramène la valeur de réglage à la valeur de l’environnement de réglage s’il en existe. Si aucune valeur d’environnement de paramètre n’existe, cela ramène 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 d’une valeur d’application de paramètre à l’aide de l’explorateur de solutions

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation 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é.
  3. Dans la liste des solutions, ouvrez la solution à laquelle vous souhaitez ajouter 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-en. Accédez à 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 d’environnement de paramètre.
  6. Dans la boîte de dialogue Modifier la valeur du paramètre, dans la section Définir les valeurs de l’application, recherchez l’application pour laquelle vous souhaitez ajouter la valeur de l’application de paramètre. Notez qu’à l’aide de l’explorateur de solutions, vous ne pouvez ajouter des valeurs d’application de paramètre que pour les applications qui se trouvent dans la solution actuelle.
  7. Fournissez la valeur et sélectionnez Enregistrer.
  8. Pour que la valeur de l’application de paramètre prenne effet, vous devrez republier l’application à l’aide du concepteur d’application ou de l’explorateur de solutions.

Suppression d’une valeur d’application de paramètre à l’aide de l’explorateur de solutions

  1. Connectez-vous à Power Apps.
  2. Dans le volet de navigation 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é.
  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-en. En savoir plus : 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 d’environnement de paramètre.
  6. Dans la boîte de dialogue Modifier la valeur du paramètre, dans la section Définir les valeurs de l’application, recherchez l’application pour laquelle vous souhaitez supprimer la valeur de l’application de paramètre. Notez qu’à l’aide de l’explorateur de solutions, vous ne pouvez supprimer des valeurs d’application de paramètre que pour les applications qui se trouvent dans la solution actuelle.
  7. Sélectionnez ... en regard de la valeur de l’application de paramètre, puis sélectionnez Réinitialiser dans l’environnement.
  8. Cliquez sur Enregistrer.
  9. Pour que la suppression de la valeur de l’application de paramètre prenne effet, vous devrez republier l’application à l’aide du concepteur d’application ou de l’explorateur de solutions.

Obtenir ou mettre à jour une valeur de paramètre via le code

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

Voir aussi

Pour les développeurs :