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

crm.lead.userfield.update

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

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


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Кирилл Косачев
Сообщение не промодерировано, возможны ошибки и неточности.
В доке ошибка?  параметр LIST должен находиться внутри параметра fields.
Спасибо Andrei Nikolaev  из телеграм-чата разработчиков б24, подсказал, почему у меня не работало обновление поля  
0
Андрей Николаев
Сообщение не промодерировано, возможны ошибки и неточности.
В указанных в документации параметрах есть ошибка!

Метод  crm.lead.userfield.update принимает всего 2 параметра: id и fields

Поле LIST, которое указано как параметр, нужно передавать внутри fields наряду с EDIT_FORM_LABEL и LIST_COLUMN_LABEL в указанном в документации примере
© «Битрикс», 2001-2024, «1С-Битрикс», 2024