Соединить два массива по позициям

Робот «Соединить два массива по позициям» собирает пары из двух согласованных списков, например идентификаторы и количества.

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

Для кого и какую задачу решает

Администратору CRM, который получает два параллельных списка: идентификаторы товаров и количества, имена полей и значения либо коды и подписи.

Ручное соединение списков по позиции опасно, если длины различаются. Робот создаёт массив объектов только при одинаковой длине входов. Он сохраняет пары целиком и не обрезает длинный список молча.

Параметры и подготовка

Поле	Как заполнить
Первый массив в JSON (ARRAY)	Обязательное поле
Второй массив в JSON (SECOND_ARRAY)	Обязательное поле
Название первого столбца (FIRST_KEY)	Обязательное поле. по умолчанию id
Название второго столбца (SECOND_KEY)	Обязательное поле. по умолчанию value

Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.

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

1. Передайте связанные значения в первый и второй JSON-массивы. До настройки убедитесь, что элементы с одинаковым номером действительно относятся друг к другу.
2. Укажите разные названия столбцов. По умолчанию используются id и value; каждое название должно быть непустым и не длиннее 100 символов.
3. Не сортируйте один список отдельно перед соединением: это разрушит соответствие позиций. Если нужна сортировка, подготовьте согласованные данные заранее.
4. После успешного статуса используйте массив объектов в следующем шаге. При ошибке длины исправьте источник, а не убирайте элементы вручную без проверки.

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

Первый массив в JSON (ARRAY)

[
  10,
  20
]

Первый список, например ID из предыдущего отбора. Порядок должен соответствовать второму списку.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Второй массив в JSON (SECOND_ARRAY)

[
  2,
  3
]

Второй список, например количества. Длина обязана совпасть с первым. Два пустых массива допустимы.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

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

Первый массив [10,20], второй [2,3], имена столбцов id и qty. Ожидается [{"id":10,"qty":2},{"id":20,"qty":3}], количество 2. Если второй список содержит только [2], робот сообщит об ошибке и не выдаст частично обрезанный набор.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Итоговый массив в JSON» (result).
• «Количество элементов» (count).

Каждый объект результата содержит ровно два выбранных поля. Типы исходных значений сохраняются. Количество показывает число сформированных пар; два пустых массива дают пустой список пар.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Для [10,20], [2,3] и имён id,qty вернёт [{"id":10,"qty":2},{"id":20,"qty":3}]. Длины должны совпадать. Размер входного JSON: до 1 МБ, массива: до 10000 элементов, вложенность: до 64 уровней.

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