Se connecter à la connexion Utilisateurs Office 365 à partir de PowerAppsConnect to Office 365 Users connection from PowerApps

Utilisateurs Office 365

La connexion Utilisateurs Office 365 vous permet d’accéder aux profils utilisateur de votre organisation à l’aide de votre compte Office 365.Office 365 Users lets you access user profiles in your organization using your Office 365 account. Vous pouvez effectuer diverses actions, telles que l’obtention de votre profil, d’un profil utilisateur, du responsable d’un utilisateur ou des collaborateurs directs.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Vous pouvez afficher ces informations dans une étiquette sur votre application.You can display this information in a label on your app. Vous pouvez afficher une seule fonction, plusieurs fonctions ou en combiner plusieurs.You can display one function, multiple functions, or even combine different functions. Par exemple, vous pouvez créer une expression qui combine le nom d’utilisateur et le numéro de téléphone et afficher ces informations dans votre application.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

Cette rubrique vous montre comment ajouter Utilisateurs Office 365 en tant que connexion, ajouter Utilisateurs Office 365 comme source de données à votre application et utiliser les données de table dans un contrôle de galerie.This topic shows you how to add Office 365 Users as a connection, add Office 365 Users as a data source to your app, and use table data in a gallery control.

 

What you need to get started

Ajouter une connexionAdd a connection

  1. Ajoutez une connexion de données et sélectionnez Utilisateurs Office 365 :Add a data connection and select Office 365 Users:

    Se connecter à Office 365

  2. Sélectionnez Se connecter. Si vous êtes invité à vous connecter, entrez votre compte professionnel.Select Connect, and if prompted to sign in, enter your work account.

La connexion Utilisateurs Office 365 a été créée et ajoutée à votre application.The Office 365 Users connection has been created and added to your app. Elle est prête à être utilisée.Now, it's ready to be used.

Utiliser la connexion dans votre applicationUse the connection in your app

Afficher des informations sur l’utilisateur actuelShow information about the current user

  1. Dans le menu Insérer, sélectionnez Label.On the Insert menu, select Label
  2. Dans la barre de fonction, définissez sa propriété Text sur une des formules suivantes :In the function bar, set its Text property to any of the following formulas:

    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    Office365Users.MyProfile().Surname
    Office365Users.MyProfile().TelephoneNumber
    Office365Users.MyProfile().UserPrincipalName
    Office365Users.MyProfile().AccountEnabled

L’étiquette affiche les informations que vous avez entrées sur l’utilisateur actuel.The label shows the information that you entered about the current user.

Afficher des informations sur un autre utilisateurShow information about another user

  1. Dans le menu Insérer, sélectionnez Texte, puis Saisie de texte.On the Insert menu, select Text, and then select Text input. Renommez-le InfoAbout :Rename it InfoAbout:

    Renommer le contrôle

  2. Dans InfoAbout, tapez ou collez l’adresse de messagerie d’un utilisateur de votre organisation.In InfoAbout, type or paste an email address of a user in your organization. Par exemple, tapez votrenom@votresociété.com.For example, type in yourName@yourCompany.com.
  3. Ajoutez une étiquette (menu Insérer) et définissez sa propriété Text sur une des formules suivantes :Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • Pour afficher des informations sur un autre utilisateur :To show information about another user:

      Office365Users.UserProfile(InfoAbout.Text).Department
      Office365Users.UserProfile(InfoAbout.Text).DisplayName
      Office365Users.UserProfile(InfoAbout.Text).GivenName
      Office365Users.UserProfile(InfoAbout.Text).Id
      Office365Users.UserProfile(InfoAbout.Text).JobTitle
      Office365Users.UserProfile(InfoAbout.Text).Mail
      Office365Users.UserProfile(InfoAbout.Text).MailNickname
      Office365Users.UserProfile(InfoAbout.Text).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled

    • Pour afficher des informations sur le responsable d’un autre utilisateur :To show information about another user's manager:

      Office365Users.Manager(InfoAbout.Text).Department
      Office365Users.Manager(InfoAbout.Text).DisplayName
      Office365Users.Manager(InfoAbout.Text).GivenName
      Office365Users.Manager(InfoAbout.Text).Id
      Office365Users.Manager(InfoAbout.Text).JobTitle
      Office365Users.Manager(InfoAbout.Text).Mail
      Office365Users.Manager(InfoAbout.Text).MailNickname
      Office365Users.Manager(InfoAbout.Text).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled

L’étiquette affiche les informations que vous avez entrées sur l’utilisateur spécifié ou le responsable de ce dernier.The label shows the information that you entered about the user you specified or that user's manager.

Remarque : si vous développez une application basée sur une entité dans Common Data Service, vous pouvez spécifier un utilisateur en fonction de l’ID au lieu de l’adresse de messagerie.Note: If you're developing an app based on an entity in the Common Data Service, you can specify a user based on ID instead of email address.

Par exemple, vous pouvez créer une application automatiquement, ajouter un écran qui contient un contrôle Label et définir la propriété Text sur la formule suivante :For example, you can create an app automatically, add a screen that contains a Label control, and set the control's Text property to this formula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayNameOffice365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Si vous créez un contact et que vous le sélectionnez dans l’écran de navigation de l’application, le contrôle Label affiche votre nom d’affichage.If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

Afficher les collaborateurs directs d’un autre utilisateurShow the direct reports of another user

  1. Ajoutez un contrôle Saisie de texte (menu Insérer > Texte) et renommez-le InfoAbout.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. Dans InfoAbout, entrez l’adresse de messagerie d’un utilisateur de votre organisation.In InfoAbout, enter the email address of a user in your organization. Par exemple, entrez nomdevotreresponsable@votresociété.comFor example, enter yourManagersName@yourCompany.com
  3. Ajoutez une galerie avec texte (menu Insérer > Galerie) et définissez sa propriété Items sur la formule suivante :Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    La galerie affiche des informations sur les collaborateurs directs de l’utilisateur que vous avez entré.The gallery shows information about the direct reports of the user you entered.

    Lorsque la galerie est sélectionnée, le volet de droite affiche les options correspondantes.With the gallery selected, the right-hand pane shows options for that gallery.

  4. Dans la deuxième liste, sélectionnez JobTitle.In the second list, select JobTitle. Dans la troisième liste, sélectionnez DisplayName.In the third list, select DisplayName. La galerie est mise à jour pour afficher ces valeurs.The gallery is updated to show these values.


    REMARQUE La première zone est en fait un contrôle d’image.NOTE The first box is actually an image control. Si vous n’avez pas d’image, vous pouvez supprimer le contrôle Image et ajouter à sa place une étiquette.If you don't have an image, you can delete the image control, and add a label in its place. Nous vous recommandons de consulter la page Ajouter et configurer des contrôles.Add and configure controls is a good resource.

Rechercher des utilisateursSearch for users

  1. Ajoutez un contrôle Saisie de texte (menu Insérer > Texte) et renommez-le SearchTerm.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Entrez un nom à rechercher.Enter a name to search. Par exemple, entrez votre prénom.For example, enter your first name.
  2. Ajoutez une galerie avec texte (menu Insérer > Galerie) et définissez sa propriété Items sur la formule suivante :Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.SearchUser({searchTerm: SearchTerm.Text})

    La galerie affiche les utilisateurs dont le nom contient le texte de recherche que vous avez entré.The gallery shows users whose name contains the search text you entered.

    Lorsque la galerie est sélectionnée, le volet de droite affiche les options correspondantes.With the gallery selected, the right-hand pane shows options for that gallery.

  3. Dans la deuxième liste, sélectionnez Mail.In the second list, select Mail. Dans la troisième liste, sélectionnez DisplayName.In the third list, select DisplayName.

    Les deuxième et troisième étiquettes de la galerie sont mises à jour.The second and third labels in the gallery are updated.

Afficher les fonctions disponiblesView the available functions

Cette connexion comprend les fonctions suivantes :This connection includes the following functions:

Nom de la fonctionFunction Name DescriptionDescription
MyProfileMyProfile Extrait le profil de l’utilisateur actuel.Retrieves the profile for the current user
UserProfileUserProfile Extrait le profil d’un utilisateur spécifique.Retrieves a specific user profile
ManagerManager Extrait le profil utilisateur du responsable de l’utilisateur spécifié.Retrieves user profile for the manager of the specified user
DirectReportsDirectReports Renvoie les collaborateurs directs de l’utilisateur spécifié.Returns the direct reports for the specified user
SearchUserSearchUser Extrait les résultats de la recherche de profils utilisateur.Retrieves search results of user profiles

MyProfileMyProfile

Get my profile (Obtenir mon profil) : extrait le profil de l’utilisateur actuel.Get my profile: Retrieves the profile for the current user.

Propriétés d’entréeInput properties

Aucune.None.

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name TypeType DescriptionDescription
ServiceDepartment chaînestring Service dans lequel l’utilisateur travaille.Department of the user.
DisplayNameDisplayName chaînestring Nom d’affichage de l’utilisateur.Display name of user.
GivenNameGivenName chaînestring Nom de l’utilisateur.Given name of user.
IDId chaînestring ID de l’utilisateur.User id
JobTitleJobTitle chaînestring Fonction de l’utilisateur.Job Title of the user.
MessagerieMail chaînestring ID de courrier électronique de l’utilisateur.Email id of user.
MailNicknameMailNickname chaînestring Pseudo de l’utilisateur.Nickname of user.
SurnameSurname chaînestring Prénom de l’utilisateur.Surname of user.
TelephoneNumberTelephoneNumber chaînestring Numéro de téléphone de l’utilisateur.Telephone number of user.
UserPrincipalNameUserPrincipalName chaînestring Nom d’utilisateur principal.User Principal Name.
AccountEnabledAccountEnabled valeur booléenneboolean Indicateur de compte activé.Account enabled flag.

UserProfileUserProfile

Get user profile (Obtenir le profil utilisateur) : extrait le profil d’un utilisateur spécifique.Get user profile: Retrieves a specific user profile.

Propriétés d’entréeInput properties

NomName Type de donnéesData Type ObligatoireRequired DescriptionDescription
IDId chaînestring ouiyes Nom principal de l’utilisateur ou ID de courrier électronique.User principal name or email id

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name TypeType DescriptionDescription
ServiceDepartment chaînestring Service dans lequel l’utilisateur travaille.Department of the user.
DisplayNameDisplayName chaînestring Nom d’affichage de l’utilisateur.Display name of user.
GivenNameGivenName chaînestring Nom de l’utilisateur.Given name of user.
IDId chaînestring ID de l’utilisateur.User id
JobTitleJobTitle chaînestring Fonction de l’utilisateur.Job Title of the user.
MessagerieMail chaînestring ID de courrier électronique de l’utilisateur.Email id of user.
MailNicknameMailNickname chaînestring Pseudo de l’utilisateur.Nickname of user.
SurnameSurname chaînestring Prénom de l’utilisateur.Surname of user.
TelephoneNumberTelephoneNumber chaînestring Numéro de téléphone de l’utilisateur.Telephone number of user.
UserPrincipalNameUserPrincipalName chaînestring Nom d’utilisateur principal.User Principal Name.
AccountEnabledAccountEnabled valeur booléenneboolean Indicateur de compte activé.Account enabled flag.

ManagerManager

Get manager (Obtenir le responsable) : extrait le profil utilisateur du responsable de l’utilisateur spécifié.Get manager: Retrieves user profile for the manager of the specified user

Propriétés d’entréeInput properties

NomName Type de donnéesData Type ObligatoireRequired DescriptionDescription
IDId chaînestring ouiyes Nom principal de l’utilisateur ou ID de courrier électronique.User principal name or email id

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name TypeType DescriptionDescription
ServiceDepartment chaînestring Service dans lequel l’utilisateur travaille.Department of the user.
DisplayNameDisplayName chaînestring Nom d’affichage de l’utilisateur.Display name of user.
GivenNameGivenName chaînestring Nom de l’utilisateur.Given name of user.
IDId chaînestring ID de l’utilisateur.User id
JobTitleJobTitle chaînestring Fonction de l’utilisateur.Job Title of the user.
MessagerieMail chaînestring ID de courrier électronique de l’utilisateur.Email id of user.
MailNicknameMailNickname chaînestring Pseudo de l’utilisateur.Nickname of user.
SurnameSurname chaînestring Prénom de l’utilisateur.Surname of user.
TelephoneNumberTelephoneNumber chaînestring Numéro de téléphone de l’utilisateur.Telephone number of user.
UserPrincipalNameUserPrincipalName chaînestring Nom d’utilisateur principal.User Principal Name.
AccountEnabledAccountEnabled valeur booléenneboolean Indicateur de compte activé.Account enabled flag.

DirectReportsDirectReports

Get direct reports (Obtenir les collaborateurs directs) : extrait les subordonnés directs.Get direct reports: Get direct reports

Propriétés d’entréeInput properties

NomName Type de donnéesData Type ObligatoireRequired DescriptionDescription
IDId chaînestring ouiyes Nom principal de l’utilisateur ou ID de courrier électronique.User principal name or email id

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name TypeType DescriptionDescription
ServiceDepartment chaînestring Service dans lequel l’utilisateur travaille.Department of the user.
DisplayNameDisplayName chaînestring Nom d’affichage de l’utilisateur.Display name of user.
GivenNameGivenName chaînestring Nom de l’utilisateur.Given name of user.
IDId chaînestring ID de l’utilisateur.User id
JobTitleJobTitle chaînestring Fonction de l’utilisateur.Job Title of the user.
MessagerieMail chaînestring ID de courrier électronique de l’utilisateur.Email id of user.
MailNicknameMailNickname chaînestring Pseudo de l’utilisateur.Nickname of user.
SurnameSurname chaînestring Prénom de l’utilisateur.Surname of user.
TelephoneNumberTelephoneNumber chaînestring Numéro de téléphone de l’utilisateur.Telephone number of user.
UserPrincipalNameUserPrincipalName chaînestring Nom d’utilisateur principal.User Principal Name.
AccountEnabledAccountEnabled valeur booléenneboolean Indicateur de compte activé.Account enabled flag.

SearchUserSearchUser

Search for users (Rechercher des utilisateurs) : extrait les résultats de la recherche de profils utilisateur.Search for users: Retrieves search results of user profiles

Propriétés d’entréeInput properties

NomName Type de donnéesData Type ObligatoireRequired DescriptionDescription
searchTermsearchTerm chaînestring nonno Chaîne de recherche.Search string. S’applique à : nom d’affichage, prénom, nom de famille, courrier électronique, pseudo de messagerie et nom d’utilisateur principalApplies to: display name, given name, surname, mail, mail nickname, and user principal name

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name TypeType DescriptionDescription
ServiceDepartment chaînestring Service dans lequel l’utilisateur travaille.Department of the user.
DisplayNameDisplayName chaînestring Nom d’affichage de l’utilisateur.Display name of user.
GivenNameGivenName chaînestring Nom de l’utilisateur.Given name of user.
IDId chaînestring ID de l’utilisateur.User id
JobTitleJobTitle chaînestring Fonction de l’utilisateur.Job Title of the user.
MessagerieMail chaînestring ID de courrier électronique de l’utilisateur.Email id of user.
MailNicknameMailNickname chaînestring Pseudo de l’utilisateur.Nickname of user.
SurnameSurname chaînestring Prénom de l’utilisateur.Surname of user.
TelephoneNumberTelephoneNumber chaînestring Numéro de téléphone de l’utilisateur.Telephone number of user.
UserPrincipalNameUserPrincipalName chaînestring Nom d’utilisateur principal.User Principal Name.
AccountEnabledAccountEnabled valeur booléenneboolean Indicateur de compte activé.Account enabled flag.