Exercice : colonnes de choix Dataverse

  • 20 minutes

Dans cet exercice, vous allez aider Contoso à ajouter des colonnes de choix à une table Dataverse existante. Ensuite, vous allez modifier son application Gestion des produits pour utiliser les nouvelles colonnes.

Objectifs

La finalité de cet exercice est que vous découvriez comment :

  • créer des colonnes de choix ;

  • utiliser des données de filtrage dans l’application à l’aide de colonnes de choix ;

  • mettre à jour des valeurs de colonne à l’aide de la fonction Patch().

Condition préalable

Pour réaliser cet exercice, vous avez besoin d’un environnement avec Microsoft Dataverse.

Exercice 1 : Importer une solution

Dans cet exercice, vous allez importer une solution dans votre environnement. Cette solution contient une table Products et une application de gestion des produits.

Tâche 1 : Importer la solution initiale

Dans cette tâche, vous allez importer une solution dans votre environnement.

  1. Vous devez télécharger le fichier zip pour mener cet exercice à bien. Cliquez sur Télécharger une fois le lien ouvert.

  2. Accédez à Power Apps Maker Portal, puis sélectionnez l’environnement que vous souhaitez utiliser pour ce labo.

  3. Cliquez sur Solutions > Importer la solution.

    Capture d’écran du bouton Importer la solution dans Power Apps.

  4. Cliquez sur Parcourir.

  5. Recherchez/Sélectionnez la solution ContosoProductChoiceLab_1_0_0_0.zip, puis cliquez sur Ouvrir.

  6. Cliquez sur Suivant.

  7. Cliquez sur Importer, puis attendez la fin du processus d’importation de la solution.

Tâche 2 : exécuter l’application

Dans cette tâche, vous allez exécuter l’application Contoso Product Manager et ajouter des lignes de produit.

  1. Ouvrez la solution Laboratoire de choix de produits Contoso et sélectionnez l’application Contoso Product Manager. (Ouvrez-la en mode Lecture.)

    Remarque

    Vérifiez les Paramètres de l’application pour vous assurer que le bouton bascule « Désactiver la gestion des erreurs au niveau de la formule » est Désactivé. Sur la page Paramètres, cliquez sur Mises à jour, puis recherchez la fonctionnalité « Désactiver la gestion des erreurs au niveau de la formule » pour la trouver. Cette fonctionnalité se trouve désormais dans la section Retirée.

  2. Depuis BrowseScreen1, cliquez sur le bouton Créer un produit (l’icône plus +).

    Capture d’écran du bouton Créer un produit.

  3. Saisissez Gadget de mesure pour le Nom, puis cliquez sur Enregistrer.

    Capture d’écran du bouton Enregistrer le nouveau produit dans Power Apps.

  4. Ajoutez quelques lignes de produit supplémentaires.

  5. Vous devriez désormais disposer d’au moins trois produits.

    Capture d’écran des lignes de produit dans Power Apps.

  6. Fermez l’onglet ou la fenêtre de navigateur de l’application.

Exercice 2 : Créer des colonnes

Dans cet exercice, vous allez créer deux colonnes de type de données Choix : l’une pour Visibilité produit et l’autre pour Canaux de vente.

Remarque

Prêtez attention à la colonne de type de données Choix unique et à celle de type de données Choix multiple.

Tâche : créer des colonnes de choix

Dans cette tâche, vous allez créer deux colonnes de type de données Choix.

  1. Accédez à Power Apps Maker Portal, puis cliquez sur Solutions.

  2. Sélectionnez la solution Labo de choix Contoso que vous avez importée.

  3. Sélectionnez la table Produit.

  4. Dans le volet Schéma, cliquez sur Colonnes.

    Capture d’écran du tableau de bord de la table Produit avec l’option Colonnes sélectionnée sous Schéma.

  5. Dans la vue Colonnes, cliquez sur + Nouvelle colonne.

    Capture d’écran de la vue Colonnes et du bouton Ajouter une colonne.

  6. Dans le volet Nouvelle colonne à droite de votre écran, saisissez Visibilité produit pour le Nom d’affichage, sélectionnez Choix sous Type de données, puis sélectionnez Choix dans le menu déroulant.

    Capture d’écran du type de données de colonne Choix unique dans Power Apps.

  7. Sous Synchroniser ce choix avec, cliquez sur + Nouveau choix.

  8. Dans le volet Nouveau choix sur le côté droit de votre écran, saisissez chProductVisibility dans le champ Nom d’affichage. L’ajout du préfixe « ch » permet de déterminer bien plus facilement qu’il s’agit d’un groupe de choix.

  9. Saisissez Privé pour le premier élément sous Choix, puis cliquez sur + Nouveau choix.

    Capture d’écran du bouton + Nouveau choix dans le volet Nouveau choix.

  10. Saisissez Invitation pour le second choix, puis cliquez sur + Nouveau choix.

  11. Saisissez Public, puis cliquez sur Enregistrer.

    Capture d’écran des éléments de type de données Choix unique dans Power Apps.

  12. Sous Synchroniser ce choix avec, saisissez chProductVisibility dans le champ de recherche pour trouver/sélectionner le groupe de choix que vous avez créé. chProductVisibility devrait désormais s’afficher dans ce champ.

  13. Cliquez sur Enregistrer et le volet Nouvelle colonne disparaît.

  14. Recliquez sur + Nouvelle colonne.

  15. Saisissez Canaux de vente pour le Nom d’affichage, sélectionnez Choix pour Type de données, puis sélectionnez Choix dans la liste déroulante.

  16. Cochez la case en regard de La sélection de plusieurs choix est autorisée. Ainsi, notre colonne autorise plusieurs choix. (N’oubliez pas cette étape.)

    Capture d’écran du type de données de colonne Choix multiple dans Power Apps.

  17. Sous Synchroniser ce choix avec, cliquez sur + Nouveau choix.

  18. Saisissez chSalesChannels pour le Nom d’affichage et Vente en gros pour le premier élément, puis cliquez sur + Nouveau choix.

  19. Saisissez Vente au détail pour le second élément, puis cliquez sur + Nouveau choix.

  20. Saisissez Vente directe, puis cliquez sur Enregistrer.

    Capture d’écran du bouton Enregistrer dans la nouvelle colonne à choix multiple Canaux de vente.

  21. Sous Synchroniser ce choix avec, saisissez chSalesChannels dans le champ de recherche pour rechercher/sélectionner le groupe de choix que vous avez créé. chSalesChannels devrait désormais s’afficher dans ce champ.

  22. Cliquez sur Enregistrer.

Dans cet exercice, vous allez modifier le formulaire Modifier et la galerie de l’application Contoso Product Manager.

Tâche : Modifier l’application

Dans cette tâche, vous allez modifier l’application Contoso Product Manager.

  1. Si vous avez quitté la solution, recherchez vos solutions et sélectionnez la solution Labo de choix de produits Contoso pour l’ouvrir. Si vous vous trouvez toujours dans la solution, recherchez/sélectionnez Applications dans le volet de navigation Objets.

  2. Sélectionnez l’application Contoso Product Manager pour l’ouvrir.

    Capture d’écran de la section Solutions > Labo de choix de produits Contoso mettant en évidence l’application Contoso Product Manager.

    L’application s’ouvre alors dans le studio d’application.

  3. Dans l’onglet Arborescence, développez EditScreen1, puis sélectionnez EditForm1.

    Capture d’écran du contrôle EditForm1 mis en évidence dans l’onglet Arborescence de Power Apps.

  4. Cliquez sur Modifier les champs.

    Capture d’écran de l’option Modifier les champs dans l’onglet Propriétés du contrôle EditForm1.

  5. Cliquez sur le bouton Plus d’actions représentant des points de suspension (…) de la colonne Date de création, puis sélectionnez Supprimer.

    Capture d’écran de l’option Supprimer sélectionnée dans la liste déroulante de la colonne Date de création.

  6. Cliquez sur + Ajouter un champ.

    Capture d’écran du bouton Ajouter un champ dans le volet Champs de Power Apps.

  7. Sélectionnez les colonnes Visibilité produit et Canaux de vente, puis cliquez sur Ajouter.

    Capture d’écran de la section Choisir un champ, avec les colonnes sélectionnées et le bouton Ajouter.

  8. Fermez le volet Champs.

  9. Développez BrowseScreen1, puis sélectionnez BrowseGallery1.

    Capture d’écran du contrôle BrowseGallery1 mis en évidence dans l’onglet Arborescence.

  10. Cliquez sur l’icône Modifier dans la galerie.

    Capture d’écran de l’icône Modifier dans la galerie.

  11. Définissez la valeur TemplateSize sur 230.

    Capture d’écran de la valeur TemplateSize définie sur 230.

  12. Cliquez sur le libellé Titre dans la galerie, puis déplacez-la vers le haut du modèle.

    Capture d’écran de la position du contrôle du libellé mise en évidence dans Power Apps.

  13. Tout en modifiant la galerie, cliquez sur Insérer et développez Saisie, puis sélectionnez Liste déroulante.

    Capture d’écran de la sélection d’Insérer > Saisie > Liste déroulante dans Power Apps.

  14. Redimensionnez et repositionnez le contrôle Liste déroulante et définissez la propriété Items de la liste déroulante sur la formule suivante :

    Choices(Products.'Product visibility')

    Capture d’écran de la formule de la propriété Items dans Power Apps.

  15. Définissez la propriété Default du contrôle Liste déroulante sur la formule suivante :

    ThisItem.'Product visibility'

  16. Tout en modifiant la galerie, accédez à l’onglet Insérer, puis sélectionnez Libellé de texte.

  17. Redéfinissez le nom du libellé sur Canaux.

  18. Déplacez le libellé Canaux sous le contrôle Liste déroulante, puis redimensionnez-le.

  19. Définissez la valeur Text du libellé Canaux que vous avez ajouté sur la formule suivante. Cette formule entraîne la concaténation des options sélectionnées.

    Concat(ThisItem.'Sales channels',Text(Value),",")

  20. Veillez à toujours être en train de modifier la galerie. Cliquez sur + Insérer > Rectangle.

    Capture d’écran du bouton Insérer cliqué et de l’option Rectangle mise en évidence.

  21. Définissez les valeurs X et Y du rectangle sur 0.

  22. Définissez la Largeur du rectangle sur 6.

  23. Définissez la Hauteur du rectangle sur 220.

  24. Définissez la valeur Fill du rectangle sur la formule suivante. Cette formule entraîne l’attribution d’une couleur de remplissage différente pour chaque choix de la valeur de la colonne Visibilité produit.

    Switch(ThisItem.'Product visibility', chProductVisibility.Private, Color.Red, chProductVisibility.Public, Color.Green, chProductVisibility.Invite, Color.Blue, Color.Black)

  25. Sélectionnez la galerie, puis supprimez la valeur OnSelect, de sorte que le champ de formule fx soit vide.

    Capture d’écran de la valeur OnSelect affichée comme vide.

  26. Sélectionnez NextArrow1 dans la galerie.

    Capture d’écran du contrôle NextArrow2 dans la galerie.

  27. Définissez la valeur OnSelect de NextArrow1 sur la formule suivante.

    Navigate(DetailScreen1, ScreenTransition.None)

  28. Dans le coin supérieur droit de l’écran, cliquez sur Enregistrer.

    Capture d’écran du bouton Enregistrer dans l’application Contoso Product Manager.

  29. Cliquez sur Prévisualiser l’application (ou appuyez sur F5).

    Capture d’écran du bouton Prévisualiser l’application dans Power Apps.

    L’application devrait se charger.

  30. Cliquez sur la flèche Suivant pour l’un des produits.

  31. Cliquez sur le bouton Modifier.

  32. Pour Canaux de vente, sélectionnez Vente au détail et Vente directe. Ensuite, pour Visibilité produit, sélectionnez Privé, puis cliquez sur Enregistrer.

    Capture d’écran du bouton Enregistrer cliqué dans le volet Produits pour enregistrer les informations saisies.

  33. Cliquez sur le bouton Précédent.

  34. Cliquez sur un autre produit pour l’ouvrir.

  35. Cliquez sur Modifier.

  36. Sélectionnez Vente au détail pour Canaux de vente et Public pour Visibilité produit, puis cliquez sur Enregistrer.

  37. Cliquez sur le bouton Précédent.

  38. Cliquez sur un autre produit pour l’ouvrir.

  39. Cliquez sur Modifier.

  40. Sélectionnez Vente directe pour Canaux de vente et Invitation pour Visibilité produit, puis cliquez sur Enregistrer.

  41. Cliquez sur le bouton Précédent.

  42. La galerie devrait ressembler à l’image suivante. Après avoir terminé d’afficher les résultats, fermez l’aperçu.

    Capture d’écran de la galerie modifiée, avec le bouton Fermer l’aperçu de l’application mis en évidence.

  43. Ne quittez pas cette page.

Exercice 4 : Utiliser des filtres

Dans cet exercice, vous allez filtrer les lignes de la galerie par visibilité produit.

Tâche : Utiliser un filtre

Dans cette tâche, vous allez filtrer les lignes de la galerie par visibilité produit.

  1. Sous BrowseScreen1, sélectionnez TextSearchBox1.

    Capture d’écran du contrôle TextSearchBox1 dans l’onglet Arborescence de Power Apps.

  2. Définissez la propriété Width de la zone de recherche sur la formule suivante :

    Parent.Width/2

  3. Dans le ruban, cliquez sur Insérer et développez Saisie, puis sélectionnez Liste déroulante.

    Capture d’écran de l’onglet Insérer illustrant le menu Saisie développé avec l’option Liste déroulante mise en évidence.

  4. Redéfinissez le nom du contrôle Liste déroulante sur Filtre de visibilité.

    Capture d’écran de la redéfinition du nom du contrôle Liste déroulante sur Filtre de visibilité dans Power Apps.

  5. Redimensionnez et repositionnez le Filtre de visibilité, puis placez-le à droite de la zone de recherche.

    Capture d’écran de la position du contrôle en regard de la zone de recherche dans Power Apps.

  6. Définissez la valeur Items du Filtre de visibilité sur la formule suivante :

    Choices(Products.'Product visibility')

  7. Définissez la valeur AllowEmptySelection du Filtre de visibilité sur true.

  8. Définissez la valeur Default du Filtre de visibilité sur la formule suivante :

    Blank()

  9. Dans le ruban, cliquez sur Insérer et développez Icônes, puis sélectionnez Annuler.

  10. Redimensionnez et repositionnez l’icône, puis placez-la à droite de la flèche déroulante.

    Capture d’écran de la position du contrôle de l’icône dans Power Apps.

  11. Définissez la valeur OnSelect de l’icône sur la formule suivante :

    Reset('Visibility filter')

  12. Définissez la valeur Visible de l’icône sur la formule suivante :

    If(IsBlank('Visibility filter'),false,true)

  13. Sélectionnez BrowseGallery1, puis définissez la valeur Items sur la formule suivante. Cette formule entraîne la modification de la formule existante pour inclure une fonction Filter() utilisant les valeurs sélectionnées par l’utilisateur.

    SortByColumns(
    Search(
        Filter([@Products],IsBlank('Visibility filter'.Selected) || 'Product visibility' = 'Visibility filter'.Selected.Value),
        TextSearchBox1.Text,
        "contoso_name"
    ),
    "contoso_name",
    If(
        SortDescending1,
        SortOrder.Descending,
        SortOrder.Ascending
    )
)

    Capture d’écran de la formule OnSelect de la galerie dans le champ Items.

  14. Cliquez sur Prévisualiser l’application (ou appuyez sur F5).

  15. Définissez le Filtre de visibilité sur Privé. La galerie devrait afficher uniquement les produits privés.

    Capture d’écran des produits filtrés sur Privé dans Power Apps.

  16. Cliquez sur l’icône X. La galerie devrait afficher tous les produits.

    Capture d’écran de la galerie affichant tous les produits.

  17. Fermez l’aperçu.

  18. Ne quittez pas cette page.

Exercice 5 : utiliser la formule Patch

Dans cet exercice, vous allez mettre à jour des lignes de la table Produit à l’aide de la formule Patch.

Tâche : utiliser la formule Patch

  1. Développez BrowseGallery1, puis sélectionnez le contrôle Dropdown1.

    Capture d’écran du contrôle Dropdown1 dans le menu BrowseGallery1.

  2. Définissez la valeur OnChange du contrôle Liste déroulante sur la formule suivante. Cette formule entraîne la mise à jour de la ligne en cas de modification de la valeur du contrôle Liste déroulante.

    Patch(Products,ThisItem,{'Product visibility':Self.Selected.Value})

  3. Cliquez sur la galerie, puis sur l’icône Modifier.

    Capture d’écran de l’icône Modifier dans la galerie Power Apps.

  4. Dans le ruban, cliquez sur Insérer et développez Icônes, puis sélectionnez Annuler.

  5. Placez l’icône en bas à droite.

    Capture d’écran du placement de l’icône en bas à droite.

  6. Définissez la valeur Visible de l’icône sur la formule suivante :

    If(IsBlank(Channels.Text),false,true)

  7. Définissez la valeur OnSelect de l’icône sur la formule suivante : Cette formule entraîne la suppression de tous les canaux de vente sélectionnés en cas de clic sur l’icône.

    Patch(Products,ThisItem,{'Sales channels':Blank()})

  8. Cliquez sur Prévisualiser l’application.

  9. Modifiez la visibilité produit de l’un des produits. Le produit devrait se mettre à jour.

    Capture d’écran de la ligne mise à jour dans Power Apps.

  10. Cliquez sur l’icône X du premier produit. Les canaux de vente du produit devraient être effacés et le bouton X devrait devenir masqué.

    Capture d’écran de la ligne mise à jour dans Power Apps illustrant un espace vide.

  11. Fermez l’aperçu.

  12. Cliquez sur Enregistrer.