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

crm.deal.userfield.update

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

crm.deal.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.deal.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();						
		}
	}
);



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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
2
Антон Захаров
Сообщение не промодерировано, возможны ошибки и неточности.
При применении параметра LIST его следует размещать внутри массива fields
Код
$res = CRest::call('crm.deal.userfield.update', [
            'ID'=>'311', 'fields'=>['LIST'=>[
                ['SORT'=>140, 'VALUE'=>'Другое', 'DEF'=>'N']
                ] ]
            ] );
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх