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

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


Описание intranet.structure

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

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



Параметры

Поле Параметр Описание
Основные параметры
Страница поиска сотрудников SEARCH_URL Указывается путь к странице поиска сотрудников.
Страница отправки личного сообщения PM_URL Указывается путь к странице отправки личного сообщения.
Шаблон пути к странице подразделения PATH_TO_CONPANY_DEPARTMENT Указывается шаблон пути к странице подразделения компании.
Количество пользователей на страницу 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] При отмеченной опции выводится уведомление при пустом списке.
Подпись постраничной навигации 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).
Выводить информацию о подразделении SHOW_SECTION_INFO [Y|N] При отмеченной опции будет выводится информация о подразделении.
Пользовательские поля для вывода USER_PROPERTY Указываются поля пользователей, которые будут показаны в визитных карточках при просмотре подразделения.
Параметры фильтра
Выводить только синхронизируемых с 1С пользователей FILTER_1C_USERS [Y|N] При отмеченной опции будут выводиться только синхронизируемые с 1С пользователи.


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

<?$APPLICATION->IncludeComponent("bitrix:intranet.structure","",Array(
		"SHOW_FROM_ROOT" => "N",
		"MAX_DEPTH" => "2",
		"MAX_DEPTH_FIRST" => "0",
		"COLUMNS" => "2",
		"COLUMNS_FIRST" => "2",
		"SHOW_SECTION_INFO" => "Y",
		"USER_PROPERTY" => Array("EMAIL", "PERSONAL_ICQ", "PERSONAL_PHONE", "PERSONAL_MOBILE", "UF_PHONE_INNER"),
		"AJAX_MODE" => "Y",
		"SEARCH_URL" => "search.php",
		"PM_URL" => "/messages/form/#USER_ID#/",
		"PATH_TO_CONPANY_DEPARTMENT" => "/company/structure.php?set_filter_structure=Y&structure_UF_DEPARTMENT=#ID#",
		"FILTER_1C_USERS" => "Y",
		"FILTER_NAME" => "users",
		"USERS_PER_PAGE" => "10",
		"FILTER_SECTION_CURONLY" => "Y",
		"NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#",
		"SHOW_LOGIN" => "Y",
		"SHOW_ERROR_ON_NULL" => "Y",
		"NAV_TITLE" => "Сотрудники",
		"SHOW_NAV_TOP" => "Y",
		"SHOW_NAV_BOTTOM" => "Y",
		"SHOW_UNFILTERED_LIST" => "N",
		"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",
		"AJAX_OPTION_JUMP" => "N",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "N"
	),
);?>



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