Отсортировать массив

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

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

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

Автору процесса, который готовит упорядоченный список цен, дат или строк для следующего действия или отчёта.

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

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

Поле	Как заполнить
Массив в JSON, например [1,2,3] (ARRAY)	Обязательное поле
Тип сравнения (KIND)	Обязательное поле. по умолчанию string. Строки (string); Числа (number); Даты ISO (date)
Направление (DIRECTION)	Обязательное поле. по умолчанию asc. По возрастанию (asc); По убыванию (desc)

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

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

1. Передайте массив JSON и выберите смысл значений: строки, числа или ISO-даты. По умолчанию выбран строковый тип.
2. Укажите направление: по возрастанию (asc, по умолчанию) или по убыванию (desc).
3. Для даты используйте YYYY-MM-DD; для времени укажите ISO-значение с часовым поясом. Числа передавайте числами либо строками с десятичной точкой.
4. Проверьте статус и итоговый массив. Null и пустая строка останутся в конце при любом направлении; повторы не удаляются.

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

Массив в JSON, например [1,2,3] (ARRAY)

[
  "10",
  "2",
  null,
  ""
]

Для примера выберите KIND=number, DIRECTION=asc. Исходные значения сохраняют тип. Пустой массив допустим.

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

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

Передайте ["10","2",null,""], тип number, направление asc. Ожидается ["2","10",null,""]: порядок числовой, исходные строковые значения сохранены. При desc сначала будет "10", затем "2", а пустые значения всё равно останутся в конце.

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

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

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

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

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

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

Строки сравниваются с учётом регистра. Числа можно передать числами или строками с точкой. Дата: YYYY-MM-DD (полночь UTC), дата-время: ISO с часовым поясом. Null и пустая строка остаются в конце при обоих направлениях. Некорректное значение останавливает действие. Размер входного JSON: до 1 МБ, массива: до 10000 элементов, вложенность: до 64 уровней.

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