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

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

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

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

 

Что нужно для начала работы

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

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

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

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

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

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

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

  1. В меню Вставка выберите пункт Метка.
  2. В строке функции задайте для свойства Текст одну из следующих формул:

    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

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

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

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

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

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

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

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

      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

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

      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

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

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

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

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

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

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

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

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

    Office365Users.DirectReports(InfoAbout.Text)

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

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

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


    ПРИМЕЧАНИЕ. Первое поле является элементом управления "Изображение". Если изображение отсутствует, можно удалить элемент управления "Изображение" и добавить вместо него метку. В статье Add and configure controls (Добавление и настройка элементов управления) представлено много полезных сведений.

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

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

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

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

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

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

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

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

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

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

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

MyProfile

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

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

Нет.

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

Имя свойства Тип Описание
Department строка Отдел пользователя
DisplayName строка Отображаемое имя пользователя
GivenName строка Заданное имя пользователя
Id (Идентификатор) строка Идентификатор пользователя
JobTitle строка Должность пользователя
Почта строка Идентификатор электронной почты пользователя
MailNickname строка Псевдоним пользователя
Surname строка Фамилия пользователя
TelephoneNumber строка Номер телефона пользователя
UserPrincipalName строка Имя участника-пользователя
AccountEnabled логическое значение Флаг активации учетной записи

UserProfile

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

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

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

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

Имя свойства Тип Описание
Department строка Отдел пользователя
DisplayName строка Отображаемое имя пользователя
GivenName строка Заданное имя пользователя
Id (Идентификатор) строка Идентификатор пользователя
JobTitle строка Должность пользователя
Почта строка Идентификатор электронной почты пользователя
MailNickname строка Псевдоним пользователя
Surname строка Фамилия пользователя
TelephoneNumber строка Номер телефона пользователя
UserPrincipalName строка Имя участника-пользователя
AccountEnabled логическое значение Флаг активации учетной записи

Manager

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

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

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

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

Имя свойства Тип Описание
Department строка Отдел пользователя
DisplayName строка Отображаемое имя пользователя
GivenName строка Заданное имя пользователя
Id (Идентификатор) строка Идентификатор пользователя
JobTitle строка Должность пользователя
Почта строка Идентификатор электронной почты пользователя
MailNickname строка Псевдоним пользователя
Surname строка Фамилия пользователя
TelephoneNumber строка Номер телефона пользователя
UserPrincipalName строка Имя участника-пользователя
AccountEnabled логическое значение Флаг активации учетной записи

DirectReports

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

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

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

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

Имя свойства Тип Описание
Department строка Отдел пользователя
DisplayName строка Отображаемое имя пользователя
GivenName строка Заданное имя пользователя
Id (Идентификатор) строка Идентификатор пользователя
JobTitle строка Должность пользователя
Почта строка Идентификатор электронной почты пользователя
MailNickname строка Псевдоним пользователя
Surname строка Фамилия пользователя
TelephoneNumber строка Номер телефона пользователя
UserPrincipalName строка Имя участника-пользователя
AccountEnabled логическое значение Флаг активации учетной записи

SearchUser

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

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

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

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

Имя свойства Тип Описание
Department строка Отдел пользователя
DisplayName строка Отображаемое имя пользователя
GivenName строка Заданное имя пользователя
Id (Идентификатор) строка Идентификатор пользователя
JobTitle строка Должность пользователя
Почта строка Идентификатор электронной почты пользователя
MailNickname строка Псевдоним пользователя
Surname строка Фамилия пользователя
TelephoneNumber строка Номер телефона пользователя
UserPrincipalName строка Имя участника-пользователя
AccountEnabled логическое значение Флаг активации учетной записи

Полезные ссылки