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

Структура компании


Описание medsite:medsite.structure

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

Компонент доступен для базового варианта решения 1С-Битрикс: Сайт медицинской организации. В визуальном редакторе компонент находится в Мед.сайт > Оргструктура > Структура компании.



Параметры

Поле Параметр Описание
Управление режимом 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-переходы, то при включенной опции можно использовать кнопки браузера Назад и Вперед.
Основные параметры
Страница поиска сотрудников SEARCH_URL Указывается путь к странице поиска сотрудников.
Инфоблок расписаний SHEDULES_BLOCK Указывается шаблон пути к инфоблоку расписаний.
Страница отправки личного сообщения 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] При отмеченной опции будет выведен весь список сотрудников. Если опция не отмечена, то будет показана только структура компании.
Параметры фильтра
Выводить только синхронизируемых с 1С пользователей FILTER_1C_USERS [Y|N] При отмеченной опции будут выводиться только синхронизируемые с 1С пользователи.
Имя фильтра (для внешних форм фильтрации) FILTER_NAME Указывается имя фильтра (для внешних форм фильтрации).
Дополнительные настройки
Ссылка на расписание сотрудника SCHEDULE_LINK Ссылка на раздел записи на прием.
Показывать пользователей из групп GROUPS С помощью клавиши Ctrl выбираются группы, пользователи из которых будут показаны. По умолчанию - все.
Формат показа даты и времени DATE_FORMAT Указывается формат показа даты. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
Показывать год рождения SHOW_YEAR Поле определяет, кому показывать год рождения:
  • всем (Y);
  • только мужчинам (M);
  • никому (N).
Всегда показывать структуру с корня SHOW_FROM_ROOT [Y|N] При отмеченной опции структура компании будет всегда отображаться с корня.
Максимальная глубина дерева (0 - все) MAX_DEPTH Указывается максимальная глубина дерева подразделений. Параметр доступен при выключенной опции SHOW_FROM_ROOT.
Максимальная глубина дерева на первой странице (0 - все) MAX_DEPTH_FIRST Указывается максимальная глубина дерева подразделений на первой странице.
Количество колонок COLUMNS Параметр определяет количество колонок (столбцов), в которых будет выведен список подразделений.
Количество колонок на первой странице COLUMNS_FIRST Параметр определяет количество колонок (столбцов) на первой странице, в которых будет выведен список подразделений.
Выводить информацию о подразделении SHOW_SECTION_INFO [Y|N] При отмеченной опции будет выводиться информация о подразделении.
Пользовательские поля для вывода USER_PROPERTY Указываются поля пользователей, которые будут показаны в визитных карточках при просмотре подразделения.
Настройки кеширования
Тип кеширования CACHE_TYPE Указывается тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.


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

<?$APPLICATION->IncludeComponent(
	"medsite:medsite.structure",
	"",
	Array(
		"AJAX_MODE" => "N",
		"AJAX_OPTION_ADDITIONAL" => "",
		"AJAX_OPTION_HISTORY" => "N",
		"AJAX_OPTION_JUMP" => "N",
		"AJAX_OPTION_STYLE" => "Y",
		"CACHE_TIME" => "3600",
		"CACHE_TYPE" => "A",
		"COLUMNS" => "2",
		"COLUMNS_FIRST" => "2",
		"DATE_TIME_FORMAT" => "d.m.Y H:i:s",
		"FILTER_1C_USERS" => "Y",
		"FILTER_NAME" => "users",
		"FILTER_SECTION_CURONLY" => "N",
		"GROUPS" => array(),
		"MAX_DEPTH" => "2",
		"MAX_DEPTH_FIRST" => "0",
		"NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#",
		"NAV_TITLE" => "Сотрудники",
		"PATH_TO_CONPANY_DEPARTMENT" => "/company/structure.php?set_filter_structure=Y&users_UF_DEPARTMENT=#ID#",
		"PM_URL" => "/company/personal/messages/chat/#USER_ID#/",
		"SCHEDULE_LINK" => "",
		"SEARCH_URL" => "search.php",
		"SHOW_ERROR_ON_NULL" => "N",
		"SHOW_FROM_ROOT" => "N",
		"SHOW_LOGIN" => "Y",
		"SHOW_NAV_BOTTOM" => "Y",
		"SHOW_NAV_TOP" => "Y",
		"SHOW_SECTION_INFO" => "Y",
		"SHOW_UNFILTERED_LIST" => "N",
		"SHOW_YEAR" => "Y",
		"USERS_PER_PAGE" => "10",
		"USER_PROPERTY" => array("EMAIL", "PERSONAL_ICQ", "PERSONAL_PHONE", "PERSONAL_MOBILE")
	)
);?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх