Подключение к пользователям Office 365 из Power Apps

Office 365 Users

Подключение "Пользователи Office 365" позволяет получить доступ к профилям пользователей в вашей организации с помощью учетной записи Office 365. Вы можете выполнять различные действия, например получить свой профиль, профиль пользователя, руководителя или подчиненных пользователя.

Эти сведения можно отобразить в метке приложения. Вы можете отобразить одну или несколько функций либо даже комбинировать различные функции. Например, можно создать выражение, которое объединяет поля "Имя пользователя" и "Номер телефона", а затем отобразить эти сведения в приложении.

В этой статье описывается, как добавлять пользователей Office 365 в качестве подключения, добавлять пользователей Office 365 в качестве источника данных в приложение, а также как использовать данные таблицы в элементе управления коллекции.

Предварительные условия

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

  1. Добавьте подключение данных и выберите Пользователи Office 365:

    Подключиться к Office 365

  2. Выберите Подключиться и при появлении запроса на вход введите данные своей рабочей учетной записи.

Подключение "Пользователи Office 365" создано и добавлено в приложение. Теперь оно готово к использованию.

Использование подключения в приложении

Отображение сведений о текущем пользователе

  1. В меню Вставка выберите пункт Метка.

  2. В строке функции задайте для свойства Text одну из следующих формул:

    Office365Users.MyProfile().City
    Office365Users.MyProfile().CompanyName
    Office365Users.MyProfile().Country
    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    Office365Users.MyProfile().mobilePhone
    Office365Users.MyProfile().OfficeLocation
    Office365Users.MyProfile().PostalCode
    Office365Users.MyProfile().Surname
    Office365Users.MyProfile().TelephoneNumber
    Office365Users.MyProfile().UserPrincipalName
    Office365Users.MyProfile().AccountEnabled
    Office365Users.MyProfile().BusinessPhones

В метке отображаются введенные сведения о текущем пользователе.

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

  1. В меню Вставка выберите Текст, а затем — Ввод текста. Измените имя поля на InfoAbout:

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

  2. В InfoAbout введите или вставьте адрес электронной почты пользователя в организации. Например, введите ваше_имя@ваша_компания.com.

  3. Добавьте Метка (меню Вставка) и задайте для свойства Text одну из следующих формул:

    • Отображение сведений о другом пользователе:

      Office365Users.UserProfile(InfoAbout.Text).City
      Office365Users.UserProfile(InfoAbout.Text).CompanyName
      Office365Users.UserProfile(InfoAbout.Text).Country
      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).mobilePhone
      Office365Users.UserProfile(InfoAbout.Text).OfficeLocation
      Office365Users.UserProfile(InfoAbout.Text).PostalCode
      Office365Users.UserProfile(InfoAbout.Text).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled
      Office365Users.UserProfile(InfoAbout.Text).BusinessPhones

    • Отображение сведений о руководителе другого пользователя:

      Office365Users.Manager(InfoAbout.Text).City
      Office365Users.Manager(InfoAbout.Text).CompanyName
      Office365Users.Manager(InfoAbout.Text).Country
      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).mobilePhone
      Office365Users.Manager(InfoAbout.Text).OfficeLocation
      Office365Users.Manager(InfoAbout.Text).PostalCode
      Office365Users.Manager(InfoAbout.Text).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled
      Office365Users.Manager(InfoAbout.Text).BusinessPhones

В метке отображаются введенные сведения об указанном пользователе или его руководителе.

Примечание

Если вы разрабатываете в Common Data Service приложение, основанное на сущности, можно указать пользователя на основе идентификатора, а не адреса электронной почты.

Например, вы можете автоматически создать приложение, добавить экран, содержащий элемент управления Метка, и задать для свойства Text эту формулу:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Если создать контакт и выбрать его на экране обзора приложения, в элементе управления Метка появится отображаемое имя.

Отображение подчиненных другого пользователя

  1. Добавьте элемент управления Ввод текста (меню Вставка > Текст) и переименуйте его на InfoAbout.

  2. В InfoAbout введите адрес электронной почты пользователя в организации. Например, введите имя_вашего_руководителя@ваша_компания.com

  3. Добавьте коллекцию С текстом (меню Вставка > Коллекция) и задайте для свойства Items следующую формулу:

    Office365Users.DirectReports(InfoAbout.Text)

    В коллекции отображаются введенные сведения о подчиненных пользователя.

    Если выбрать коллекцию, в правой области отобразятся ее параметры.

  4. Во втором списке выберите JobTitle. В третьем списке выберите DisplayName. Коллекция обновляется для отображения этих значений.

Примечание

Первое поле является элементом управления "Изображение". Если изображение отсутствует, можно удалить элемент управления "Изображение" и добавить вместо него метку. В статье Добавление и настройка элементов управления представлено много полезных сведений.

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

  1. Добавьте элемент управления Ввод текста (меню Вставка > Текст) и переименуйте его на SearchTerm. Введите имя для поиска. Например, введите свое имя.

  2. Добавьте коллекцию С текстом (меню Вставка > Коллекция) и задайте для свойства Items следующую формулу:

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

    В коллекции отобразятся пользователи, имена которых содержат введенный текст для поиска.

    Если выбрать коллекцию, в правой области отобразятся ее параметры.

  3. Во втором списке выберите Почта. В третьем списке выберите DisplayName.

    Вторая и третья метки в коллекции будут обновлены.

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

Это подключение включает следующие функции:

Имя функции Описание
DirectReports Возвращает профили подчиненных для указанного пользователя.
Менеджер Извлекает профиль пользователя для руководителя указанного пользователя.
MyProfile Извлекает профиль для текущего пользователя.
SearchUser Извлекает результаты поиска профилей пользователей.
UserProfile Извлекает профиль конкретного пользователя.

MyProfile

Получение профиля: извлекает профиль для текущего пользователя.

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

Нет.

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

Имя свойства Тип Описание
Город string Город пользователя.
CompanyName string Компания пользователя.
Страна/регион string Страна пользователя.
Отдел string Отдел пользователя.
DisplayName string Отображаемое имя пользователя.
GivenName string Заданное имя пользователя.
Артикул string Идентификатор пользователя.
JobTitle string Должность пользователя.
Почта string Идентификатор электронной почты пользователя.
MailNickname string Псевдоним пользователя.
mobilePhone string Мобильный телефон пользователя.
OfficeLocation string Расположение офиса пользователя.
PostalCode string Почтовый индекс пользователя.
Surname string Фамилия пользователя.
TelephoneNumber string Номер телефона пользователя.
UserPrincipalName string Имя участника-пользователя.
AccountEnabled boolean Флаг активации учетной записи.
BusinessPhones string Номера телефонов компании пользователя.

UserProfile

Получение профиля пользователя: извлекает профиль конкретного пользователя.

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

Имя (название) Тип данных Обязательные Описание
Артикул string да Имя участника-пользователя или идентификатор адреса электронной почты пользователя.

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

Имя свойства Тип Описание
Город string Город пользователя.
CompanyName string Компания пользователя.
Страна/регион string Страна пользователя.
Отдел string Отдел пользователя.
DisplayName string Отображаемое имя пользователя.
GivenName string Заданное имя пользователя.
Артикул string Идентификатор пользователя.
JobTitle string Должность пользователя.
Почта string Идентификатор электронной почты пользователя.
MailNickname string Псевдоним пользователя.
Surname string Фамилия пользователя.
TelephoneNumber string Номер телефона пользователя.
UserPrincipalName string Имя участника-пользователя.
AccountEnabled boolean Флаг активации учетной записи.
BusinessPhones string Номера телефонов компании пользователя.

Управление

Получение профиля руководителя: извлекает профиль пользователя для руководителя указанного пользователя.

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

Имя (название) Тип данных Обязательные Описание
Артикул string да Имя участника-пользователя или идентификатор адреса электронной почты пользователя.

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

Имя свойства Тип Описание
Город string Город пользователя.
CompanyName string Компания пользователя.
Страна/регион string Страна пользователя.
Отдел string Отдел пользователя.
DisplayName string Отображаемое имя пользователя.
GivenName string Заданное имя пользователя.
Артикул string Идентификатор пользователя.
JobTitle string Должность пользователя.
Почта string Идентификатор электронной почты пользователя.
MailNickname string Псевдоним пользователя.
mobilePhone string Мобильный телефон пользователя.
OfficeLocation string Расположение офиса пользователя.
PostalCode string Почтовый индекс пользователя.
Surname string Фамилия пользователя.
TelephoneNumber string Номер телефона пользователя.
UserPrincipalName string Имя участника-пользователя.
AccountEnabled boolean Флаг активации учетной записи.
BusinessPhones string Номера телефонов компании пользователя.

DirectReports

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

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

Имя (название) Тип данных Обязательные Описание
Артикул string да Имя участника-пользователя или идентификатор адреса электронной почты пользователя.

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

Имя свойства Тип Описание
Город string Город пользователя.
CompanyName string Компания пользователя.
Страна/регион string Страна пользователя.
Отдел string Отдел пользователя.
DisplayName string Отображаемое имя пользователя.
GivenName string Заданное имя пользователя.
Артикул string Идентификатор пользователя.
JobTitle string Должность пользователя.
Почта string Идентификатор электронной почты пользователя.
MailNickname string Псевдоним пользователя.
mobilePhone string Мобильный телефон пользователя.
OfficeLocation string Расположение офиса пользователя.
PostalCode string Почтовый индекс пользователя.
Surname string Фамилия пользователя.
TelephoneNumber string Номер телефона пользователя.
UserPrincipalName string Имя участника-пользователя.
AccountEnabled boolean Флаг активации учетной записи.
BusinessPhones string Номера телефонов компании пользователя.

SearchUser

Поиск пользователей: извлекает результаты поиска профилей пользователей.

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

Имя (название) Тип данных Обязательные Описание
searchTerm string нет Строка поиска. Область применения: отображаемое имя, заданное имя, фамилия, почта, почтовый псевдоним и имя участника-пользователя.

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

Имя свойства Тип Описание
Город string Город пользователя.
CompanyName string Компания пользователя.
Страна/регион string Страна пользователя.
Отдел string Отдел пользователя.
DisplayName string Отображаемое имя пользователя.
GivenName string Заданное имя пользователя.
Артикул string Идентификатор пользователя.
JobTitle string Должность пользователя.
Почта string Идентификатор электронной почты пользователя.
MailNickname string Псевдоним пользователя.
mobilePhone string Мобильный телефон пользователя.
OfficeLocation string Расположение офиса пользователя.
PostalCode string Почтовый индекс пользователя.
Surname string Фамилия пользователя.
TelephoneNumber string Номер телефона пользователя.
UserPrincipalName string Имя участника-пользователя.
AccountEnabled boolean Флаг активации учетной записи.
BusinessPhones строка Номера телефонов компании пользователя.

См. также