Anslut till Office 365-användaranslutningen från PowerAppsConnect to Office 365 Users connection from PowerApps

Office 365-användare

Office 365-användare gör att du får åtkomst till användarprofiler i din organisation med hjälp av ditt Office 365-konto.Office 365 Users lets you access user profiles in your organization using your Office 365 account. Du kan utföra olika åtgärder, till exempel få din profil, en användarprofil, en användares chef eller direktrapporter.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Du kan visa den här informationen på en etikett i din app.You can display this information in a label on your app. Du kan visa en enda funktion, flera funktioner och även kombinera olika funktioner.You can display one function, multiple functions, or even combine different functions. Du kan till exempel skapa ett uttryck som kombinerar användarnamn och telefonnummer och sedan visa denna information i din app.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

Det här avsnittet beskriver hur du lägger till Office 365-användare som en anslutning, lägger till Office 365-användare som en datakälla i din app och använder tabelldata i en gallerikontroll.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

Lägg till en anslutningAdd a connection

  1. Lägg till en dataanslutning och välj Office 365-användare:Add a data connection and select Office 365 Users:

    Anslut till Office 365

  2. Välj Anslut och ange ditt arbetskonto om du uppmanas att logga in.Select Connect, and if prompted to sign in, enter your work account.

Office 365-användaranslutningen har skapats och lagts till i din app.The Office 365 Users connection has been created and added to your app. Den är nu redo att användas.Now, it's ready to be used.

Använd anslutningen i din appUse the connection in your app

Visa information om den aktuella användarenShow information about the current user

  1. På menyn Infoga väljer du EtikettOn the Insert menu, select Label
  2. I funktionsfältet anger du dess Text-egenskap till någon av följande formler: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

Etiketten visar den information som du angav om den aktuella användaren.The label shows the information that you entered about the current user.

Visa information om en annan användareShow information about another user

  1. Infoga-menyn väljer du Text och därefter textinmatning.On the Insert menu, select Text, and then select Text input. Byt namn på den till InfoAbout:Rename it InfoAbout:

    Byt namn på kontroll

  2. I InfoAbout skriver eller klistra du in en e-postadress till en användare i din organisation.In InfoAbout, type or paste an email address of a user in your organization. Skriv till exempel dittnamn@dittforetag.com.For example, type in yourName@yourCompany.com.
  3. Lägg till en Etikett (Infoga-menyn) och ange dess Text-egenskap enligt någon av följande formler:Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • För att visa information om en annan användare: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

    • För att visa information om en annan användares chef: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

Etiketten visar den information som du angav om användaren eller om användarens chef.The label shows the information that you entered about the user you specified or that user's manager.

Obs: Om du utvecklar en app som baseras på en entitet i Common Data Service kan du specificera en användare utifrån ID i stället för e-postadress.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.

Du kan till exempel skapa en app automatiskt, lägga till en skärm som innehåller en etikettkontroll och ange kontrollens Text-egenskap enligt den här formeln: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

Om du skapar en kontakt och väljer denna kontakt i appens bläddringsskärm kommer etikettkontrollen att visa ditt visningsnamn.If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

Visa en annan användares direktrapporterShow the direct reports of another user

  1. Lägg till en textinmatningskontroll (Infoga-menyn > Text), och byt namn på den till InfoAbout.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. I InfoAbout anger du e-postadressen till en användare i din organisation.In InfoAbout, enter the email address of a user in your organization. Ange till exempel dinchefsnamn@dittföretag.comFor example, enter yourManagersName@yourCompany.com
  3. Lägg till ett Med text-galleri (Infoga-menyn > Galleri) och ange dess objekt-egenskap enligt följande formel:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    Galleriet visar information om direktrapporterna för användaren som du angav.The gallery shows information about the direct reports of the user you entered.

    När galleriet är markerat visar den högra rutan alternativ för detta galleri.With the gallery selected, the right-hand pane shows options for that gallery.

  4. Välj JobTitle i den andra listan.In the second list, select JobTitle. Välj DisplayName i den tredje listan.In the third list, select DisplayName. Galleriet uppdateras för att visa dessa värden.The gallery is updated to show these values.


    OBS Den första rutan är egentligen en bildkontroll.NOTE The first box is actually an image control. Om du inte har någon bild kan du ta bort bildkontrollen och lägga till en etikett i dess ställe.If you don't have an image, you can delete the image control, and add a label in its place. Lägg till och konfigurera kontroller är en bra resurs.Add and configure controls is a good resource.

Sök efter användareSearch for users

  1. Lägg till en textinmatningskontroll (Infoga-menyn > Text), och byt namn på den till SearchTerm.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Ange ett namn för att söka.Enter a name to search. Ange till exempel ditt förnamn.For example, enter your first name.
  2. Lägg till ett Med text-galleri (Infoga-menyn > Galleri) och ange dess objekt-egenskap enligt följande formel:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

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

    Galleriet visar användare vars namn innehåller den söktext som du angav.The gallery shows users whose name contains the search text you entered.

    När galleriet är markerat visar den högra rutan alternativ för detta galleri.With the gallery selected, the right-hand pane shows options for that gallery.

  3. Välj Mail i den andra listan.In the second list, select Mail. Välj DisplayName i den tredje listan.In the third list, select DisplayName.

    Den andra och tredje etiketten i galleriet uppdateras.The second and third labels in the gallery are updated.

Visa tillgängliga funktionerView the available functions

Den här anslutningen innehåller följande funktioner:This connection includes the following functions:

FunktionsnamnFunction Name BeskrivningDescription
MyProfileMyProfile Hämtar den aktuella användarens profilRetrieves the profile for the current user
UserProfileUserProfile Hämtar en specifik användarprofilRetrieves a specific user profile
ManagerManager Hämtar användarprofilen för den angivna användarens chefRetrieves user profile for the manager of the specified user
DirectReportsDirectReports Returnerar direktrapporterna för den angivna användarenReturns the direct reports for the specified user
SearchUserSearchUser Hämtar sökresultat för användarprofilerRetrieves search results of user profiles

MyProfileMyProfile

Hämta min profil: Hämtar den aktuella användarens profil.Get my profile: Retrieves the profile for the current user.

IndataegenskaperInput properties

Inga.None.

UtdataegenskaperOutput properties

Egenskapens namnProperty Name TypType BeskrivningDescription
AvdelningDepartment strängstring Användarens avdelning.Department of the user.
DisplayNameDisplayName strängstring Användarens visningsnamn.Display name of user.
GivenNameGivenName strängstring Användarens förnamn.Given name of user.
IdId strängstring Användar-idUser id
JobTitleJobTitle strängstring Användarens befattning.Job Title of the user.
PostMail strängstring Användarens e-post-ID.Email id of user.
MailNicknameMailNickname strängstring Användarens smeknamn.Nickname of user.
SurnameSurname strängstring Användarens efternamn.Surname of user.
TelephoneNumberTelephoneNumber strängstring Användarens telefonnummer.Telephone number of user.
UserPrincipalNameUserPrincipalName strängstring Användarens huvudnamn.User Principal Name.
AccountEnabledAccountEnabled boolesktboolean Flagga för kontot aktiverat.Account enabled flag.

UserProfileUserProfile

Hämta användarprofil: Hämtar en specifik användarprofil.Get user profile: Retrieves a specific user profile.

IndataegenskaperInput properties

NamnName DatatypData Type KrävsRequired BeskrivningDescription
IdId strängstring jayes Användarens huvudnamn eller e-post-IDUser principal name or email id

UtdataegenskaperOutput properties

Egenskapens namnProperty Name TypType BeskrivningDescription
AvdelningDepartment strängstring Användarens avdelning.Department of the user.
DisplayNameDisplayName strängstring Användarens visningsnamn.Display name of user.
GivenNameGivenName strängstring Användarens förnamn.Given name of user.
IdId strängstring Användar-idUser id
JobTitleJobTitle strängstring Användarens befattning.Job Title of the user.
PostMail strängstring Användarens e-post-ID.Email id of user.
MailNicknameMailNickname strängstring Användarens smeknamn.Nickname of user.
SurnameSurname strängstring Användarens efternamn.Surname of user.
TelephoneNumberTelephoneNumber strängstring Användarens telefonnummer.Telephone number of user.
UserPrincipalNameUserPrincipalName strängstring Användarens huvudnamn.User Principal Name.
AccountEnabledAccountEnabled boolesktboolean Flagga för kontot aktiverat.Account enabled flag.

ManagerManager

Hämta chef: Hämtar användarprofilen för den angivna användarens chefGet manager: Retrieves user profile for the manager of the specified user

IndataegenskaperInput properties

NamnName DatatypData Type KrävsRequired BeskrivningDescription
IdId strängstring jayes Användarens huvudnamn eller e-post-IDUser principal name or email id

UtdataegenskaperOutput properties

Egenskapens namnProperty Name TypType BeskrivningDescription
AvdelningDepartment strängstring Användarens avdelning.Department of the user.
DisplayNameDisplayName strängstring Användarens visningsnamn.Display name of user.
GivenNameGivenName strängstring Användarens förnamn.Given name of user.
IdId strängstring Användar-idUser id
JobTitleJobTitle strängstring Användarens befattning.Job Title of the user.
PostMail strängstring Användarens e-post-ID.Email id of user.
MailNicknameMailNickname strängstring Användarens smeknamn.Nickname of user.
SurnameSurname strängstring Användarens efternamn.Surname of user.
TelephoneNumberTelephoneNumber strängstring Användarens telefonnummer.Telephone number of user.
UserPrincipalNameUserPrincipalName strängstring Användarens huvudnamn.User Principal Name.
AccountEnabledAccountEnabled boolesktboolean Flagga för kontot aktiverat.Account enabled flag.

DirectReportsDirectReports

Hämta direktrapporter: Hämta direktrapporterGet direct reports: Get direct reports

IndataegenskaperInput properties

NamnName DatatypData Type KrävsRequired BeskrivningDescription
IdId strängstring jayes Användarens huvudnamn eller e-post-IDUser principal name or email id

UtdataegenskaperOutput properties

Egenskapens namnProperty Name TypType BeskrivningDescription
AvdelningDepartment strängstring Användarens avdelning.Department of the user.
DisplayNameDisplayName strängstring Användarens visningsnamn.Display name of user.
GivenNameGivenName strängstring Användarens förnamn.Given name of user.
IdId strängstring Användar-idUser id
JobTitleJobTitle strängstring Användarens befattning.Job Title of the user.
PostMail strängstring Användarens e-post-ID.Email id of user.
MailNicknameMailNickname strängstring Användarens smeknamn.Nickname of user.
SurnameSurname strängstring Användarens efternamn.Surname of user.
TelephoneNumberTelephoneNumber strängstring Användarens telefonnummer.Telephone number of user.
UserPrincipalNameUserPrincipalName strängstring Användarens huvudnamn.User Principal Name.
AccountEnabledAccountEnabled boolesktboolean Flagga för kontot aktiverat.Account enabled flag.

SearchUserSearchUser

Sök användare: Hämtar sökresultat för användarprofilerSearch for users: Retrieves search results of user profiles

IndataegenskaperInput properties

NamnName DatatypData Type KrävsRequired BeskrivningDescription
searchTermsearchTerm strängstring nejno Söksträng.Search string. Gäller för: visningsnamn, förnamn, efternamn, e-post, e-post-smeknamn och användarens huvudnamnApplies to: display name, given name, surname, mail, mail nickname, and user principal name

UtdataegenskaperOutput properties

Egenskapens namnProperty Name TypType BeskrivningDescription
AvdelningDepartment strängstring Användarens avdelning.Department of the user.
DisplayNameDisplayName strängstring Användarens visningsnamn.Display name of user.
GivenNameGivenName strängstring Användarens förnamn.Given name of user.
IdId strängstring Användar-idUser id
JobTitleJobTitle strängstring Användarens befattning.Job Title of the user.
PostMail strängstring Användarens e-post-ID.Email id of user.
MailNicknameMailNickname strängstring Användarens smeknamn.Nickname of user.
SurnameSurname strängstring Användarens efternamn.Surname of user.
TelephoneNumberTelephoneNumber strängstring Användarens telefonnummer.Telephone number of user.
UserPrincipalNameUserPrincipalName strängstring Användarens huvudnamn.User Principal Name.
AccountEnabledAccountEnabled boolesktboolean Flagga för kontot aktiverat.Account enabled flag.