Modèle d’écran de personnes dans les applications canevas

Article
03/15/2023

Dans une application canevas, ajoutez un écran de personnes qui permet aux utilisateurs de rechercher des personnes au sein de leurs organisations. Les utilisateurs peuvent rechercher, sélectionner et ajouter des personnes à une collection. Vous pouvez modifier les types de données qui apparaissent dans la galerie de résultats de recherche, utiliser vos sélections de personnes pour envoyer un e-mail et effectuer d’autres personnalisations.

Vous pouvez également ajouter d’autres écrans basés sur des modèles qui affichent différentes données de Office 365, tel que e-mail, calendrier d’un utilisateur et disponibilité des individus que les utilisateurs pourraient souhaiter inviter à une réunion.

Cette vue d’ensemble vous apprend :

Comment utiliser l’écran des personnes par défaut.
Comment modifier l’écran.
Comment intégrer l’écran en applications.

Pour une immersion totale dans la fonctionnalité par défaut de cet écran, consultez la référence écran des personnes.

Éléments requis

Bien savoir comment ajouter et configurer des écrans et d’autres commandes lorsque vous créez une application dans Power Apps.

Fonctionnalité par défaut

Pour ajouter un écran des personnes à partir du modèle :

Se connecter à Power Apps, puis créez une application ou ouvrez une application existante dans Power Apps Studio.

Ce sujet montre une application pour téléphone, mais les mêmes concepts s’appliquent à une application pour tablette.
Sur l’onglet Accueil du ruban, sélectionnez Nouvel écran > Personnes.

Par défaut, l’écran ressemble à ceci :
Pour commencer la recherche d’utilisateurs, sélectionnez la zone de saisie de texte en haut et commencez à taper le nom d’un collègue. Les résultats de la recherche apparaissent sous la zone de saisie de texte :
Lorsque vous sélectionnez des personnes dans les résultats de la recherche, ils sont ajoutés à la collection MyPeople. La valeur d’entrée de la barre de recherche est réinitialisée, révélant la collection de personnes que vous avez sélectionnées :

Modifier l’écran

Vous pouvez modifier la fonctionnalité par défaut de cet écran en montrant des données différentes pour les personnes.

Si vous souhaitez modifier davantage l’écran, utilisez la référence écran personnes comme un guide.

Afficher des données différentes pour les personnes

Cet écran utilise l’opération Office365Users.SearchUser pour rechercher des utilisateurs dans votre organisation. Il fournit des champs supplémentaires pour chaque événement au-delà de ce qui apparaît dans le contrôle UserBrowseGallery. L’ajout ou la modification de champs dans la galerie est simple :

Dans le contrôle UserBrowseGallery, sélectionnez un libellé à modifier (ou ajoutez-en un et maintenez-le sélectionné).
Avec sa propriété Text sélectionnée, dans la barre de formule, remplacez le contenu par ThisItem.

IntelliSense affiche une liste des champs que vous pouvez sélectionner.
Sélectionnez le champ que vous souhaitez.

La propriété Text se met à jour sur ThisItem.{FieldSelection}.

Intégrer l’écran dans une application

L’écran de personnes est un puissant ensemble de commandes à part entière, mais il fonctionne généralement mieux dans le cadre d’une application plus grande et plus polyvalente. Vous pouvez intégrer cet écran dans une application plus grande de plusieurs façons, notamment en utilisant votre liste de personnes mise en cache.

Utiliser votre liste de personnes en cache

L’écran des personnes met en cache vos sélections de personnes dans la collection MyPeople. Si votre scénario d’entreprise nécessite une recherche de personne, vous devrez savoir comment utiliser cette collection. Ici, vous allez découvrir comment connecter cet écran à un écran de messagerie rudimentaire et envoyer des e-mails aux utilisateurs dans la collection MyPeople. Vous découvrirez également comment fonctionne l’écran d’e-mail.

Ajoutez la source de données Office 365 Outlook à votre application en sélectionnant l’onglet Afficher, en sélectionnant Sources de données > Ajouter une source de données et en recherchant le connecteur Office 365 Outlook. Vous devrez peut-être sélectionner Nouvelle connexion pour le trouver.
Après avoir inséré l’écran des personnes, insérez un nouvel écran vierge. Dans cet écran, ajoutez une icône de flèche de retour, deux zones de saisie de texte et une icône d’envoi.
Renommez l’écran EmailScreen, l’icône de flèche de retour sur BackIcon, une zone de saisie de texte pour SubjectLine, l’autre à MessageBody et l’icône d’envoi vers SendIcon.
Définissez la propriété OnSelect de BackIcon sur Back().
Définissez la propriété OnSelect de SendIcon sur la formule suivante :
```
Office365.SendEmailV2( 
    Concat( MyPeople, UserPrincipalName & ";" ), 
    SubjectLine.Text, 
    MessageBody.Text 
)
```
Ici, vous utilisez le connecteur Outlook pour envoyer un e-mail. Vous le passez Concat(MyPeople, UserPrincipalName & ";") comme liste de destinataires. Cette formule concatène toutes les adresses e-mail de la collection MyPeople en une seule chaîne avec des points-virgules les séparant. Ce n’est pas différent d’écrire une chaîne d’adresses e-mail séparées par des points-virgules dans la ligne « À » de votre client de messagerie préféré.
- Vous passez SubjectLine.Text comme l’objet du message, et MessageBody.Text comme le corps du message.
Sur l’écran des personnes, dans l’angle supérieur droit, insérez l’icône E-mail. Changez la couleur de l’icône pour celle qui vous convient.
Définissez la propriété OnSelect de SendIcon sur Navigate( EmailScreen, None ).

Vous disposez désormais d’une application à deux écrans dans laquelle vous pouvez sélectionner des utilisateurs, leur composer un e-mail, puis l’envoyer. N’hésitez pas à le tester, mais soyez prudent, car l’application envoie des e-mails à tous ceux que vous ajoutez à la collection MyPeople.

Étapes suivantes

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).

Partager via