user.userfield.add

Scope: user.userfield Права на выполнение: для всех

Метод добавляет пользовательское поле

Параметры

Параметр	Описание	С версии
USER_TYPE_ID	Тип пользовательского поля. Возможны значения: `string` - строка; `integer` - целое число; `double` - число; `date` - дата; `datetime` - дата со временем; `boolean` - Да / Нет; `file` - файл; `enumeration` - список; `url` - ссылка; `address` - адрес Google карты; `money` - деньги; `iblock_section` - Привязка к разделу инфоблока; `iblock_element` - Привязка к элементу инфоблока; `employee` - Привязка к пользователю; `crm` - Привязка к элементу CRM; `crm_status` - Привязка к справочнику CRM. У некоторых типов есть свои дополнительные настройки.

Пример

CRest::call(
	'user.userfield.add',
	[
		'fields' => [
			'FIELD_NAME' => 'MY_TEST_FIELD_STR3',
			'USER_TYPE_ID' => 'string',
			'XML_ID' => 'MY_TEST_FIELD_STR_xml',
			'MULTIPLE' => 'Y',
			'SHOW_FILTER' => 'Y',
			'SORT' => 100,
			'LIST_FILTER_LABEL' => 'Title',
			'LIST_COLUMN_LABEL' => 'List Title',
			'EDIT_FORM_LABEL' => 'Title',
			'ERROR_MESSAGE' => 'Title',
			'HELP_MESSAGE' => 'Title',
			'SETTINGS' => [
				'DEFAULT_VALUE' => 'value'
			]
		],
	]
);

Вместо
'LIST_FILTER_LABEL', 'LIST_COLUMN_LABEL', 'EDIT_FORM_LABEL', 'ERROR_MESSAGE', 'HELP_MESSAGE',
можно указать ключ 'LABEL', который заполнит все указанные выше ключи.

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

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

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

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

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

aazizov 12.10.2021 13:09:48

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

Код

CRest::call('user.userfield.add',
        [
           'fields' => [
              'FIELD_NAME' => 'TEST_USER_FIELD_NAME',
              'USER_TYPE_ID' => 'enumeration',
              'XML_ID' => 'MY_TEST_FIELD_STR_xml',
              'MULTIPLE' => 'N',
              'SHOW_FILTER' => 'Y',
              'LIST' => [
                          
                       ['KEY1' => 'VALUE1'],
                       ['KEY2' => 'VALUE2']

                    ],
              'SORT' => 100,
              'LABEL' => 'Test field',
           ],
        ]);