Изменить поля записи списка с сохранением остальных

Робот «Изменить поля записи списка с сохранением остальных». Изменяет простые свойства записи, сохраняя прочитанные значения остальных полей.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

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

Что подготовить

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
Тип списка	Выбор из списка	Обязательное; по умолчанию lists
Варианты поля «Тип списка»		lists: Списки; lists_socnet: Списки группы; bitrix_processes: Процессы
ID списка	Целое число	Обязательное; значение по умолчанию не задано
ID записи	Целое число	Обязательное; значение по умолчанию не задано
Правки полей: JSON	Текст	Обязательное; значение по умолчанию не задано
Прежние значения изменяемых полей: JSON	Текст	Обязательное; значение по умолчанию не задано

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Укажите тип и ID списка и ID конкретной записи.
2. Прочитайте текущие значения изменяемых полей и перенесите их в объект ожидания.
3. Для замены названия задайте правки {"NAME":{"mode":"replace","value":"Новое учебное название"}} и ожидание {"NAME":"Прежнее учебное название"}.
4. Для множественных свойств доступны add и remove; для полной замены используйте replace.
5. После выполнения используйте подтверждённые значения и список изменённых полей; при конфликте сначала перечитайте запись.

Учебный пример и ожидаемый результат

Простая запись 700 списка 50 называлась «Учебный черновик». Ожидание содержит это название, правка заменяет его на «Учебная заявка». При допустимой структуре записи и совпадающем ожидании изменится название, остальные поддерживаемые значения сохранятся. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• ID записи: целое число.
• Подтверждённые значения: JSON: текст.
• Изменённые поля: строка, список.
• Запись изменена: да/нет (Y/N).

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

Поддерживаются NAME и обычные строковые, числовые и списочные свойства. Записи с файлами, нестандартными/закрытыми полями, неполными данными, разделом, кодом или дополнительными системными данными отклоняются до записи. Проверка не блокирует одновременную внешнюю правку.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

Правки полей: JSON

{
  "NAME": {
    "mode": "replace",
    "value": "Учебная заявка"
  }
}

Объект правок по реальным кодам полей. В каждой правке обязательны mode и value. Режим replace заменяет значение, add и remove допустимы для множественных свойств. В примере строковое NAME заменяется новой строкой. Тип value берите из описания поля списка: строка, число, ID варианта либо набор для множественного поля. Пустой {} не задаёт действие, массив [] неверен.

Прежние значения изменяемых полей: JSON

{
  "NAME": "Учебный черновик"
}

Объект фактических прежних значений тех же полей, что в правках. Пример соответствует смене названия с «Учебный черновик» на «Учебная заявка». Для свойств копируйте всю прочитанную структуру, а не только подпись видимого варианта. Нужны актуальные данные этой записи. {} не соответствует непустым правкам, [] неверен. Конфликт ожидания требует повторного чтения перед новой согласованной правкой.