Проверки результата
Проверка результата — это правило для данных, которые вернул шаг: строк достаточно, email не пустые, идентификаторы уникальны и так далее. Проверки ловят плохие данные до того, как следующие шаги их загрузят или отправят. Проверки можно добавить к шагу любого типа, кроме График.
Добавление проверки
- Откройте задачу в редакторе и выберите шаг.
- В разделе Проверки результата нажмите Добавить проверку.
- Выберите правило в поле Проверка и заполните его поля.
- В поле Если не прошла выберите Остановить задачу или Предупредить.
- Сохраните задачу.
Перед добавлением проверок запустите шаг хотя бы раз: тогда поля будут подсказывать названия колонок из его последнего результата. Колонка, которой в этом результате не было, помечается Нет в последнем запуске шага.
Виды проверок
| Проверка | Настройки | Не проходит, если |
|---|---|---|
| Минимум строк | Строк | строк меньше |
| Максимум строк | Строк | строк больше |
| Есть колонки | Колонки | колонки нет ни в одной строке |
| Заполнено | Колонки | в строке колонка равна null, отсутствует или содержит пустой текст |
| Уникально | Колонки | у двух строк совпадает сочетание значений |
| Допустимые значения | Колонка, Допустимые значения | значения нет в списке |
| По шаблону | Колонка, Регулярное выражение | текст не подходит под шаблон |
Несколько уточнений:
- Допустимые значения сравнивает значения как текст, поэтому
1и"1"равны. - По шаблону использует регулярные выражения JavaScript, например
^[A-Z0-9-]+$. - Уникально, Допустимые значения и По шаблону пропускают пустые значения. Если значение обязательно, добавьте ещё и Заполнено.
- Имя через точку, например
address.city, читает вложенное значение.
Какие строки проверяются
Проверки читают результат шага как строки. Массив проверяется как есть, любое другое значение считается одной строкой.
Если строки лежат внутри объекта, например в ответе API { "items": [...] }, укажите путь в поле Строки из: items, data.results или items[0].rows. Если такого пути в результате нет, все проверки шага не проходят с сообщением В результате нет пути ....
Остановить или предупредить
Остановить задачу делает шаг неуспешным. Задача останавливается после него, и зависящие от него шаги не выполняются. Результат шага при этом остаётся в запуске, так что данные, не прошедшие проверку, можно посмотреть.
Предупредить позволяет задаче продолжить работу. Запуск считается успешным, а предупреждения сохраняются вместе с ним.
Проверки выполняются при каждом запуске шага: при полном запуске, по расписанию, при запуске части задачи и в Debug-запуске.
Где смотреть результаты
Результаты проверок показываются в разделе История выполнений на странице задачи:
- у запуска с предупреждениями рядом со статусом написано Предупреждений: N;
- внутри запуска у каждого шага с непройденной проверкой видны сама проверка, число неподходящих строк и до пяти строк-примеров;
- у запуска, остановленного проверкой, в подробностях ошибки есть блок Не пройденные проверки.
Уведомления о запусках по расписанию
Для запусков по расписанию QueryLane присылает уведомление macOS, когда:
- проверка с Остановить задачу остановила запуск (Запуск по расписанию остановлен проверкой результата);
- запуск завершился с предупреждениями проверок (Запуск по расписанию завершён, предупреждений проверок: N);
- запуск завершился ошибкой по другой причине (Запуск по расписанию завершился ошибкой).
Нажмите на уведомление, чтобы открыть задачу. Включить или выключить эти уведомления можно переключателем Запуски по расписанию в Настройки > Уведомления. Запуски, которые вы начинаете сами, уведомлений macOS не присылают.