CRM роботы 2.0 + AI (300+ роботов)

Удалить запись списка после проверки полей

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

Настройки робота «Удалить запись списка после проверки полей» в Битрикс24

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

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

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

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

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

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

Поле в настройке Тип Обязательность и исходное значение
Тип списка Строка Обязательное; значение по умолчанию не задано
ID списка Целое число Обязательное; значение по умолчанию не задано
ID записи Целое число Обязательное; значение по умолчанию не задано
Только план: Y/N Да/нет (Y/N) Обязательное; значение по умолчанию не задано
Ожидаемые поля (JSON) Текст Обязательное; значение по умолчанию не задано

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

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

  1. Укажите тип списка, ID списка и ID конкретной записи.
  2. Начните с режима «Только план» = Y. Передайте ожидаемые поля объектом JSON, от 1 до 20 полей.
  3. Изучите проверенный план. Для настоящего удаления обязательно задайте ожидания NAME и CODE с их текущими значениями.
  4. Проверьте зависимости записи в других процессах самостоятельно. Только после согласования настройте N в режиме плана.
  5. Продолжайте ветку удаления только после результата «Удаление подтверждено», а не по одному факту успешной подготовки плана.

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

Для записи 700 списка 50 задано ожидание {"NAME":"Учебная запись","CODE":"training-700"}. При Y робот только проверяет поля и возвращает план. При отдельном согласованном запуске с N и совпадающими значениями запрашивается удаление именно записи 700. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

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

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

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

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

План ничего не удаляет. Нативная структура значений сравнивается целиком; null отличается от отсутствующего поля. Отсутствующая запись и неизвестный результат: ошибка, а не подтверждение прежнего удаления. Внешняя правка между проверкой и удалением не блокируется; зависимости робот не анализирует.

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

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

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

Ожидаемые поля (JSON)

{
  "NAME": "Учебная запись",
  "CODE": "training-700"
}

Объект от 1 до 20 ожидаемых полей записи. Для реального удаления обязательны NAME и CODE, оба с текущими значениями. Допустимы также ACTIVE и реальные PROPERTY_номер. Значения копируйте из актуального чтения записи целиком, сохраняя нативную структуру; null отличается от отсутствующего поля. Пример подходит записи с указанными названием и кодом. Пустой {} и массив [] не задают допустимые ожидания.