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

crm.contact.userfield.update

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

crm.contact.userfield.update(id, fields)

Обновляет существующее пользовательское поле контактов.

Параметры

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

Пример

var id = prompt("Введите ID");
var label = prompt("Введите новое название");
BX24.callMethod(
	"crm.contact.userfield.update", 
	{ 
		id: id,
		fields: 
		{
			"EDIT_FORM_LABEL": label,
			"LIST_COLUMN_LABEL": label
		}
	}, 
	function(result) 
	{
		if(result.error())
			console.error(result.error());
		else
		{
			console.dir(result.data()); 			
			if(result.more())
				result.next();						
		}
	}
);



© «Битрикс», 2001-2024, «1С-Битрикс», 2024