Изменить элемент процессса rpa.item.update

Scope: rpa

Кто может выполнять метод: любой пользователь

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

Параметры методаПараметры метода

Обязательные параметры отмечены *

Название тип	Описание
typeId integer	Идентификатор процесса
id integer	Идентификатор элемента
fields* object	Объект со значениями пользовательских полей элемента

Параметр fieldsПараметр fields

Название тип	Описание
stageId integer	Идентификатор стадии
UF_RPA_... any	Значения пользовательских полей. Формат передачи значений зависит от типа поля

Примеры кодаПримеры кода

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

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

   JS

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

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

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

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

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

   JS

   {
               "fields": {
                   "UF_RPA_1_1585069397": {
                       "id": 433    
                   }
               }
           }
           

   Важно

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

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

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

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

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

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

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

   JS

   {
               "fields": {
                   "UF_RPA_1_1585069397": [
                       {
                           "id": 12
                       },
                       {
                           "id": 44
                       },
                       [
                           "myNewFile.pdf",
                           "...base64_encoded_file_content..."
                       ]
                   ]
               }
           }
           

Продолжите изучениеПродолжите изучение

• Элементы: обзор методов
• Добавить элемент процесса rpa.item.add
• Получить информацию об элементе rpa.item.get
• Получить данные о текущих заданиях элемента rpa.item.getTasks
• Получить массив элементов процесса rpa.item.list
• Удалить элемент rpa.item.delete