Добавить чек-лист с пунктами в задачу
Робот «Добавить чек-лист с пунктами в задачу». Создаёт в задаче новый чек-лист из указанного названия и перечня работ.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для координатора типовых работ, руководителя отдела и администратора CRM. Помогает не забыть обязательные действия: вместо ручного набора одинакового перечня новая задача получает чек-лист подготовки, проверки или сдачи.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID задачи | Целое число | Обязательное; значение по умолчанию не задано |
| Название чек-листа | Строка | Обязательное; значение по умолчанию не задано |
| Пункты, по одному на строку | Текст | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID существующей задачи, в которую нужно добавить перечень. Если задача создана предыдущим шагом, используйте его результат.
- Задайте понятное название группы, например «Подготовка к сдаче».
- Введите пункты по одному на строку: «Проверить комплект», затем с новой строки «Передать на приёмку». Не вставляйте JSON вместо строк.
- Проверьте, что строк от 1 до 100, каждая непустая и не длиннее 200 символов. Сохраните настройку.
- Передайте ID созданного заголовка в последующую проверку чек-листа, если нужно контролировать только эту группу.
Учебный пример и ожидаемый результат
В задачу 410 добавляются группа «Приёмка» и две строки «Сверить состав» / «Получить подтверждение». При успехе возвращаются ID заголовка, два ID пунктов и количество 2. Пункты создаются незавершёнными. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID заголовка: целое число.
- Подтверждённые ID пунктов: целое число, список.
- Создано пунктов: целое число.
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Каждый запуск создаёт новый чек-лист. Защиты по ключу операции здесь нет: повтор после возврата сделки на этап создаст ещё одну группу. После частичной ошибки часть пунктов могла сохраниться; проверьте задачу и подтверждённые ID перед повтором.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.