Как добавить пользовательские атрибуты профилей пользователей в веб-часть Employee Directory

В этой статье описано, как отображать пользовательские свойства профилей пользователей SharePoint в веб-части Vitextra Employee Directory, когда она использует источник данных Профили пользователей: как подготовить свойство в SharePoint, как сделать его доступным через поиск и как добавить его в веб-часть в виде настраиваемого столбца.

Введение

Помимо встроенных полей (имя, должность, отдел, телефоны и т. д.), веб-часть Employee Directory может показывать любые нужные вам дополнительные атрибуты - центр затрат, табельный номер, здание, увлечения. Такие дополнительные атрибуты называются настраиваемыми столбцами и задаются в редакторе Настраиваемые столбцы (Custom Columns) веб-части.

С источником данных Профили пользователей веб-часть получает данные о сотрудниках через поиск SharePoint. Поэтому пользовательское свойство профиля становится доступным веб-части только после того, как оно проиндексировано поиском и сопоставлено с управляемым свойством. Весь процесс состоит из трёх шагов:

1. Создайте (или используйте существующее) свойство профиля пользователя и сделайте его индексируемым.
2. Сопоставьте его обходимое свойство с извлекаемым управляемым свойством в схеме поиска.
3. Добавьте управляемое свойство в веб-часть как настраиваемый столбец.

Подготовка свойства профиля пользователя

Действия этого раздела выполняются в Центре администрирования SharePoint и требуют прав администратора SharePoint. Если нужное свойство уже существует и сопоставлено с управляемым свойством, переходите к разделу Добавление настраиваемого столбца в веб-часть.

Создание свойства профиля пользователя

1. В Центре администрирования SharePoint откройте More features (Дополнительные возможности) и в разделе Профили пользователей нажмите Open (Открыть).
2. В разделе People (Люди) выберите Manage User Properties (Управление свойствами пользователей), а затем New Property (Создать свойство).
3. Укажите Имя (внутреннее имя, например CostCenter), Display Name (отображаемое имя) и Type (тип).
4. В разделе Search Settings (Параметры поиска) установите флажок Indexed (Индексируется). Без этого параметра свойство не обходится поиском и не может отображаться веб-частью.
5. Задайте параметры политики и редактирования в соответствии с требованиями организации и нажмите OK.

Заполните свойство для пользователей - в профиле, с помощью процесса импорта или скрипта. Поиск создаёт обходимое свойство People:<Name> (например, People:CostCenter), когда обходит профили, в которых это свойство заполнено.

Сопоставление с управляемым свойством

1. В Центре администрирования SharePoint откройте More features (Дополнительные возможности) и в разделе Search (Поиск) нажмите Open (Открыть).
2. Выберите Manage Search Schema (Управление схемой поиска).
3. Выберите управляемое свойство для значения. Проще всего использовать одно из свободных встроенных свойств RefinableString00–RefinableString99: они уже поддерживают запросы, извлечение, уточнение и сортировку. Можно также создать новое управляемое свойство типа Text (Текст) с включённым параметром Retrievable (Извлекаемое).
4. Откройте управляемое свойство, в разделе Mappings to crawled properties (Сопоставления с обходимыми свойствами) нажмите Add a Mapping (Добавить сопоставление), найдите People:<Name> и добавьте его.
5. Сохраните управляемое свойство.

Запишите точное имя управляемого свойства, например RefinableString05, - его нужно будет ввести в веб-части.

Добавление настраиваемого столбца в веб-часть

1. Откройте страницу с веб-частью Employee Directory, нажмите Изменить, а затем щёлкните значок редактирования (карандаш) веб-части, чтобы открыть её панель свойств.
2. В разделе Источник данных убедитесь, что в поле Источник данных выбрано Профили пользователей.
3. В разделе Настраиваемые столбцы нажмите Настроить.

4. Откроется панель Столбцы. В пустой строке внизу таблицы введите имя управляемого свойства в поле Столбец, а подпись, которую увидят пользователи, - в поле Подпись, и укажите, где показывать столбец.
5. Нажмите Добавить новый элемент (значок «плюс» в конце строки). Столбец будет добавлен в таблицу. Повторите для каждого нужного атрибута.
6. С помощью поля Порядок измените положение столбцов и нажмите Сохранить.
7. Повторно опубликуйте страницу.

Для каждого настраиваемого столбца доступны следующие параметры:

Чтобы удалить настраиваемый столбец, нажмите Удалить строку (значок корзины) в конце его строки, а затем Сохранить. Кнопка Отмена закрывает панель без применения изменений.

Где отображаются настраиваемые столбцы

После сохранения настраиваемый столбец можно использовать там же, где и встроенные поля:

• Представление «Сведения» - как столбец списка, если установлен флажок Показать в списке.
• Панель сведений - под встроенными атрибутами, если установлен флажок Показать на карточке и у человека есть значение. См. статью KB10199. Employee Directory: настройка панели сведений.
• Карточки контактов - как одна из строк карточки, выбранных в разделе Поля содержимого.
• Группировка - раскрывающийся список Группировать по в разделе Оформление содержит все настраиваемые столбцы, поэтому сотрудников можно сгруппировать, например, по центру затрат или зданию.
• Экспорт в Excel - столбцы с флажком Показать в списке включаются в экспортируемую таблицу.
• Панель уточнений - уточняемое управляемое свойство (например, RefinableString05) можно также добавить как уточнитель. См. статью KB10313. Как настроить панель уточнений в Employee Directory.

Если настраиваемый столбец пуст

Если в столбце или на панели сведений нет значения, проверьте следующее:

• Свойство профиля пользователя помечено как Indexed (Индексируется), и у человека действительно есть значение этого свойства.
• Обходимое свойство People:<Name> сопоставлено с управляемым свойством, а управляемое свойство является Retrievable (Извлекаемым).
• После изменения схемы поиска профили были обойдены повторно - новые сопоставления применяются не сразу.
• Имя в поле Столбец точно совпадает с именем управляемого свойства.

Панель сведений показывает пользовательский атрибут только при наличии в нём данных, поэтому пустое значение просто не отображается.

Источник данных Microsoft Entra ID

Когда веб-часть получает данные из Microsoft Entra ID через Microsoft Graph, настраиваемый столбец ссылается не на управляемое свойство, а на свойство объекта пользователя Entra ID - стандартное свойство пользователя, расширение каталога (extension_{appId}_{name}) или один из локальных атрибутов расширения extensionAttribute1–extensionAttribute15. Схема поиска при этом не используется.