Прочитать выбранные поля реквизита
Робот «Прочитать выбранные поля реквизита» возвращает значения указанных полей одного реквизита по его ID.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM и автору шаблонов документов, которому нужно прочитать выбранные поля одного реквизита, включая доступные пользовательские.
Передача всей карточки усложняет подготовку документа и скрывает различие пустого значения и неполного ответа. Робот возвращает только запрошенные поля и отдельно перечисляет те, которые не были переданы источником.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID реквизита (REQUISITE_ID) |
Обязательное поле |
Коды полей (JSON-массив) (FIELDS) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Получите REQUISITE_ID от предыдущего выбора реквизитов или из настроек конкретного реквизита клиента.
- В FIELDS передайте 1–50 разных кодов JSON-массивом. Используйте точные коды доступных полей, а не подписи формы.
- После статуса проверьте missing. Отсутствующий ключ нельзя автоматически считать пустой строкой для документа.
- Передайте объект fields в разбор JSON или следующий шаг шаблона. Сохраняйте строковые номера с ведущими нулями; не преобразуйте их в числа.
Как заполнить JSON-поля
Коды полей (JSON-массив) (FIELDS)
[
"RQ_INN",
"RQ_KPP"
]
От 1 до 50 разных кодов доступных стандартных или пользовательских полей. Это имена, а не ID и не подписи формы. [] запрещён.
Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.
Учебный пример и ожидаемый результат
REQUISITE_ID=81, FIELDS=["RQ_INN","RQ_KPP"]. Если в учебных данных оба поля переданы, объект fields содержит их точные значения. Явный null сохраняется как null. Если RQ_KPP отсутствует в ответе, оно перечисляется в missing и не подменяется придуманным пустым значением.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID реквизита» (
requisiteId). - «Значения полей в JSON» (
fields). - «Поля, не переданные в ответе» (
missing), список значений.
Выход requisiteId подтверждает, к какому реквизиту относятся данные. JSON fields может содержать разные типы значений; используйте конкретный путь к нужному коду. Пустой missing означает, что все запрошенные поля присутствовали в ответе, но не гарантирует их заполненность.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Принимает ID реквизита и JSON-массив из 1–50 кодов доступных полей, включая пользовательские. Возвращает JSON значений и отдельный список полей, не переданных в ответе. Явный null сохраняется как null; строковые номера сохраняют ведущие нули. Неизвестный код поля, недоступный реквизит или его владелец являются ошибкой. Ничего не меняет.
Неизвестный код поля, недоступный реквизит или его владелец приводят к ошибке. Для проверки обязательного заполнения используйте отдельную проверку комплектности. Чтение ничего не меняет и не делает реквизит выбранным в документе.