Поделиться через


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

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

Пользователи 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

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

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

  1. В меню "Вставка " выберите "Текст" и выберите ввод текста. Переименуйте его InfoAbout:

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

  2. В InfoAbout введите или вставьте адрес электронной почты пользователя в организации. Например, введите имя yourCompany.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

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

Замечание

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

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

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

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

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

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

  3. Добавьте текстовую коллекцию with (Insert menu >Gallery) и задайте для свойства Items следующую формулу:

    Office365Users.DirectReports(InfoAbout.Text)

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

    В выбранной коллекции в правой области отображаются параметры для этой коллекции.

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

Замечание

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

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

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

  2. Выберите "Вставить>вертикальную коллекцию".

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

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

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

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

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

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

    Выбранные поля коллекции.

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

    Пример поиска.

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

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

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

MyProfile

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

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

Нет.

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

Название свойства Тип Description
Город струна Город пользователя.
Имя Компании струна Компания пользователя.
Страна струна Страна пользователя.
Отдел струна Отдел пользователя.
Отображаемое имя струна Отображаемое имя пользователя.
GivenName струна Заданное имя пользователя.
Идентификатор струна Идентификатор пользователя.
Название должности струна Название задания пользователя.
Mail струна Идентификатор электронной почты пользователя.
MailNickname струна Псевдоним пользователя.
мобильный телефон струна Мобильный телефон пользователя.
OfficeLocation струна Расположение пользователя Office.
Почтовый индекс струна Почтовый индекс пользователя.
Surname струна Фамилия пользователя.
Номер телефона струна Номер телефона пользователя.
ОсновноеИмяПользователя струна Имя участника-пользователя.
AccountEnabled булевый Флаг включенной учетной записи.
BusinessPhones струна Номера телефонов компании пользователя.

Профиль пользователя

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

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

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

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

Название свойства Тип Description
Город струна Город пользователя.
Имя Компании струна Компания пользователя.
Страна струна Страна пользователя.
Отдел струна Отдел пользователя.
Отображаемое имя струна Отображаемое имя пользователя.
GivenName струна Заданное имя пользователя.
Идентификатор струна Идентификатор пользователя.
Название должности струна Название задания пользователя.
Mail струна Идентификатор электронной почты пользователя.
MailNickname струна Псевдоним пользователя.
Surname струна Фамилия пользователя.
Номер телефона струна Номер телефона пользователя.
ОсновноеИмяПользователя струна Имя участника-пользователя.
AccountEnabled булевый Флаг включенной учетной записи.
BusinessPhones струна Номера телефонов компании пользователя.

Менеджер

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

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

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

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

Название свойства Тип Description
Город струна Город пользователя.
Имя Компании струна Компания пользователя.
Страна струна Страна пользователя.
Отдел струна Отдел пользователя.
Отображаемое имя струна Отображаемое имя пользователя.
GivenName струна Заданное имя пользователя.
Идентификатор струна Идентификатор пользователя.
Название должности струна Название задания пользователя.
Mail струна Идентификатор электронной почты пользователя.
MailNickname струна Псевдоним пользователя.
мобильный телефон струна Мобильный телефон пользователя.
OfficeLocation струна Расположение пользователя Office.
Почтовый индекс струна Почтовый индекс пользователя.
Surname струна Фамилия пользователя.
Номер телефона струна Номер телефона пользователя.
ОсновноеИмяПользователя струна Имя участника-пользователя.
AccountEnabled булевый Флаг включенной учетной записи.
BusinessPhones струна Номера телефонов компании пользователя.

DirectReports

Получение прямых отчетов: получение прямых отчетов.

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

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

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

Название свойства Тип Description
Город струна Город пользователя.
Имя Компании струна Компания пользователя.
Страна струна Страна пользователя.
Отдел струна Отдел пользователя.
Отображаемое имя струна Отображаемое имя пользователя.
GivenName струна Заданное имя пользователя.
Идентификатор струна Идентификатор пользователя.
Название должности струна Название задания пользователя.
Mail струна Идентификатор электронной почты пользователя.
MailNickname струна Псевдоним пользователя.
мобильный телефон струна Мобильный телефон пользователя.
OfficeLocation струна Расположение пользователя Office.
Почтовый индекс струна Почтовый индекс пользователя.
Surname струна Фамилия пользователя.
Номер телефона струна Номер телефона пользователя.
ОсновноеИмяПользователя струна Имя участника-пользователя.
AccountEnabled булевый Флаг включенной учетной записи.
BusinessPhones струна Номера телефонов компании пользователя.

SearchUser

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

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

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

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

Название свойства Тип Description
Город струна Город пользователя.
Имя Компании струна Компания пользователя.
Страна струна Страна пользователя.
Отдел струна Отдел пользователя.
Отображаемое имя струна Отображаемое имя пользователя.
GivenName струна Заданное имя пользователя.
Идентификатор струна Идентификатор пользователя.
Название должности струна Название задания пользователя.
Mail струна Идентификатор электронной почты пользователя.
MailNickname струна Псевдоним пользователя.
мобильный телефон струна Мобильный телефон пользователя.
OfficeLocation струна Расположение пользователя Office.
Почтовый индекс струна Почтовый индекс пользователя.
Surname струна Фамилия пользователя.
Номер телефона струна Номер телефона пользователя.
ОсновноеИмяПользователя струна Имя участника-пользователя.
AccountEnabled булевый Флаг включенной учетной записи.
BusinessPhones струна Номера телефонов компании пользователя.

См. также