Изменить существующие пункты чек-листа

Робот «Изменить существующие пункты чек-листа». Меняет названия, порядок, иерархию и отметки готовности существующих пунктов.

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

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

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

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

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

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

Поле в настройке	Тип	Обязательность и исходное значение
ID задачи	Целое число	Обязательное; значение по умолчанию не задано
Изменения и прежние значения: JSON	Текст	Обязательное; значение по умолчанию не задано

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

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

1. Укажите ID задачи с нужным чек-листом.
2. Подготовьте массив изменений до 50 объектов. У каждого задайте id, новые значения fields и прежние значения этих же полей expected.
3. Например, для отметки готовности используйте [{"id":510,"fields":{"IS_COMPLETE":"Y"},"expected":{"IS_COMPLETE":"N"}}].
4. При изменении родителей проверьте иерархию: нельзя создавать цикл. Для порядка используйте SORT_INDEX, для названия: TITLE, для важности: IS_IMPORTANT.
5. Продолжайте зависимый этап только при положительном результате «Все изменения подтверждены». При частичном результате сверяйте итог каждого пункта.

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

Пункт 510 не завершён. Передача изменения IS_COMPLETE из N в Y при совпадающем ожидании должна вернуть его в подтверждённых изменениях. Если пункт уже готов, он может попасть в уже совпадающие, без повторной записи. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

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

• Подтверждённые изменения: целое число, список.
• Уже совпадающие пункты: целое число, список.
• Неподтверждённые ID: целое число, список.
• Итог каждого пункта: JSON: текст.
• Все изменения подтверждены: да/нет (Y/N).

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

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

Поддерживаются только TITLE, SORT_INDEX, PARENT_ID, IS_COMPLETE, IS_IMPORTANT. Участники и файлы не меняются. Частичный результат означает ошибку; прежние успешные правки могут остаться. Одновременное редактирование не блокируется.

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

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

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

Изменения и прежние значения: JSON

[
  {
    "id": 510,
    "fields": {
      "TITLE": "Проверить комплект",
      "IS_COMPLETE": "Y"
    },
    "expected": {
      "TITLE": "Проверить черновик",
      "IS_COMPLETE": "N"
    }
  }
]

Массив до 50 изменений существующих пунктов. В объекте обязательны числовой положительный id, объект новых fields и объект прежних expected с теми же кодами полей. Поддерживаются TITLE строкой, SORT_INDEX и PARENT_ID целыми числами, IS_COMPLETE и IS_IMPORTANT значениями Y/N. В примере меняются название и готовность пункта 510. ID и прежние значения берите из актуального чек-листа именно указанной задачи. [] не задаёт правку, {} вместо массива неверен. Родитель 0 обозначает корень; изменение иерархии не должно образовывать цикл.