main.user.selector

Описание

Компонент main.user.selector представляет собой готовый к встраиванию в форму контрол для выбора сущностей различных типов.

В физической структуре его можно найти в папке /bitrix/components/bitrix/main.user.selector.

Параметры

Параметр	Описание
ID	Уникальный ID селектора (тип значения - строка).
API_VERSION	Версия API селектора (тип значения - число: по умолчанию - 2, поддерживается также 3 - с сохранением выбранной сущности в "Последних" сразу после ее выбора).
LIST	Массив кодов сущностей, подставляемых в качестве уже выбранных. Например: `[ 'U1', 'SG2', 'DR3' ]`.
INPUT_NAME	Имя поля формы, в котором будет передано выбранное значение (значения). Для того, чтобы использовать множественный выбор, применяйте значение вида `FIELD[ ]`.
USE_SYMBOLIC_ID	Принимает значение true или false. Использовать символьный код сущности вместо числового. По умолчанию - false, но если вы планируете выбирать сущности разных типов - используйте true.
BUTTON_SELECT_CAPTION	Языковое сообщение для элемента управления, открывающего селектор, если не выбран ни один элемент (по умолчанию - "выбрать").
BUTTON_SELECT_CAPTION_MORE	Языковое сообщение для элемента управления, открывающего селектор, если выбран хотя бы один элемент (по умолчанию - "выбрать").
OPEN_DIALOG_WHEN_INIT	Открывать ли попап селектора сразу после инициализации контрола (а не по клику на него). Принимает значение true или false. По умолчанию false.
UNDELETABLE	Массив кодов сущностей, которые должны отображаться в селекторе без возможности удаления.
LAZYLOAD	Откладывать ли загрузку данных в селектор (при пустом значении параметра LIST) до открытия селектора. Принимает значения Y/N. По умолчанию - N, т.е. загружать данные сразу.
SELECTOR_OPTIONS	Набор опций для передачи в контрол-попап выбора.

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

// давать ли возможность выбора сущности "Всем сотрудникам" (с кодом UA)
<?
$APPLICATION->IncludeComponent(
'bitrix:main.user.selector',
' ',
[
	"ID" => "mail_client_config_queue",
	"API_VERSION" => 3,
	"LIST" => array_keys($crmQueueSelected),
	"INPUT_NAME" => "fields[crm_queue][]",
	"USE_SYMBOLIC_ID" => true,
	"BUTTON_SELECT_CAPTION" => Loc::getMessage("MAIL_CLIENT_CONFIG_CRM_QUEUE_ADD"),
	"SELECTOR_OPTIONS" => 
	[
		"departmentSelectDisable" => "Y",
		'context' => 'MAIL_CLIENT_CONFIG_QUEUE',
		'contextCode' => 'U',
		'enableAll' => 'N',
		'userSearchArea' => 'I'
	]
]
);
?>

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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Сергей Абакаев 12.12.2023 11:45:14

Сообщение не промодерировано, возможны ошибки и неточности.

Цитата

пишет:
CRM сущности в LIST передаются в таком виде: [CODE] 'LIST' => [ 'CRMCOMPANY1' => 'companies' , 'CRMCONTACT1' => 'contacts' ],
'CONVERT_TO_SYMBOLIC_ID' => 'N' ,
Копировать [/CODE] либо в таком: [CODE] 'LIST' => [ 'CO_1' => 'companies' , 'C_1' => 'contacts' ],
'CONVERT_TO_SYMBOLIC_ID' => 'N' ,
//с указанием в SELECTOR_OPTIONS
'crmPrefixType' => 'SHORT'
Копировать [/CODE] UNDELETABLE: [CODE] 'UNDELETABLE' => [ 'CRMCOMPANY1' , 'CRMCONTACT1' ],
//или
'UNDELETABLE' => [ 'CO_1' , 'C_1' ], Копировать [/CODE] из js выбранные элементы можно узнать через: [CODE] BX .UI .SelectorManager .instances [selectorId] .itemsSelected
Копировать [/CODE]

код BX.UI.SelectorManager.instances уже не работает на коробке

ononoki 24.09.2021 04:54:44

Сообщение не промодерировано, возможны ошибки и неточности.

CRM сущности в LIST передаются в таком виде:

Код
'LIST' => ['CRMCOMPANY1' => 'companies', 'CRMCONTACT1' => 'contacts'], 'CONVERT_TO_SYMBOLIC_ID' => 'N',

либо в таком:

Код
'LIST' => ['CO_1' => 'companies', 'C_1' => 'contacts'], 'CONVERT_TO_SYMBOLIC_ID' => 'N', //с указанием в SELECTOR_OPTIONS 'crmPrefixType' => 'SHORT'

UNDELETABLE:

Код
'UNDELETABLE' => ['CRMCOMPANY1', 'CRMCONTACT1'], //или 'UNDELETABLE' => ['CO_1', 'C_1'],

из js выбранные элементы можно узнать через:

Код
BX.UI.SelectorManager.instances[selectorId].itemsSelected

Наверх