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..." ] ] } }