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

crm.item.update

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

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

crm.item.update({entityTypeId: number, id: number, fields: {})

Метод обновит элемент с идентификатором id смарт-процесса с идентификатором entityTypeId.

При обновлении элемента производится стандартный ряд проверок, модификаций и автоматических действий:

  • проверяются права доступа;
  • проверяется заполненность обязательных полей, если изменена стадия элемента в рамках того же направления;
  • проверяется заполненность зависимых от стадий обязательных полей, если изменена стадия элемента в рамках того же направления;
  • проверяется корректность заполнения полей;
  • полям присваиваются значения по умолчанию;
  • если перед сохранением оказывается, что никакие значения полей не были изменены, то сохранение не производится;
  • после сохранения запускаются роботы.

Метод вернет результат аналогичный вызову метода crm.item.get для обновленного элемента.

Параметры

Параметр Описание
entityTypeIdИдентификатор смарт-процесса.
idИдентификатор элемента.
fieldsЗначение полей элемента.

Загрузить новый файл вместо старого (не множественное поле)

Чтобы заменить файл в не множественном поле, просто загрузите новый файл. Старый будет удален автоматически.

{
	"fields": {
		"ufCrm1617027453943": [
			"myfile.pdf", 
			"...base64_encoded_file_content..."
		]
	}
}

Удалить значение пользовательского поля типа файл



Для этого достаточно передать пустую строку ('') вместо значения

Оставить значение не множественного поля типа файл без изменений

Самый простой вариант - не добавлять в fields ключ с этим полем. Но если надо и передать, и не изменить, то в качестве значения надо передать список, где по ключу id будет идентификатор файла

{
	"fields": {
		"ufCrm1617027453943": {
			"id": 433
		}
	}
}

Если в id передать отличное от текущего значения, то значение поля обнулится и файл будет стёрт.

Работа с множественным полем типа файл

Значение множественного поля - это массив. Каждый элемент массива подчиняется тем же правилам, что и для не множественных значений.

Частичная перезапись значения множественного поля типа файл

Например, сейчас в множественном поле типа файл находится значение [12, 255, 44].

Необходимо оставить файлы 12 и 44, а вместо 255 загрузить новый

Запрос должен выглядеть следующим образом:

{
	"fields": {
		"ufCrm1617027453943": [
			{
				"id": 12
			},
			{
				"id": 44
			},
			[
				"myNewFile.pdf", 
				"...base64_encoded_file_content..."
			]
		]
	}
}
© «Битрикс», 2001-2024, «1С-Битрикс», 2024