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

Поиск сотрудника (комплексный компонент)


Описание intranet.search

Компонент выводит форму поиска и список найденных сотрудников корпоративного портала. Компонент является стандартным и входит в дистрибутив модуля.

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



Параметры

Поле Параметр Описание
Основные параметры
Страница структуры компании STRUCTURE_PAGE Указывается путь к странице структуры компании.
Страница отправки личного сообщения PM_URL Указывается путь к странице отправки личного сообщения.
Шаблон пути к странице подразделения PATH_TO_CONPANY_DEPARTMENT Указывается шаблон пути к странице подразделения компании.
Имя фильтра страницы структуры компании STRUCTURE_FILTER Указывается имя фильтра страницы структуры компании.
Выводить только синхронизируемых с 1С пользователей FILTER_1C_USERS [Y|N] При отмеченной опции будут выводиться только синхронизируемые с 1С пользователи.
Количество пользователей на страницу USERS_PER_PAGE Поле определяет количество пользователей, отображаемых на одной странице. Весь список будет отображен с помощью постраничной навигации.
Фильтр по подразделениям FILTER_SECTION_CURONLY Указывается тип фильтра по подразделениям:
  • прямой (Y);
  • рекурсивный (N).
Отображение имени NAME_TEMPLATE Указывается шаблон для отображения ФИО пользователя социальной сети. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество.
Показывать логин, если не задано имя SHOW_LOGIN [Y|N] При отмеченной опции будет отображен логин пользователя, если не задано имя.
Выводить уведомление при пустом списке SHOW_ERROR_ON_NULL [Y|N] При отмеченной опции выводится уведомление при пустом списке.
Отображать фильтр по алфавиту на языках ALPHABET_LANG Задаются языки для показа фильтра по алфавиту.
Подпись постраничной навигации NAV_TITLE Поле содержит подпись для постраничной навигации.
Показывать постраничную навигацию над списком SHOW_NAV_TOP [Y|N] При отмеченной опции постраничная навигация будет показываться над списком.
Показывать постраничную навигацию под списком SHOW_NAV_BOTTOM [Y|N] При отмеченной опции постраничная навигация будет показываться под списком.
Показывать список при пустом фильтре SHOW_UNFILTERED_LIST [Y|N] При отмеченной опции будет выведен весь список сотрудников. Если опция не отмечена, то будет показана только форма поиска.
Управление режимом AJAX
Включить режим AJAX AJAX_MODE [Y|N] При отмеченной опции для компонента будет включен режим AJAX.
Включить прокрутку к началу компонента AJAX_OPTION_JUMP [Y|N] Если пользователь совершит AJAX-переход, то при установленой опции по окончании загрузки произойдет прокрутка к началу компонента.
Включить подгрузку стилей AJAX_OPTION_STYLE [Y|N] Если параметр принимает значение Y, то при совершении AJAX-переходов будет происходить подгрузка и обработка списка стилей, вызванных компонентом.
Включить эмуляцию навигации браузера AJAX_OPTION_HISTORY [Y|N] Когда пользователь выполняет AJAX-переходы, то при включенной опции можно использовать кнопки браузера Назад и Вперед.
Настройки кеширования
Тип кеширования CACHE_TYPE Указывается тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Формат показа даты DATE_FORMAT Указывается формат показа даты. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Формат показа даты без года DATE_FORMAT_NO_YEAR Указывается формат показа даты без года. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Формат показа даты и времени DATE_TIME_FORMAT Указывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты и времени, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Показывать год рождения SHOW_YEAR Поле определяет кому показываеть год рождения:
  • всем (Y);
  • только мужчинам (M);
  • никому (N).
Страница видеозвонка PATH_TO_VIDEO_CALL Указывается шаблон пути к видеозвонку.
Показывать переключатель представления USE_VIEW_SELECTOR [Y|N] При отмеченной опции на странице поиска будет показываться переключатель вывода результатов.
Представление по умолчанию DEFAULT_VIEW Указывается способ вывода результатов поиска по умолчанию:
  • список (list);
  • таблица (table).
Шаблон для представления в виде списка LIST_VIEW Указывается способ для представления в виде списка:
  • простой список (list);
  • с группировкой по отделам (group).


Если параметр принимает значение group, то необходимо настроить следущий параметр: USER_PROPERTY_GROUP.
Шаблон для представления в виде таблицы TABLE_VIEW Указывается способ для представления в виде списка:
  • простой список (list);
  • с группировкой по отделам (group).


Если параметр принимает значение group, то необходимо настроить следущий параметр: USER_PROPERTY_GROUP.
Пользовательские поля для вывода в табличном представлении USER_PROPERTY_TABLE Указываются поля, которые должны быть отображены при выводе списка пользователей в табличном представлении.
Пользовательские поля для вывода в формате Excel USER_PROPERTY_EXCEL Указываются поля пользователей, которые должны быть выгружены при выполнении экспорта пользователей в MS Excel.
Пользовательские поля для вывода в представлении в виде списка USER_PROPERTY_LIST Указываются поля, которые должны быть отображены при выводе пользователей в виде простого списка.
Параметры фильтра
Имя фильтра (для внешних форм фильтрации) FILTER_NAME Указывается имя фильтра (для внешних форм фильтрации).
Выбор подразделения для фильтрации FILTER_DEPARTMENT_SINGLE Указывается способ выбора подразделения(ий) в форме поиска:
  • одинарный (Y) - в выпадающем списке можно выбрать только одно подразделение;
  • множественный (N) - поле позволяет выбирать несколько подразделений.
Запоминать фильтр в сессии FILTER_SESSION [Y|N] При отмеченной опции введеные значения в поля формы поиска будут запоминаться системой.


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

<?$APPLICATION->IncludeComponent("bitrix:intranet.search","",Array(
		"DEFAULT_VIEW" => "table",
		"LIST_VIEW" => "list",
		"USER_PROPERTY_TABLE" => Array("FULL_NAME", "EMAIL", "PERSONAL_PHONE", "WORK_POSITION", "UF_DEPARTMENT"),
		"USER_PROPERTY_EXCEL" => Array("FULL_NAME", "EMAIL", "PERSONAL_PHONE", "WORK_POSITION", "UF_DEPARTMENT"),
		"AJAX_MODE" => "Y",
		"STRUCTURE_PAGE" => "structure.php",
		"PM_URL" => "/messages/form/#USER_ID#/",
		"PATH_TO_CONPANY_DEPARTMENT" => "/company/structure.php?set_filter_structure=Y&structure_UF_DEPARTMENT=#ID#",
		"STRUCTURE_FILTER" => "structure",
		"FILTER_1C_USERS" => "Y",
		"FILTER_NAME" => "users",
		"USERS_PER_PAGE" => "20",
		"FILTER_DEPARTMENT_SINGLE" => "N",
		"FILTER_SESSION" => "Y",
		"FILTER_SECTION_CURONLY" => "N",
		"NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#",
		"SHOW_LOGIN" => "Y",
		"SHOW_ERROR_ON_NULL" => "Y",
		"ALPHABET_LANG" => array("ru"),
		"NAV_TITLE" => "Сотрудники",
		"SHOW_NAV_TOP" => "Y",
		"SHOW_NAV_BOTTOM" => "Y",
		"SHOW_UNFILTERED_LIST" => "Y",
		"DATE_FORMAT" => "d.m.Y",
		"DATE_FORMAT_NO_YEAR" => "d.m",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"SHOW_YEAR" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "3600",
		"PATH_TO_VIDEO_CALL" => "/company/personal/video/#USER_ID#/",
		"AJAX_OPTION_JUMP" => "N",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "N"
	),
);?>



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