Получить варианты поля универсального списка
Робот «Получить варианты поля универсального списка». Возвращает ID и подписи вариантов списка и проверяет выбранные значения.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для администратора, который сопоставляет подписи справочника с вариантами списочного поля. Помогает не передать в запись произвольный текст вместо ID допустимого варианта и обнаружить одинаковые подписи.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| Тип списка | Выбор из списка | Обязательное; по умолчанию lists |
| Варианты поля «Тип списка» | lists: Списки; lists_socnet: Списки группы; bitrix_processes: Процессы |
|
| ID списка | Целое число | Обязательное; значение по умолчанию не задано |
| Код поля PROPERTY_номер | Строка | Обязательное; значение по умолчанию не задано |
| Выбранные ID: JSON | Текст | Необязательное; по умолчанию [] |
| Выбранные подписи: JSON | Текст | Необязательное; по умолчанию [] |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите тип и ID списка, затем точный код списочного свойства, например
PROPERTY_123. - Чтобы получить все варианты, оставьте массивы выбранных ID и подписей пустыми.
- Для проверки заранее известных ID передайте массив строк с идентификаторами вариантов.
- Для поиска по подписям передайте точные названия, например
["Согласовано"]. - Перед записью в справочник обработайте неизвестные и неоднозначные подписи. Используйте найденный вариант только при однозначном соответствии.
Учебный пример и ожидаемый результат
В свойстве PROPERTY_123 списка 50 есть вариант «Согласовано». Передайте подписи ["Согласовано"]. Ожидается соответствующий вариант среди найденных выбранных. Если такая подпись повторяется, робот сообщает неоднозначность, а не выбирает первый. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- Поле найдено: да/нет (Y/N).
- Все варианты: JSON: текст.
- Найденные выбранные варианты: JSON: текст.
- Неизвестные ID: строка, список.
- Неизвестные подписи: строка, список.
- Неоднозначные подписи: строка, список.
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Отсутствующее поле даёт отрицательный признак «Поле найдено». Поле другого типа или отказ доступа: ошибка. Подписи сравниваются точно; действие не меняет варианты поля и значения записей.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.
Как заполнять JSON-поля
Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.
Выбранные ID: JSON
[
"10",
"11"
]
Массив строковых ID вариантов конкретного поля, а не ID записей списка. Числа 10 и 11 в примере нужно заменить фактическими вариантами из результата получения всех вариантов. [] отключает выбор по ID и используется по умолчанию. Объект {} неверен. Неизвестные ID возвращаются отдельно.
Выбранные подписи: JSON
[
"Согласовано"
]
Массив точных строковых подписей вариантов, с тем регистром и написанием, которые заданы в поле. Подпись в примере должна существовать в вашем списке. [] отключает выбор по подписям и используется по умолчанию; {} неверен. Если подпись повторяется, вариант не угадывается и попадает в неоднозначные.