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

task.item.userfield.add

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

Метод создает новое свойство.

Системное ограничение на название поля - 20 знаков. К названию пользовательского поля всегда добавляется префикс UF_TASK_, то есть реальная длина названия - 12 знаков.

Параметры метода

ПараметрОписание
authТокен авторизации.
PARAMSМассив с параметрами свойства вида array("параметр": 'значение' [, ...]), содержащий следующие параметры:
  • USER_TYPE_ID - тип данных пользовательского поля. Допустимые значения:
    • string (Строка);
    • double (Число);
    • date (Дата);
    • boolean (Да/Нет);
  • FIELD_NAME - код поля;
  • XML_ID - внешний код;
  • EDIT_FORM_LABEL - подпись в форме форматирования (указывается на английском ('en') и русском ('ru") языках;
  • LABEL - заголовок поля.

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

$appParams = array(
	'auth' => 'q21g8vhcqmxdrbhqlbd2wh6ev1debppa',
	'PARAMS' => array(
		'USER_TYPE_ID' => 'string',
		'FIELD_NAME' => 'NEW_TASKS_FIELD',
		'XML_ID' => 'MY_TASK_FIELD',
		'EDIT_FORM_LABEL' => array(
			'en' => 'New task field',
			'ru' => 'Новое поле задач'
		),
		'LABEL' => 'New task field'
	 ),
);
$request = 'http://your-domain.ru/rest/task.item.userfield.add.xml?'.http_build_query($appParams);'

BX24.callMethod(
	'task.item.userfield.add',
	{
		PARAMS:
		{
			'USER_TYPE_ID' : 'string',
			'FIELD_NAME' : 'NEW_TASKS_FIELD',
			'XML_ID' : 'MY_TASK_FIELD',
			'EDIT_FORM_LABEL' : {'en':'New task field', 'ru':'Новое поле задач'},
			'LABEL' : 'New task field'
		}
	},
	function(result)
	{
		console.info(result.data());
		console.log(result);
	}
);

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

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

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

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

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