Прочитать поля записи универсального списка

Робот «Прочитать поля записи универсального списка». Возвращает выбранные поля одной записи справочника по её ID.

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

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

Для координатора процесса, которому нужны значения одной уже найденной записи справочника. Позволяет взять только нужные поля вместо ручного переноса сведений из универсального списка в CRM.

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

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

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

Поле в настройке	Тип	Обязательность и исходное значение
Тип списка	Выбор из списка	Обязательное; по умолчанию lists
Варианты поля «Тип списка»		lists: Универсальные списки; lists_socnet: Списки группы; bitrix_processes: Процессы
ID списка	Целое число	Обязательное; значение по умолчанию не задано
ID записи	Целое число	Обязательное; значение по умолчанию не задано
Коды полей (JSON-массив)	Текст	Обязательное; значение по умолчанию не задано

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

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

1. Укажите тип списка, ID списка и ID записи.
2. Передайте массив кодов полей, например ["NAME","PROPERTY_123"]; всего до 100 полей.
3. Проверьте результат «Доступная запись найдена» перед использованием значений.
4. Разберите возвращённый JSON по нужным кодам. Структура значений сохраняется, поэтому множественное свойство не следует считать простой строкой.
5. Проверьте список полей, не переданных в ответе, и отдельно обработайте их отсутствие.

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

Для записи 700 списка 50 запрошены ["NAME","CODE"]. При доступной записи ожидается JSON с этими значениями. Если записи нет в успешном ответе поиска, признак нахождения будет отрицательным. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

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

• Доступная запись найдена: да/нет (Y/N).
• ID найденной записи: целое число.
• Значения полей в формате JSON: строка.
• Поля, не переданные в ответе: строка, список.

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

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

Поддерживаются NAME, CODE, ACTIVE, PREVIEW_TEXT, DETAIL_TEXT и PROPERTY_номер. Пустой поиск допустим, но отказ по правам является ошибкой. Файловое свойство возвращается как сведения свойства: содержимое файла не скачивается.

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

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

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

Коды полей (JSON-массив)

[
  "NAME",
  "CODE",
  "PROPERTY_123"
]

Массив до 100 кодов полей. Системные имена: NAME, CODE, ACTIVE, PREVIEW_TEXT, DETAIL_TEXT; свойства задаются реальным PROPERTY_номер. Замените PROPERTY_123 кодом вашего списка или уберите его. Пустой [] задаёт пустой набор выбранных полей; {} неверен. Для множественного свойства результат может быть сложной структурой, не строкой.