Employee Directory (Entra ID): справочник по редактору фильтров

Редактор фильтров веб-части Vitextra Employee Directory (Entra ID) определяет, каких сотрудников показывает веб-часть. С его помощью можно задать для страницы постоянную область — например, только один отдел, только одну страну или всех, кроме служебных учётных записей, — из условий и групп условий, объединённых через И и ИЛИ. Тот же редактор используется в веб-части New Employees. Эта статья — справочник по всем возможностям редактора: полям, операторам, типам значений, группам, ролям пользователей, способу применения фильтра, его ограничениям и типовым примерам.

Где находится редактор фильтров

Перейдите в режим редактирования страницы, откройте панель свойств веб-части и разверните группу Источник данных. В разделе Фильтр отображается предварительный просмотр текущего фильтра — или надпись Фильтр не применен., если фильтра нет, — и кнопка Изменить фильтр.

Нажмите Изменить фильтр, чтобы открыть панель Расширенная фильтрация. Составьте фильтр и нажмите Сохранить, чтобы применить его, или Отмена, чтобы отменить изменения. Страница обновляется сразу после сохранения; опубликуйте страницу повторно, чтобы изменение увидели все.

Структура фильтра

Фильтр состоит из верхнего уровня, на котором могут находиться элементы двух видов; оба добавляются кнопкой Добавить:

• Условие — одно правило: поле, оператор и (для большинства операторов) значение. Например, Отдел Равно Sales.
• Группа — контейнер для нескольких условий с собственной настройкой И/ИЛИ. Группы можно добавлять только на верхнем уровне; внутри группы можно добавлять условия, но не другие группы.

У каждого уровня — верхнего и каждой группы — есть переключатель И / ИЛИ:

• И — сотрудник должен соответствовать всем условиям этого уровня.
• ИЛИ — сотрудник должен соответствовать хотя бы одному условию этого уровня.

При вычислении фильтра условия верхнего уровня объединяются по переключателю верхнего уровня, условия внутри каждой группы — по переключателю этой группы, а затем каждая группа объединяется с остальной частью фильтра через И. На практике это даёт простой шаблон: условия, которые должны выполняться все сразу, размещайте на верхнем уровне с И, а каждый набор альтернатив («Sales или Marketing», «Германия или Австрия») — в отдельной группе с ИЛИ.

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

Доступные поля

Список полей условия разделён на разделы:

В веб-части Employee Directory (Entra ID) раздел Свойства содержит все столбцы из настройки Столбцы — независимо от того, отображается ли столбец в списке, — а также все столбцы из Настраиваемые столбцы. Столбцы Изображение и Состояние (присутствие) исключены, так как не содержат текста для фильтрации. В веб-части New Employees список фиксирован: в нём стандартные столбцы, пользовательские атрибуты недоступны.

Встроенные столбцы, наиболее полезные для фильтрации, и соответствующие им атрибуты пользователя Microsoft Entra ID:

Операторы

Набор доступных операторов зависит от поля:

Все текстовые сравнения не зависят от регистра: sales, Sales и SALES считаются одинаковыми. Текст сравнивается буквально — подстановочные знаки, такие как * или %, не имеют особого значения, а пробелы учитываются, поэтому не добавляйте пробелы в начале или в конце значения.

Типы значений

Элемент ввода значения зависит от выбранного поля:

• Текстовое поле — для всех полей раздела Свойства. Введите текст для сравнения. Для Содержит данные и Не содержит данных значение не требуется, поэтому текстовое поле скрыто.
• Раскрывающийся список — для Состояния учётной записи: Включена или Отключена.
• Список с множественным выбором — для Ролей пользователей: выберите одну или несколько ролей каталога.

Значения сравниваются как текст. Числа и даты не сравниваются как числа или даты — например, Табельный номер Начинается с 10 подходит для 10, 105 и 10-A, — поэтому операторов «больше» и «меньше» нет.

Роли пользователей и шаблоны ролей

Условие Роли пользователей содержит встроенные роли каталога Microsoft Entra — Global Administrator, User Administrator, Exchange Administrator, SharePoint Administrator, Teams Administrator, Helpdesk Administrator, Directory Synchronization Accounts и ещё около сотни. Этот список шаблонов ролей поставляется вместе с веб-частью: у каждой встроенной роли есть фиксированный идентификатор шаблона роли, одинаковый во всех клиентах Microsoft 365, поэтому список не нужно загружать из вашего клиента, а сохранённый фильтр продолжает работать при переносе в другой клиент.

Условие по Ролям пользователей сравнивает выбранные роли с ролями каталога, назначенными каждому сотруднику:

• Содержит — у сотрудника есть хотя бы одна из выбранных ролей.
• Не содержит — у сотрудника нет ни одной из выбранных ролей.

В списке есть только встроенные роли каталога; настраиваемые роли, роли приложений и членство в группах в этом условии не учитываются.

Связь фильтра с Microsoft Graph

Фильтр не преобразуется в запрос Microsoft Graph с $filter. Веб-часть получает пользователей из Microsoft Graph, а затем применяет фильтр в браузере к загруженным данным:

• Employee Directory (Entra ID) загружает всех пользователей каталога постранично (по 900 пользователей за запрос). Единственное условие, передаваемое в Microsoft Graph, — accountEnabled eq true, и только если включён параметр Исключать заблокированных пользователей.
• New Employees запрашивает в Microsoft Graph пользователей-участников (userType eq 'Member'), созданных за заданное число месяцев (Показать пользователей, созданных за последние месяцы), и затем применяет фильтр к этому результату.

Поскольку фильтр выполняется в браузере, ограничения расширенных запросов Microsoft Graph на него не распространяются: операторы Содержит, Начинается с и Не содержит можно использовать для любого поля из списка, включая пользовательские атрибуты, и дополнительные разрешения Microsoft Graph не нужны. С другой стороны, фильтр не уменьшает объём данных, загружаемых веб-частью, — в большом каталоге первая загрузка занимает одинаковое время с фильтром и без него.

Фильтр работает вместе с остальными настройками веб-части. Сотрудник отображается, только если он проходит параметры группы Исключить Сотрудников, фильтр и — если они используются — панель уточнения, навигацию A–Z и поиск. Значения панели уточнения и буквы навигации A–Z рассчитываются по сотрудникам, прошедшим фильтр.

Ограничения

• Один уровень групп. Группы можно добавлять только на верхнем уровне, и они всегда объединяются с остальной частью фильтра через И.
• Только текстовое сравнение. Нет сравнения чисел и дат, подстановочных знаков и регулярных выражений; регистр не учитывается.
• Нет оператора «заканчивается на» в редакторе.
• Значения должны совпадать с каталогом. Фильтр сравнивает значения, хранящиеся в Microsoft Entra ID. Если в атрибуте Страна или регион у одних пользователей указано DE, а у других Germany, добавьте оба значения в группу ИЛИ.
• Только однозначные текстовые атрибуты. Столбцы с человеком, несколькими значениями или незаполняемые столбцы для фильтрации не подходят (см. Доступные поля).
• Это не механизм безопасности. Фильтр определяет, что веб-часть показывает на странице; он не ограничивает ничей доступ к данным каталога в Microsoft 365.

Примеры

В примерах используются подписи интерфейса на русском языке. Замените примерные значения значениями из вашего каталога.

Пример 1. Один отдел

Показать только отдел продаж.

• Верхний уровень (И): Отдел Равно Sales

Пример 2. Несколько стран или офисов

Показать сотрудников, работающих в регионе DACH.

• Группа (ИЛИ):
  • Страна или регион Равно Germany
  • Страна или регион Равно Austria
  • Страна или регион Равно Switzerland

Чтобы показать сотрудников одного офисного здания, используйте одно условие, например Расположение офиса Начинается с Berlin — оно подходит для Berlin HQ, Berlin, Floor 3 и т. д.

Пример 3. Должность содержит или начинается с

Показать руководителей и старших специалистов.

• Группа (ИЛИ):
  • Должность Содержит manager
  • Должность Начинается с Senior

Поскольку регистр не учитывается, manager подходит и для Project Manager, и для Managing Director.

Пример 4. Пользовательский атрибут

Показать один центр затрат, хранящийся в локальном атрибуте расширения, который вы добавили в Настраиваемые столбцы с заголовком Центр затрат (например, extensionAttribute1).

• Верхний уровень (И): Центр затрат Равно 4100

Пример 5. Исключить служебные учётные записи и гостей

Скрыть технические учётные записи, общие почтовые ящики и внешних гостей из общего справочника компании. Все условия верхнего уровня должны выполняться:

• Верхний уровень (И):
  • Состояние учётной записи Равно Включена
  • Имя пользователя Не начинается с svc
  • Полное имя Не содержит service
  • Имя пользователя Не содержит #EXT#
  • Отдел Содержит данные

Условие с #EXT# убирает гостевых пользователей, у которых имя участника-пользователя содержит этот маркер. Требование указанного отдела — простой способ отсеять большинство учётных записей, не принадлежащих реальным сотрудникам. Адаптируйте условия к правилам именования в вашей организации.

Пример 6. Условие верхнего уровня вместе с группой ИЛИ

Показать отделы продаж и маркетинга в Германии.

• Верхний уровень (И): Страна или регион Равно Germany
• Группа (ИЛИ):
  • Отдел Равно Sales
  • Отдел Равно Marketing

Группа объединяется с условием верхнего уровня через И, поэтому результат: Germany и (Sales или Marketing).

Редактор фильтров в New Employees

В веб-части New Employees тот же редактор фильтров находится в разделе Фильтр панели свойств. Он работает так же, со следующими отличиями:

• Фильтр применяется к пользователям, которых New Employees уже отобрала, — пользователям-участникам, созданным за период Показать пользователей, созданных за последние месяцы.
• Список полей содержит стандартные столбцы; пользовательские атрибуты недоступны.
• Состояние учётной записи доступно так же, как в Employee Directory (Entra ID). Роли пользователей тоже есть в списке, но с тем же ограничением (см. Роли пользователей и шаблоны ролей).

Типичный сценарий — приветствовать только штатных сотрудников, например Тип сотрудника Равно Employee, или только новичков одного офиса, например Расположение офиса Начинается с London.