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

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


Описание 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
Наверх