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

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