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