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

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

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

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

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

• Доступ к Power Apps
• Добавление подключения
• Создание приложения с помощью шаблона, на основе данных или с нуля

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

1. Добавьте подключение данных и выберите Пользователи 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

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

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

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

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

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

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

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

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

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

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

   Office365Users.DirectReports(InfoAbout.Text)

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

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

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

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

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

2. Выберите Вставить > Вертикальная галерея.

3. Измените макет вертикальной галереи на Заголовок, подзаголовок и текст.

4. Выберите значок стрелки в первой строке галереи и удалите его.

5. Обновите формулу вертикальной галереи следующим образом.

   Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).value
   

   В приведенной выше формуле условие поиска ссылается на текст, введенный в элемент управления Ввод текста (в данном примере TextInput1); и результаты поиска ограничены лучшими 5.

6. Обновите поля вертикальной галереи для отображения DisplayName в названии галереи, JobTitle в подзаголовке и Department в тексте.

   

7. Запустите приложение и введите текст в поле ввода текста. По мере ввода текста результаты меняются в зависимости от изменений входной строки.

   

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

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

MyProfile

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

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

Нет.

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

UserProfile

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

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

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

Управление

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

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

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

DirectReports

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

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

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

SearchUser

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

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

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

См. также

• Сведения о всех доступных подключениях см. здесь.
• Узнайте, как добавлять подключения в приложения.