Выбрать записи

Используется для запроса и получения записей данных из коллекции, соответствующих заданным условиям.

Можно настроить запрос одной записи или нескольких записей. Результат запроса можно использовать как переменную в последующих узлах. При запросе нескольких записей результат будет массивом. Если результат пустой, можно выбрать, продолжать ли выполнение следующих узлов.

Создание узла

В интерфейсе настройки рабочего процесса нажмите кнопку плюса ("+") в потоке, чтобы добавить узел «Выбрать записи»:

Добавление узла «Выбрать записи»

Настройка узла

Настройка узла «Выбрать записи»

Коллекция

Выберите коллекцию, из которой нужно запросить данные.

Тип результата

Тип результата делится на «Одна запись» и «Несколько записей»:

  • Одна запись: результат — объект, то есть только первая подходящая запись, либо null.
  • Несколько записей: результат — массив записей, соответствующих условиям. Если совпадений нет, будет пустой массив. Обработать их по одной можно узлом «Цикл».

Условия фильтрации

Как и в обычном запросе коллекции, в условиях фильтрации можно использовать переменные контекста рабочего процесса.

Сортировка

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

Пагинация

Если набор результатов может быть большим, используйте пагинацию для контроля количества записей. Например, чтобы получить последние 10 записей, отсортируйте по полю «Время создания» по убыванию и задайте пагинацию: страница 1, 10 записей.

Обработка пустых результатов

В режиме одной записи, если условиям не соответствуют данные, результат запроса будет null. В режиме нескольких записей — пустой массив ([]). Можно включить опцию «Завершить рабочий процесс при пустом результате запроса». Если она включена и результат пустой, последующие узлы выполняться не будут, а рабочий процесс завершится досрочно со статусом ошибки.