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

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


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