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