Получить элемент массива по позиции
Робот «Получить элемент массива по позиции» возвращает одно значение из списка, чтобы использовать его в следующем действии.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM и автору процесса, которому нужно взять одно значение из подготовленного списка: первый вариант поставки, выбранный номер или элемент результата другого действия.
Когда список приходит целиком, ручная подстановка позиции легко приводит к смещению. У этого робота нумерация начинается с единицы. Он отдельно сообщает, существует ли позиция, чтобы пустое значение не потерялось среди ошибок.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Массив в JSON, например [1,2,3] (ARRAY) |
Обязательное поле |
Позиция, начиная с 1 (POSITION) |
Обязательное поле. по умолчанию 1 |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Добавьте робота после шага, который формирует JSON-массив. Передайте именно массив, например
[10,20], а не строку с числами через запятую без скобок. - Укажите позицию от 1. Значение по умолчанию 1 выбирает первый элемент; нулевой и отрицательный номера не подходят.
- После выполнения проверьте статус и «Значение найдено». При отсутствии позиции направьте процесс по ветке без результата.
- Используйте значение вместе с его типом. Строковый результат остаётся JSON-строкой с кавычками, если следующему шагу нужен JSON.
Как заполнить JSON-поля
Массив в JSON, например [1,2,3] (ARRAY)
[
10,
null,
30
]
Элементы могут иметь разные JSON-типы. Список подготовьте предыдущим шагом. Пустой список допустим: выбранная позиция не будет найдена.
Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.
Учебный пример и ожидаемый результат
Передайте ARRAY=[10,null,30], POSITION=2. Ожидается найденное значение null, признак «Значение найдено» включён. При позиции 4 значение отсутствует: признак найденного значения выключен. Это разные ситуации, хотя пустое значение может выглядеть похоже.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Значение в JSON» (
value). - «Тип значения» (
value_type). - «Значение найдено» (
found).
«Тип значения» помогает отличить число, строку, объект и null. Признак найденного значения проверяйте раньше самого содержимого. Для маршрута, где важен именно непустой текст, после проверки наличия добавьте отдельную проверку содержимого.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Позиции начинаются с 1. За пределами массива возвращается «найдено: нет». Значение null считается найденным. Размер входного JSON: до 1 МБ, массива: до 10000 элементов, вложенность: до 64 уровней.
Если на вход пришёл объект вместо массива, исправьте источник. Номер позиции нельзя переносить без изменений из пути JSON: в путях индексы начинаются с нуля, а в этом роботе с единицы. Он не удаляет элемент из исходного списка и не меняет поля карточки.