Вычесть один массив из другого

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

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

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

Автору процесса повторной обработки, которому нужно исключить уже обработанные идентификаторы из нового списка.

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

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

Поле	Как заполнить
Первый массив в JSON (ARRAY)	Обязательное поле
Второй массив в JSON (SECOND_ARRAY)	Обязательное поле

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

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

1. Передайте список кандидатов в первый массив, список исключений во второй. Оба значения должны быть корректными JSON-массивами.
2. Согласуйте типы идентификаторов. Число 15 и строка "15" не исключают друг друга автоматически.
3. Расположите первый список в нужной последовательности. Результат сохранит его порядок и уберёт повторные вхождения.
4. Проверьте статус, затем количество. При нуле оставшихся элементов завершите ветку без повторной обработки.

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

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

[
  10,
  20,
  20,
  30
]

Первый список содержит кандидатов; пустой допустим.

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

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

[
  20,
  40
]

Второй список содержит исключения, например подтверждённо обработанные ID. Пустой список ничего не исключает, кроме удаления повторов первого списка.

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

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

Укажите первый массив [10,20,20,30], второй [20,40]. Ожидаемый результат [10,30], количество 2. Если второй массив пустой, вернутся уникальные элементы первого. Если оба списка одинаковые, результат будет [].

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

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

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

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

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

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

Сравнение учитывает тип. Результат уникален и сохраняет порядок первого массива. Размер входного JSON: до 1 МБ, массива: до 10000 элементов, вложенность: до 64 уровней.

Не используйте отсутствие ID в результате как подтверждение успешной обработки объекта: оно означает только наличие совпадения во втором переданном списке. Робот не удаляет объекты CRM и не меняет исходные массивы в их источнике. Пустой первый список даёт пустой результат независимо от состава исключений. Второй список следует формировать из подтверждённых данных вашего процесса.