--- title: "Как добавить и настроить веб-часть Employee Directory" description: "Пошаговое руководство по добавлению веб-части Vitextra Employee Directory на страницу SharePoint Online и настройке основных параметров: источник данных (профили пользователей или Microsoft Entra ID), столбцы, сортировка, размер страницы, поле поиска и итоги, а также обзор остальных групп панели свойств." url: https://vitextra.com/ru/support/kb/10309 language: ru published: 2026-10-18 modified: 2026-10-18 products: - "Employee Directory" author: "Vitālijs Kalniņš" tags: ["добавить веб-часть Employee Directory", "настройка Employee Directory", "справочник сотрудников SharePoint Online", "панель свойств Employee Directory", "источник данных профили пользователей или Entra ID", "сохраненный запрос KQL", "скрытые пользователи", "непустой отдел", "сортировка сотрудников", "элементов на странице", "параметры Vitextra Employee Directory"] --- # Как добавить и настроить веб-часть Employee Directory Пошаговое руководство по добавлению веб-части Vitextra Employee Directory на страницу SharePoint Online и настройке основных параметров: источник данных (профили пользователей или Microsoft Entra ID), столбцы, сортировка, размер страницы, поле поиска и итоги, а также обзор остальных групп панели свойств. В этой статье описаны первые шаги с веб-частью Vitextra [Employee Directory](https://vitextra.com/ru/products/employee-directory): добавление ее на современную страницу SharePoint Online и настройка основных параметров панели свойств — источника данных, столбцов, сортировки, размера страницы, поля поиска и итогов. В конце статьи приведен обзор остальных групп панели свойств со ссылками на статьи, где они описаны подробно. ## Перед началом работы Прежде чем добавлять веб-часть на страницу, убедитесь, что: - **Решение Employee Directory установлено** в каталоге приложений клиента. Порядок установки описан в статье [KB10035. Как установить продукт Vitextra в SharePoint Online](https://vitextra.com/ru/support/kb/10035). - **Разрешения Microsoft Graph одобрены.** Решение запрашивает разрешения **Directory.Read.All**, **User.Read.All**, **Presence.Read.All**, **Calendars.Read** и **People.Read**. Администратор SharePoint или глобальный администратор одобряет их на странице **Доступ к API** в центре администрирования SharePoint. - **У вас есть права на редактирование страницы** — достаточно уровня разрешений **Изменение** или членства в группе участников сайта. ❗ **Важно** Пока разрешения Microsoft Graph не одобрены, веб-часть не может читать данные из Microsoft Entra ID: источник данных **Entra ID** не возвращает сотрудников, а состояние присутствия, доступность и быстрый фильтр **Люди, с которыми я работаю** не работают. 📝 **Примечание** Решение содержит две веб-части справочника: **Employee Directory**, описанную в этой статье, и **Employee Directory (Entra ID)**, в которой есть редактор фильтров, исключения и навигация A–Z. Чтобы выбрать подходящую, см. статью [KB10310. Employee Directory или Employee Directory (Entra ID): какую веб-часть выбрать](https://vitextra.com/ru/support/kb/10310). ## Добавление веб-части на страницу 1. Откройте страницу и нажмите **Изменить** в правом верхнем углу. 2. Наведите указатель на место, где должен находиться справочник, и, когда появится линия со знаком **+**, щелкните его, чтобы открыть панель элементов веб-частей. 3. Введите *Employee Directory* в поле поиска и выберите **Employee Directory**. ![Employee Directory на панели элементов веб-частей](https://static.vitextra.com/articles/10309/web-part-toolbox-ru.png) *Employee Directory на панели элементов веб-частей* Веб-часть появляется на странице и сразу показывает сотрудников организации с параметрами по умолчанию. Чтобы изменить параметры, щелкните значок карандаша (**Изменить веб-часть**) слева от веб-части — справа откроется панель свойств. Группы панели отображаются в виде аккордеона: щелкните название группы, чтобы развернуть ее. 📝 **Примечание** На сайтах с русским языком интерфейса веб-часть может отображаться на панели элементов под локализованным названием *Справочник Сотрудников*. ## Выбор источника данных Первая группа панели свойств, **Источник данных**, определяет, откуда веб-часть берет данные о сотрудниках. Выберите одно из двух значений в раскрывающемся списке **Источник данных**: - **Профили пользователей** (по умолчанию) — сотрудники находятся через поиск SharePoint в профилях пользователей SharePoint. Этот источник поддерживает сохраненный запрос (KQL), скрытые профили и панель уточнений. - **Entra ID (Azure AD)** — данные о сотрудниках читаются напрямую из Microsoft Entra ID через Microsoft Graph. Показываются только включенные учетные записи участников; гостевые учетные записи исключаются. Остальная часть группы **Источник данных** зависит от выбранного источника: одни параметры доступны только для **Профили пользователей**, другие — только для **Entra ID (Azure AD)**. Они описаны ниже. ![Группа «Источник данных» с источником «Профили пользователей»](https://static.vitextra.com/articles/10309/data-source-profiles-ru.png) *Группа «Источник данных» с источником «Профили пользователей»* 💡 **Совет** Выбирайте **Профили пользователей**, если справочник опирается на свойства профилей SharePoint, запросы KQL или панель уточнений. Выбирайте **Entra ID (Azure AD)**, если данные в Microsoft Entra ID наиболее полные и актуальные или если нужен поиск по навыкам. ## Столбцы и настраиваемые столбцы Под списком источников находятся две кнопки **Настроить**: - **Столбцы** — открывает список встроенных свойств сотрудника (имя, должность, отдел, телефоны, расположение офиса и другие). Для каждого свойства можно указать, показывать ли его в списке (**Показать в списке**) и на карточке сотрудника (**Показать на карточке**), изменить **Подпись** и задать **Порядок**. - **Настраиваемые столбцы** — позволяет добавить свойства, которых нет во встроенном списке: пользовательские свойства профилей SharePoint или пользовательские атрибуты Microsoft Entra ID. Нажмите **Добавить новый элемент**, введите имя свойства и подпись, затем сохраните. Настроенные столбцы используются и в других местах веб-части: они предлагаются в группе **Поля содержимого** для карточек и в списке **Группировать по**. 💡 **Совет** Пошаговые инструкции по пользовательским свойствам приведены в статьях [KB10049. Как добавить пользовательские атрибуты в веб-часть Employee Directory](https://vitextra.com/ru/support/kb/10049) (профили пользователей) и [KB10060. Как отобразить пользовательские атрибуты Entra ID в веб-части Employee Directory](https://vitextra.com/ru/support/kb/10060) (Microsoft Entra ID). ## Параметры источника «Профили пользователей» Если выбран источник **Профили пользователей**, в группе **Источник данных** доступны еще два параметра: - **Сохраненный запрос** — условие на языке KQL (Keyword Query Language), которое добавляется к каждому поиску веб-части, включая первоначальный список. С его помощью справочник можно ограничить частью организации, например `Department:"Sales"` — только отдел продаж, или `(Department:"Sales" OR Department:"Marketing")` — два отдела. Значение по умолчанию `*` означает отсутствие ограничений. - **Показывать скрытых пользователей** — по умолчанию веб-часть не показывает профили, скрытые из адресных книг. Включите этот параметр, чтобы показывать и их. Служебные учетные записи (например, *app@sharepoint* или *Sync_DC_*) исключаются всегда. 📝 **Примечание** Сохраненный запрос объединяется с текстом, который пользователь вводит в поле поиска, поэтому искать можно только в той части справочника, которую разрешает запрос. Запрос с синтаксической ошибкой не возвращает результатов — проверьте его на странице перед публикацией. ## Параметры источника Entra ID Если выбран источник **Entra ID (Azure AD)**, сохраненный запрос и параметр **Показывать скрытых пользователей** недоступны. Вместо них в группе есть переключатель **Показывать только пользователей с непустым отделом**. По умолчанию он включен и скрывает учетные записи без отдела — как правило, общие почтовые ящики, переговорные комнаты и технические учетные записи, которые не являются сотрудниками. Выключите его, чтобы показывать все включенные учетные записи участников. ![Группа «Источник данных» с источником Entra ID](https://static.vitextra.com/articles/10309/data-source-entra-id-ru.png) *Группа «Источник данных» с источником Entra ID* Переключатель **Поиск по навыкам** в этой же группе добавляет в результаты сотрудников, навыки которых в профиле совпадают с текстом поиска. По умолчанию он включен и действует при источнике **Entra ID (Azure AD)**. См. статью [KB10316. Как искать сотрудников по навыкам в Employee Directory](https://vitextra.com/ru/support/kb/10316). 📝 **Примечание** Для более точной фильтрации по атрибутам Microsoft Entra ID — например, по компании, стране или типу сотрудника, а также для исключения нелицензированных и отключенных учетных записей — используйте веб-часть **Employee Directory (Entra ID)**. См. статью [KB10311. Как настроить веб-часть Employee Directory (Entra ID): фильтры, исключения и алфавитная навигация](https://vitextra.com/ru/support/kb/10311). ## Сортировка и размер страницы Три параметра в конце группы **Источник данных** определяют порядок результатов и количество сотрудников, загружаемых за один раз: - **Сортировка по** — поле, по которому сортируются результаты. Набор полей зависит от источника: **(По умолчанию)**, **Имя** и **Фамилия** для **Профили пользователей**; **(По умолчанию)** и **Полное имя** для **Entra ID (Azure AD)**. При значении **(По умолчанию)** результаты из профилей пользователей сортируются по релевантности поиска, а результаты из Entra ID выводятся в том порядке, в котором их возвращает Microsoft Graph. - **Направление** — **Сортировать от А до Я** (по умолчанию) или **Сортировать от Я до А**. - **Показывать элементов на странице** — сколько сотрудников загружается за один раз, от 1 до 50 (по умолчанию 40). Если результатов больше, под списком появляется кнопка **Показать еще результаты...**, которая загружает следующую порцию. 💡 **Совет** Меньший размер страницы ускоряет первую загрузку больших справочников, больший — избавляет пользователей от частых нажатий **Показать еще результаты...**. Для справочников на несколько тысяч сотрудников обычно оптимально значение от 20 до 40. ## Поле поиска и итоги Два переключателя в начале группы **Оформление** управляют элементами над результатами: - **Показывать поле поиска** — показывает или скрывает поле поиска. Выключите его, если веб-часть должна показывать фиксированный список, например сотрудников одного отдела, заданного сохраненным запросом. - **Показывать итоги** — показывает или скрывает количество найденных сотрудников. Оба переключателя по умолчанию включены. ![Настроенная веб-часть на странице](https://static.vitextra.com/articles/10309/configured-web-part-ru.png) *Настроенная веб-часть на странице* ## Остальные параметры Остальные группы панели свойств описаны в отдельных статьях: | Группа | Что настраивает | Подробнее | |---|---|---| | **Оформление** | Представление (**Сведения** или карточки **Контакт**), **Группировать по**, **Размер** карточки и **Компактный список** | [KB10314. Представления Employee Directory: список и карточки, размер карточки, поля карточки и группировка](https://vitextra.com/ru/support/kb/10314) | | **Быстрые фильтры** | Какие быстрые фильтры показываются: «Мой отдел», «Моя команда», «Люди, с которыми я работаю», «Избранное» | [KB10214. Быстрые фильтры Employee Directory: мой отдел, моя команда, люди, с которыми я работаю, избранное](https://vitextra.com/ru/support/kb/10214) | | **Поля содержимого** | Поля, отображаемые на каждой карточке (доступно в представлении **Контакт**) | [KB10314. Представления Employee Directory: список и карточки, размер карточки, поля карточки и группировка](https://vitextra.com/ru/support/kb/10314) | | **Панель** | Разделы панели сведений: руководитель, прямые подчиненные, доступность, местное время и рабочие часы, документы, «Обо мне», увлечения, навыки | [KB10199. Employee Directory: настройка панели сведений](https://vitextra.com/ru/support/kb/10199), [KB10317. Employee Directory: местное время, рабочие часы и доступность](https://vitextra.com/ru/support/kb/10317) | | **Контекстное меню** и **Быстрые действия** | Какие действия доступны в контекстном меню и в виде кнопок на карточке: чат, звонок, электронная почта, копирование адреса, назначение встречи, vCard | [KB10315. Действия с сотрудниками в Employee Directory: чат, звонок, письмо, копирование адреса, встреча и vCard](https://vitextra.com/ru/support/kb/10315) | | **Экспорт** | Экспорт результатов в электронную таблицу Microsoft Excel | [KB10062. Как экспортировать результаты Employee Directory в Microsoft Excel](https://vitextra.com/ru/support/kb/10062) | | **Панель уточнений** | Панель с уточнителями и ее расположение (только для источника **Профили пользователей**) | [KB10313. Как настроить панель уточнений в Employee Directory](https://vitextra.com/ru/support/kb/10313) | | **Личное приложение (Microsoft Teams)** | Кнопка **Сохранить параметры** сохраняет текущую конфигурацию как конфигурацию клиента по умолчанию, которую использует личное приложение Employee Directory в Microsoft Teams | — | | **Сведения** | Состояние лицензии и сведения о продукте | [KB10206. Лицензирование и учётная запись Vitextra: как приобрести и активировать лицензию](https://vitextra.com/ru/support/kb/10206) | 📝 **Примечание** Группа **Панель уточнений** отображается только при источнике **Профили пользователей**. Группа **Личное приложение (Microsoft Teams)** не отображается, если страница открыта внутри Microsoft Teams. ## Сохранение страницы Параметры применяются на странице сразу после изменения, поэтому результат можно проверить до публикации. Когда справочник выглядит как нужно, нажмите **Повторно опубликовать** (или **Опубликовать** для новой страницы), чтобы изменения увидели все пользователи. 💡 **Совет** Чтобы выделить справочнику отдельную страницу без других веб-частей, см. статью [KB10040. Как создать одностраничное приложение (Single App Page) с Vitextra Employee Directory](https://vitextra.com/ru/support/kb/10040).