crm.requisite.userfield.add

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

crm.requisite.userfield.add(fields)

Создаёт новое пользовательское поле для реквизита.

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

Параметры

Параметр Описание

fields Набор полей - массив вида array("поле"=>"значение"[, ...]), содержащий описание пользовательского поля. Полное описание полей можно получить вызовом метода crm.userfield.fields.

LIST

Параметр	Описание
fields	Набор полей - массив вида array("поле"=>"значение"[, ...]), содержащий описание пользовательского поля. Полное описание полей можно получить вызовом метода crm.userfield.fields.
LIST	Содержит набор значений списка для пользовательских полей типа Список. Указывается при создании/обновлении поля. Каждое значение представляет собой массив с полями: VALUE - значение элемента списка. Поле является обязательным в случае, когда создается новый элемент. SORT - сортировка. DEF - если равно Y, то элемент списка является значением по-умолчанию. Для множественного поля допустимо несколько DEF=Y. Для не множественного, дефолтным будет считаться первое. XML_ID - внешний код значения. Параметр учитывается только при обновлении уже существующих значений элемента списка. ID - идентификатор значения. Если он указан, то считается что это обновление существующего значения элемента списка, а не создание нового. Имеет смысл только при вызове методов `.userfield.update`. DEL* - если равно Y, то существующий элемент списка будет удален. Применяется, если заполнен параметр ID.

Содержит набор значений списка для пользовательских полей типа Список. Указывается при создании/обновлении поля. Каждое значение представляет собой массив с полями:

VALUE - значение элемента списка. Поле является обязательным в случае, когда создается новый элемент.
SORT - сортировка.
DEF - если равно Y, то элемент списка является значением по-умолчанию. Для множественного поля допустимо несколько DEF=Y. Для не множественного, дефолтным будет считаться первое.
XML_ID - внешний код значения. Параметр учитывается только при обновлении уже существующих значений элемента списка.
ID - идентификатор значения. Если он указан, то считается что это обновление существующего значения элемента списка, а не создание нового. Имеет смысл только при вызове методов *.userfield.update.
DEL - если равно Y, то существующий элемент списка будет удален. Применяется, если заполнен параметр ID.

Пример

BX24.callMethod(
	"crm.requisite.userfield.add",
	{
		fields:
		{
			"ENTITY_ID": "CRM_REQUISITE",
			"FIELD_NAME": "MY_STRING",
			"EDIT_FORM_LABEL": "Моя строка",
			"USER_TYPE_ID": "string",
			"XML_ID": "MY_STRING",
			"SETTINGS": { "DEFAULT_VALUE": "Привет, мир!" }
		}
	},
	function(result)
	{
		if(result.error())
			console.error(result.error());
		else
			console.dir(result.data());
	}
);