Подключение к подключению "Пользователи Office 365" из PowerAppsConnect to Office 365 Users connection from PowerApps

Пользователи Office 365

Подключение "Пользователи Office 365" позволяет получить доступ к профилям пользователей в вашей организации с помощью учетной записи Office 365.Office 365 Users lets you access user profiles in your organization using your Office 365 account. Вы можете выполнять различные действия, например получить свой профиль, профиль пользователя, руководителя или подчиненных пользователя.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Эти сведения можно отобразить в метке приложения.You can display this information in a label on your app. Вы можете отобразить одну или несколько функций либо даже комбинировать различные функции.You can display one function, multiple functions, or even combine different functions. Например, можно создать выражение, которое объединяет поля "Имя пользователя" и "Номер телефона", а затем отобразить эти сведения в приложении.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

В этой статье разъясняется, как добавлять "Пользователи Office 365" в качестве подключения и источника данных в приложение, а также как использовать данные таблицы в элементе управления "Коллекция".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

Добавление подключенияAdd a connection

  1. Добавьте подключение данных и выберите Пользователи Office 365:Add a data connection and select Office 365 Users:

    Подключение к Office 365

  2. Выберите Подключиться и при появлении запроса на вход введите данные своей рабочей учетной записи.Select Connect, and if prompted to sign in, enter your work account.

Подключение "Пользователи Office 365" создано и добавлено в приложение.The Office 365 Users connection has been created and added to your app. Теперь оно готово к использованию.Now, it's ready to be used.

Использование подключения в приложенииUse the connection in your app

Отображение сведений о текущем пользователеShow information about the current user

  1. В меню Вставка выберите пункт Метка.On the Insert menu, select Label
  2. В строке функции задайте для свойства Текст одну из следующих формул: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

В метке отображаются введенные сведения о текущем пользователе.The label shows the information that you entered about the current user.

Отображение сведений о другом пользователеShow information about another user

  1. В меню Вставка выберите Текст, а затем — Ввод текста.On the Insert menu, select Text, and then select Text input. Измените имя поля на InfoAbout:Rename it InfoAbout:

    Переименование элемента управления

  2. В InfoAbout введите или вставьте адрес электронной почты пользователя в организации.In InfoAbout, type or paste an email address of a user in your organization. Например, введите ваше_имя@ваша_компания.com.For example, type in yourName@yourCompany.com.
  3. Добавьте Метка (меню Вставка) и задайте для свойства Text одну из следующих формул:Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • Отображение сведений о другом пользователе: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

    • Отображение сведений о руководителе другого пользователя: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

В метке отображаются введенные сведения об указанном пользователе или его руководителе.The label shows the information that you entered about the user you specified or that user's manager.

Примечание. Если вы разрабатываете в Common Data Service приложение, основанное на сущности, можно указать пользователя на основе идентификатора, а не адреса электронной почты.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.

Например, вы можете автоматически создать приложение, добавить экран, содержащий элемент управления Метка, и задать для свойства Text эту формулу: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

Если создать контакт и выбрать его на экране обзора приложения, в элементе управления Метка появится отображаемое имя.If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

Отображение подчиненных другого пользователяShow the direct reports of another user

  1. Добавьте элемент управления Ввод текста (меню Вставка > Текст) и переименуйте его на InfoAbout.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. В InfoAbout введите адрес электронной почты пользователя в организации.In InfoAbout, enter the email address of a user in your organization. Например, введите имя_вашего_руководителя@ваша_компания.comFor example, enter yourManagersName@yourCompany.com
  3. Добавьте коллекцию С текстом (меню Вставка > Коллекция) и задайте для свойства Items следующую формулу:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    В коллекции отображаются введенные сведения о подчиненных пользователя.The gallery shows information about the direct reports of the user you entered.

    Если выбрать коллекцию, в правой области отобразятся ее параметры.With the gallery selected, the right-hand pane shows options for that gallery.

  4. Во втором списке выберите JobTitle.In the second list, select JobTitle. В третьем списке выберите DisplayName.In the third list, select DisplayName. Коллекция обновляется для отображения этих значений.The gallery is updated to show these values.


    ПРИМЕЧАНИЕ. Первое поле является элементом управления "Изображение".NOTE The first box is actually an image control. Если изображение отсутствует, можно удалить элемент управления "Изображение" и добавить вместо него метку.If you don't have an image, you can delete the image control, and add a label in its place. В статье Add and configure controls (Добавление и настройка элементов управления) представлено много полезных сведений.Add and configure controls is a good resource.

Поиск пользователейSearch for users

  1. Добавьте элемент управления Ввод текста (меню Вставка > Текст) и переименуйте его на SearchTerm.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Введите имя для поиска.Enter a name to search. Например, введите свое имя.For example, enter your first name.
  2. Добавьте коллекцию С текстом (меню Вставка > Коллекция) и задайте для свойства Items следующую формулу:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

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

    В коллекции отобразятся пользователи, имена которых содержат введенный текст для поиска.The gallery shows users whose name contains the search text you entered.

    Если выбрать коллекцию, в правой области отобразятся ее параметры.With the gallery selected, the right-hand pane shows options for that gallery.

  3. Во втором списке выберите Mail.In the second list, select Mail. В третьем списке выберите DisplayName.In the third list, select DisplayName.

    Вторая и третья метки в коллекции будут обновлены.The second and third labels in the gallery are updated.

Просмотр доступных функцийView the available functions

Это подключение включает следующие функции:This connection includes the following functions:

Имя функцииFunction Name ОписаниеDescription
MyProfileMyProfile Извлекает профиль для текущего пользователяRetrieves the profile for the current user
UserProfileUserProfile Извлекает профиль конкретного пользователяRetrieves a specific user profile
ManagerManager Извлекает профиль пользователя для руководителя указанного пользователяRetrieves user profile for the manager of the specified user
DirectReportsDirectReports Возвращает профили подчиненных для указанного пользователяReturns the direct reports for the specified user
SearchUserSearchUser Извлекает результаты поиска профилей пользователейRetrieves search results of user profiles

MyProfileMyProfile

Получение профиля: извлекает профиль для текущего пользователя.Get my profile: Retrieves the profile for the current user.

Входные свойстваInput properties

Нет.None.

Выходные свойстваOutput properties

Имя свойстваProperty Name ТипType ОписаниеDescription
DepartmentDepartment строкаstring Отдел пользователяDepartment of the user.
DisplayNameDisplayName строкаstring Отображаемое имя пользователяDisplay name of user.
GivenNameGivenName строкаstring Заданное имя пользователяGiven name of user.
Id (Идентификатор)Id строкаstring Идентификатор пользователяUser id
JobTitleJobTitle строкаstring Должность пользователяJob Title of the user.
ПочтаMail строкаstring Идентификатор электронной почты пользователяEmail id of user.
MailNicknameMailNickname строкаstring Псевдоним пользователяNickname of user.
SurnameSurname строкаstring Фамилия пользователяSurname of user.
TelephoneNumberTelephoneNumber строкаstring Номер телефона пользователяTelephone number of user.
UserPrincipalNameUserPrincipalName строкаstring Имя участника-пользователяUser Principal Name.
AccountEnabledAccountEnabled логическое значениеboolean Флаг активации учетной записиAccount enabled flag.

UserProfileUserProfile

Получение профиля пользователя: извлекает профиль конкретного пользователя.Get user profile: Retrieves a specific user profile.

Входные свойстваInput properties

ИмяName Тип данныхData Type ТребуетсяRequired ОписаниеDescription
Id (Идентификатор)Id строкаstring даyes Имя участника-пользователя или идентификатор адреса электронной почты пользователяUser principal name or email id

Выходные свойстваOutput properties

Имя свойстваProperty Name ТипType ОписаниеDescription
DepartmentDepartment строкаstring Отдел пользователяDepartment of the user.
DisplayNameDisplayName строкаstring Отображаемое имя пользователяDisplay name of user.
GivenNameGivenName строкаstring Заданное имя пользователяGiven name of user.
Id (Идентификатор)Id строкаstring Идентификатор пользователяUser id
JobTitleJobTitle строкаstring Должность пользователяJob Title of the user.
ПочтаMail строкаstring Идентификатор электронной почты пользователяEmail id of user.
MailNicknameMailNickname строкаstring Псевдоним пользователяNickname of user.
SurnameSurname строкаstring Фамилия пользователяSurname of user.
TelephoneNumberTelephoneNumber строкаstring Номер телефона пользователяTelephone number of user.
UserPrincipalNameUserPrincipalName строкаstring Имя участника-пользователяUser Principal Name.
AccountEnabledAccountEnabled логическое значениеboolean Флаг активации учетной записиAccount enabled flag.

ManagerManager

Получение профиля руководителя: извлекает профиль пользователя для руководителя указанного пользователяGet manager: Retrieves user profile for the manager of the specified user

Входные свойстваInput properties

ИмяName Тип данныхData Type ТребуетсяRequired ОписаниеDescription
Id (Идентификатор)Id строкаstring даyes Имя участника-пользователя или идентификатор адреса электронной почты пользователяUser principal name or email id

Выходные свойстваOutput properties

Имя свойстваProperty Name ТипType ОписаниеDescription
DepartmentDepartment строкаstring Отдел пользователяDepartment of the user.
DisplayNameDisplayName строкаstring Отображаемое имя пользователяDisplay name of user.
GivenNameGivenName строкаstring Заданное имя пользователяGiven name of user.
Id (Идентификатор)Id строкаstring Идентификатор пользователяUser id
JobTitleJobTitle строкаstring Должность пользователяJob Title of the user.
ПочтаMail строкаstring Идентификатор электронной почты пользователяEmail id of user.
MailNicknameMailNickname строкаstring Псевдоним пользователяNickname of user.
SurnameSurname строкаstring Фамилия пользователяSurname of user.
TelephoneNumberTelephoneNumber строкаstring Номер телефона пользователяTelephone number of user.
UserPrincipalNameUserPrincipalName строкаstring Имя участника-пользователяUser Principal Name.
AccountEnabledAccountEnabled логическое значениеboolean Флаг активации учетной записиAccount enabled flag.

DirectReportsDirectReports

Получение профилей подчиненных: получение профилей подчиненныхGet direct reports: Get direct reports

Входные свойстваInput properties

ИмяName Тип данныхData Type ТребуетсяRequired ОписаниеDescription
Id (Идентификатор)Id строкаstring даyes Имя участника-пользователя или идентификатор адреса электронной почты пользователяUser principal name or email id

Выходные свойстваOutput properties

Имя свойстваProperty Name ТипType ОписаниеDescription
DepartmentDepartment строкаstring Отдел пользователяDepartment of the user.
DisplayNameDisplayName строкаstring Отображаемое имя пользователяDisplay name of user.
GivenNameGivenName строкаstring Заданное имя пользователяGiven name of user.
Id (Идентификатор)Id строкаstring Идентификатор пользователяUser id
JobTitleJobTitle строкаstring Должность пользователяJob Title of the user.
ПочтаMail строкаstring Идентификатор электронной почты пользователяEmail id of user.
MailNicknameMailNickname строкаstring Псевдоним пользователяNickname of user.
SurnameSurname строкаstring Фамилия пользователяSurname of user.
TelephoneNumberTelephoneNumber строкаstring Номер телефона пользователяTelephone number of user.
UserPrincipalNameUserPrincipalName строкаstring Имя участника-пользователяUser Principal Name.
AccountEnabledAccountEnabled логическое значениеboolean Флаг активации учетной записиAccount enabled flag.

SearchUserSearchUser

Поиск пользователей: извлекает результаты поиска профилей пользователейSearch for users: Retrieves search results of user profiles

Входные свойстваInput properties

ИмяName Тип данныхData Type ТребуетсяRequired ОписаниеDescription
searchTermsearchTerm строкаstring нетno Строка поиска.Search string. Область применения: отображаемое имя, заданное имя, фамилия, почта, почтовый псевдоним и имя участника-пользователя.Applies to: display name, given name, surname, mail, mail nickname, and user principal name

Выходные свойстваOutput properties

Имя свойстваProperty Name ТипType ОписаниеDescription
DepartmentDepartment строкаstring Отдел пользователяDepartment of the user.
DisplayNameDisplayName строкаstring Отображаемое имя пользователяDisplay name of user.
GivenNameGivenName строкаstring Заданное имя пользователяGiven name of user.
Id (Идентификатор)Id строкаstring Идентификатор пользователяUser id
JobTitleJobTitle строкаstring Должность пользователяJob Title of the user.
ПочтаMail строкаstring Идентификатор электронной почты пользователяEmail id of user.
MailNicknameMailNickname строкаstring Псевдоним пользователяNickname of user.
SurnameSurname строкаstring Фамилия пользователяSurname of user.
TelephoneNumberTelephoneNumber строкаstring Номер телефона пользователяTelephone number of user.
UserPrincipalNameUserPrincipalName строкаstring Имя участника-пользователяUser Principal Name.
AccountEnabledAccountEnabled логическое значениеboolean Флаг активации учетной записиAccount enabled flag.