Дашборды

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

У дашбордов свой раздел в левой панели. Открыть его можно сочетанием ⌘ 3. В списке у каждого дашборда видно число виджетов и задач.

Собрать дашборд из задачи

Быстрее всего начать с задачи, которая уже рисует графики:

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

Добавленные так графики следуют за задачей: после следующего запуска виджет покажет новый график. Если у графика в шаге-графике есть id, виджет не потеряет его, даже когда вы поменяете графики местами.

Собрать дашборд вручную

В разделе Дашборды нажмите Новый дашборд.
Нажмите Изменить, затем Добавить виджет.
Выберите вид виджета, а в полях Задача и Шаг со строками — откуда он берёт данные.
Настройте виджет и нажмите Готово.

Виды виджетов:

Виджет	Что показывает
Число	Одно значение: количество, сумму, среднее, минимум или максимум, с форматом, префиксом и суффиксом
Таблица	Строки шага или сгруппированные строки со значениями. Без группировки и значений показывает строки как есть
График	Линию, область, столбцы, круговую диаграмму или точки по сгруппированным значениям
График шага-графика	График, который рисует шаг-график, без изменений
Текст	Заголовок или заметку

Для числа, таблицы и графика задаются поля Группировать по (даты группируются по часам, дням, неделям, месяцам, кварталам или годам), Значения с агрегатом, Условия на строки, Сортировка и Лимит строк. Вложенные поля документов и ответов API пишутся через точку, например customer.country.

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

Фильтры и параметры

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

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

Когда обновлять данные

Настройка Когда обновлять данные определяет, что дашборд делает с задачами:

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

Кнопка Обновить запускает задачи дашборда сейчас со значениями его параметров. Запуски из дашборда — обычные запуски задачи, они видны в её истории. Запуски, которые читает дашборд, не удаляются ни при обрезке, ни при очистке истории.

Сохранить и передать

В меню дашборда есть:

Сохранить как HTML: одна страница с графиками в виде картинок, без скриптов и обращений к сети, поэтому открывается где угодно;
Сохранить как картинку: PNG всего дашборда;
Экспорт в файл: пакет с дашбордом и задачами, которые он читает, для другого QueryLane.

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

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