Документация для разработчиков
Темная тема

Список сотрудников


Описание intranet.structure.list

Компонент выводит список сотрудников, удовлетворяющих внешнему фильтру. Компонент содержит два шаблона: (.default) и (.list).Компонент является стандартным и входит в дистрибутив модуля.

В визуальном редакторе компонент находится в Компоненты > Корпоративный портал > Оргструктура.



Параметры

Поле Параметр Описание
Основные параметры
Выводить только синхронизируемых с 1С пользователей FILTER_1C_USERS [Y|N] При отмеченной опции будут выводиться только синхронизируемые с 1С пользователи.
Фильтр по подразделениям FILTER_SECTION_CURONLY Указывается тип фильтра по подразделениям:
  • прямой (Y);
  • рекурсивный (N).
Отображение имени NAME_TEMPLATE Указывается шаблон для отображения ФИО пользователя социальной сети. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество.
Выводить уведомление при пустом списке SHOW_ERROR_ON_NULL [Y|N] При отмеченной опции будет выводиться уведомление при пустом списке.
Количество пользователей на страницу USERS_PER_PAGE Поле определяет количество пользователей, отображаемых на одной странице. Весь список будет отображен с помощью постраничной навигации.
Подпись постраничной навигации NAV_TITLE Указывается подпись для постраничной навигации.
Показывать постраничную навигацию над списком SHOW_NAV_TOP [Y|N] При отмеченной опции постраничная навигация будет показываться над списком.
Показывать постраничную навигацию под списком SHOW_NAV_BOTTOM [Y|N] При отмеченной опции постраничная навигация будет показываться под списком.
Показывать список при пустом фильтре SHOW_UNFILTERED_LIST [Y|N] Если условия поиска не заданы, то при отмеченной опции будет выведен весь список сотрудников.
Настройки кеширования
Тип кеширования CACHE_TYPE Указывается тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Вывести руководителя при фильтре по подразделению SHOW_DEP_HEAD_ADDITIONAL [Y/N] При отмеченной опции в фильтре по подразделению будет отображен руководитель подразделения.
Параметры для вывода в списке USER_PROPERTY Указываются поля пользователей, которые будут показаны в визитных карточках сотрудников.
Параметры для вывода в Excel USER_PROPERTY_EXCEL Указываются поля пользователей, которые должны быть выгружены при выполнении экспорта пользователей в MS Excel.
Страница отправки личного сообщения PM_URL Указывается путь к странице отправки личного сообщения.

Данное поле доступно только для шаблона .list.
Дополнительные поля для вывода USER_PROPERTY Указываются, какие поля будут выводиться в списке сотрудников, удовлетворяющих внешнему фильтру.

Данное поле доступно только для шаблона .list.
Параметры фильтра
Имя фильтра FILTER_NAME Указывается имя фильтра.


Пример вызова

<?$APPLICATION->IncludeComponent("bitrix:intranet.structure.list","",Array(
		"USER_PROPERTY" => Array("FULL_NAME", "EMAIL", "PERSONAL_PHONE", "WORK_POSITION", "UF_DEPARTMENT"),
		"USER_PROPERTY_EXCEL" => Array("FULL_NAME", "EMAIL", "PERSONAL_PHONE", "WORK_POSITION", "UF_DEPARTMENT"),
		"FILTER_NAME" => "users",
		"FILTER_1C_USERS" => "Y",
		"FILTER_SECTION_CURONLY" => "N",
		"NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#",
		"SHOW_ERROR_ON_NULL" => "Y",
		"USERS_PER_PAGE" => "10",
		"NAV_TITLE" => "Сотрудники",
		"SHOW_NAV_TOP" => "Y",
		"SHOW_NAV_BOTTOM" => "Y",
		"SHOW_UNFILTERED_LIST" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600"
	)
);?>



© «Битрикс», 2001-2024, «1С-Битрикс», 2024