Łączenie się z połączeniem Użytkownicy usługi Office 365 z usługi PowerAppsConnect to Office 365 Users connection from PowerApps

Użytkownicy usługi Office 365

Połączenie Użytkownicy usługi Office 365 pozwala uzyskiwać dostęp do profilów użytkowników w Twojej organizacji za pomocą Twojego konta usługi Office 365.Office 365 Users lets you access user profiles in your organization using your Office 365 account. Możesz wykonywać różne akcje, takie jak pobieranie własnego profilu, profilu użytkownika, informacji o menedżerze użytkownika lub raportów bezpośrednich.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Te informacje możesz wyświetlać w etykiecie w aplikacji.You can display this information in a label on your app. Wyświetlać można jedną funkcję, kilka funkcji, a nawet ich kombinację.You can display one function, multiple functions, or even combine different functions. Można na przykład utworzyć wyrażenie łączące nazwę użytkownika i numer telefonu, a następnie wyświetlić te informacje w aplikacji.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

W tym temacie pokazano, jak dodać element Użytkownicy usługi Office 365 jako połączenie, jak dodać element Użytkownicy usługi Office 365 jako źródło danych do aplikacji i użyć danych tabeli w kontrolce galerii.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

Dodawanie połączeniaAdd a connection

  1. Dodaj połączenie danych i wybierz pozycję Użytkownicy usługi Office 365:Add a data connection and select Office 365 Users:

    Łączenie z usługą Office 365

  2. Wybierz pozycję Połącz. Jeśli zobaczysz monit o zalogowanie się, wprowadź dane konta służbowego.Select Connect, and if prompted to sign in, enter your work account.

Połączenie Użytkownicy usługi Office 365 zostało utworzone i dodane do Twojej aplikacji.The Office 365 Users connection has been created and added to your app. Jest teraz gotowe do użycia.Now, it's ready to be used.

Używanie połączenia w aplikacjiUse the connection in your app

Pokazywanie informacji o bieżącym użytkownikuShow information about the current user

  1. Z menu Wstaw wybierz pozycję EtykietaOn the Insert menu, select Label
  2. Na pasku funkcji ustaw jego właściwość Text na dowolną z poniższych formuł: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

Etykieta pokazuje wprowadzone informacje o bieżącym użytkowniku.The label shows the information that you entered about the current user.

Pokazywanie informacji o innym użytkownikuShow information about another user

  1. Z menu Wstaw wybierz pozycję Tekst, a następnie wybierz pozycję Wprowadzanie tekstu.On the Insert menu, select Text, and then select Text input. Zmień nazwę tej kontrolki na InfoAbout:Rename it InfoAbout:

    Zmiana nazwy kontrolki

  2. W kontrolce InfoAbout wpisz lub wklej adres e-mail użytkownika w Twojej organizacji.In InfoAbout, type or paste an email address of a user in your organization. Na przykład wpisz Twoja_nazwa@Twoja_firma.com.For example, type in yourName@yourCompany.com.
  3. Dodaj kontrolkę Etykieta (menu Wstaw) i ustaw jej właściwość Text na jedną z następujących formuł:Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • Aby pokazać informacje o innym użytkowniku: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

    • Aby pokazać informacje o menedżerze innego użytkownika: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

Etykieta pokazuje wprowadzone informacje na temat określonego użytkownika lub jego menedżera.The label shows the information that you entered about the user you specified or that user's manager.

Uwaga: jeśli programujesz aplikację na podstawie jednostki w usłudze Common Data Service, możesz określić użytkownika, posługując się jego identyfikatorem zamiast adresem e-mail.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.

Na przykład możesz automatycznie utworzyć aplikację, dodać ekran zawierający kontrolkę Etykieta i ustawić właściwość Text tej kontrolki na następującą formułę: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

Jeśli utworzysz kontakt i wybierzesz ten kontakt na ekranie przeglądania aplikacji, kontrolka Etykieta będzie pokazywać Twoją nazwę wyświetlaną.If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

Pokazywanie raportów bezpośrednich innego użytkownikaShow the direct reports of another user

  1. Dodaj kontrolkę Wprowadzanie tekstu (menu Wstaw > Tekst) i zmień jej nazwę na InfoAbout.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. W kontrolce InfoAbout wprowadź adres e-mail użytkownika w Twojej organizacji.In InfoAbout, enter the email address of a user in your organization. Na przykład wprowadź nazwa_Twojego_menedżera@Twoja_firma.comFor example, enter yourManagersName@yourCompany.com
  3. Dodaj z galerii element Z tekstem (menu Wstaw > Galeria) i ustaw jego właściwość Items na następującą formułę:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    Galeria pokazuje informacje o raportach bezpośrednich wprowadzonego użytkownika.The gallery shows information about the direct reports of the user you entered.

    Przy wybranej galerii w okienku z prawej strony wyświetlane są opcje dla tej galerii.With the gallery selected, the right-hand pane shows options for that gallery.

  4. Z drugiej listy wybierz pozycję JobTitle.In the second list, select JobTitle. Z trzeciej listy wybierz pozycję DisplayName.In the third list, select DisplayName. Galeria zostanie zaktualizowana w celu pokazania tych wartości.The gallery is updated to show these values.


    UWAGA Pierwsze pole to w rzeczywistości kontrolka obrazu.NOTE The first box is actually an image control. Jeśli nie masz obrazu, możesz usunąć kontrolkę obrazu i dodać w jej miejscu etykietę.If you don't have an image, you can delete the image control, and add a label in its place. Więcej informacji można znaleźć w opisie dodawania i konfigurowania kontrolek.Add and configure controls is a good resource.

Wyszukiwanie użytkownikówSearch for users

  1. Dodaj kontrolkę Wprowadzanie tekstu (menu Wstaw > Tekst) i zmień jej nazwę na SearchTerm.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Wprowadź nazwę do wyszukania.Enter a name to search. Na przykład wprowadź swoje imię.For example, enter your first name.
  2. Dodaj z galerii element Z tekstem (menu Wstaw > Galeria) i ustaw jego właściwość Items na następującą formułę:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

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

    Galeria pokaże użytkowników, których nazwy zawierają wprowadzony tekst wyszukiwania.The gallery shows users whose name contains the search text you entered.

    Przy wybranej galerii w okienku z prawej strony wyświetlane są opcje dla tej galerii.With the gallery selected, the right-hand pane shows options for that gallery.

  3. Z drugiej listy wybierz pozycję Mail.In the second list, select Mail. Z trzeciej listy wybierz pozycję DisplayName.In the third list, select DisplayName.

    Druga i trzecia etykieta w galerii zostaną zaktualizowane.The second and third labels in the gallery are updated.

Wyświetlanie dostępnych funkcjiView the available functions

To połączenie obejmuje następujące funkcje:This connection includes the following functions:

Nazwa funkcjiFunction Name OpisDescription
MyProfileMyProfile Pobiera profil bieżącego użytkownikaRetrieves the profile for the current user
UserProfileUserProfile Pobiera profil konkretnego użytkownikaRetrieves a specific user profile
ManagerManager Pobiera profil użytkownika dla menedżera określonego użytkownikaRetrieves user profile for the manager of the specified user
DirectReportsDirectReports Zwraca raporty bezpośrednie dla określonego użytkownikaReturns the direct reports for the specified user
SearchUserSearchUser Pobiera wyniki wyszukiwania profilów użytkownikówRetrieves search results of user profiles

MyProfileMyProfile

Pobieranie własnego profilu: pobiera profil bieżącego użytkownika.Get my profile: Retrieves the profile for the current user.

Właściwości wejścioweInput properties

Brak.None.

Właściwości wyjścioweOutput properties

Nazwa właściwościProperty Name TypType OpisDescription
DepartmentDepartment ciągstring Dział użytkownika.Department of the user.
DisplayNameDisplayName ciągstring Nazwa wyświetlana użytkownika.Display name of user.
GivenNameGivenName ciągstring Imię użytkownika.Given name of user.
IdId ciągstring Identyfikator użytkownikaUser id
JobTitleJobTitle ciągstring Stanowisko użytkownika.Job Title of the user.
PocztaMail ciągstring Identyfikator e-mail użytkownika.Email id of user.
MailNicknameMailNickname ciągstring Nick użytkownika.Nickname of user.
SurnameSurname ciągstring Nazwisko użytkownika.Surname of user.
TelephoneNumberTelephoneNumber ciągstring Numer telefonu użytkownika.Telephone number of user.
UserPrincipalNameUserPrincipalName ciągstring Główna nazwa użytkownika.User Principal Name.
AccountEnabledAccountEnabled wartość logicznaboolean Flaga włączenia konta.Account enabled flag.

UserProfileUserProfile

Pobieranie profilu użytkownika: pobiera profil konkretnego użytkownika.Get user profile: Retrieves a specific user profile.

Właściwości wejścioweInput properties

NazwaName Typ danychData Type WymaganeRequired OpisDescription
IdId ciągstring takyes Główna nazwa lub identyfikator e-mail użytkownikaUser principal name or email id

Właściwości wyjścioweOutput properties

Nazwa właściwościProperty Name TypType OpisDescription
DepartmentDepartment ciągstring Dział użytkownika.Department of the user.
DisplayNameDisplayName ciągstring Nazwa wyświetlana użytkownika.Display name of user.
GivenNameGivenName ciągstring Imię użytkownika.Given name of user.
IdId ciągstring Identyfikator użytkownikaUser id
JobTitleJobTitle ciągstring Stanowisko użytkownika.Job Title of the user.
PocztaMail ciągstring Identyfikator e-mail użytkownika.Email id of user.
MailNicknameMailNickname ciągstring Nick użytkownika.Nickname of user.
SurnameSurname ciągstring Nazwisko użytkownika.Surname of user.
TelephoneNumberTelephoneNumber ciągstring Numer telefonu użytkownika.Telephone number of user.
UserPrincipalNameUserPrincipalName ciągstring Główna nazwa użytkownika.User Principal Name.
AccountEnabledAccountEnabled wartość logicznaboolean Flaga włączenia konta.Account enabled flag.

ManagerManager

Pobieranie menedżera: pobiera profil użytkownika dla menedżera określonego użytkownikaGet manager: Retrieves user profile for the manager of the specified user

Właściwości wejścioweInput properties

NazwaName Typ danychData Type WymaganeRequired OpisDescription
IdId ciągstring takyes Główna nazwa lub identyfikator e-mail użytkownikaUser principal name or email id

Właściwości wyjścioweOutput properties

Nazwa właściwościProperty Name TypType OpisDescription
DepartmentDepartment ciągstring Dział użytkownika.Department of the user.
DisplayNameDisplayName ciągstring Nazwa wyświetlana użytkownika.Display name of user.
GivenNameGivenName ciągstring Imię użytkownika.Given name of user.
IdId ciągstring Identyfikator użytkownikaUser id
JobTitleJobTitle ciągstring Stanowisko użytkownika.Job Title of the user.
PocztaMail ciągstring Identyfikator e-mail użytkownika.Email id of user.
MailNicknameMailNickname ciągstring Nick użytkownika.Nickname of user.
SurnameSurname ciągstring Nazwisko użytkownika.Surname of user.
TelephoneNumberTelephoneNumber ciągstring Numer telefonu użytkownika.Telephone number of user.
UserPrincipalNameUserPrincipalName ciągstring Główna nazwa użytkownika.User Principal Name.
AccountEnabledAccountEnabled wartość logicznaboolean Flaga włączenia konta.Account enabled flag.

DirectReportsDirectReports

Pobieranie raportów bezpośrednich: pobiera raporty bezpośrednieGet direct reports: Get direct reports

Właściwości wejścioweInput properties

NazwaName Typ danychData Type WymaganeRequired OpisDescription
IdId ciągstring takyes Główna nazwa lub identyfikator e-mail użytkownikaUser principal name or email id

Właściwości wyjścioweOutput properties

Nazwa właściwościProperty Name TypType OpisDescription
DepartmentDepartment ciągstring Dział użytkownika.Department of the user.
DisplayNameDisplayName ciągstring Nazwa wyświetlana użytkownika.Display name of user.
GivenNameGivenName ciągstring Imię użytkownika.Given name of user.
IdId ciągstring Identyfikator użytkownikaUser id
JobTitleJobTitle ciągstring Stanowisko użytkownika.Job Title of the user.
PocztaMail ciągstring Identyfikator e-mail użytkownika.Email id of user.
MailNicknameMailNickname ciągstring Nick użytkownika.Nickname of user.
SurnameSurname ciągstring Nazwisko użytkownika.Surname of user.
TelephoneNumberTelephoneNumber ciągstring Numer telefonu użytkownika.Telephone number of user.
UserPrincipalNameUserPrincipalName ciągstring Główna nazwa użytkownika.User Principal Name.
AccountEnabledAccountEnabled wartość logicznaboolean Flaga włączenia konta.Account enabled flag.

SearchUserSearchUser

Wyszukiwanie użytkowników: pobiera wyniki wyszukiwania profilów użytkownikówSearch for users: Retrieves search results of user profiles

Właściwości wejścioweInput properties

NazwaName Typ danychData Type WymaganeRequired OpisDescription
searchTermsearchTerm ciągstring nieno Ciąg wyszukiwania.Search string. Dotyczy: nazwy wyświetlanej, imienia, nazwiska, adresu e-mail, nicku poczty e-mail i głównej nazwy użytkownikaApplies to: display name, given name, surname, mail, mail nickname, and user principal name

Właściwości wyjścioweOutput properties

Nazwa właściwościProperty Name TypType OpisDescription
DepartmentDepartment ciągstring Dział użytkownika.Department of the user.
DisplayNameDisplayName ciągstring Nazwa wyświetlana użytkownika.Display name of user.
GivenNameGivenName ciągstring Imię użytkownika.Given name of user.
IdId ciągstring Identyfikator użytkownikaUser id
JobTitleJobTitle ciągstring Stanowisko użytkownika.Job Title of the user.
PocztaMail ciągstring Identyfikator e-mail użytkownika.Email id of user.
MailNicknameMailNickname ciągstring Nick użytkownika.Nickname of user.
SurnameSurname ciągstring Nazwisko użytkownika.Surname of user.
TelephoneNumberTelephoneNumber ciągstring Numer telefonu użytkownika.Telephone number of user.
UserPrincipalNameUserPrincipalName ciągstring Główna nazwa użytkownika.User Principal Name.
AccountEnabledAccountEnabled wartość logicznaboolean Flaga włączenia konta.Account enabled flag.