Обмен задачами

Пакет задач представляет собой один файл .querylane.json с одной или несколькими задачами. Через него удобно передать задачи коллеге или перенести их на другой Mac без git. Пароли подключений и значения секретов в файл не попадают.

Что входит в файл

• задачи: название, описание, переменные, шаги, настройки вывода и уведомления;
• папки и теги, если вы их сохраняете;
• описание каждого подключения, которое используют шаги: название, тип, хост, порт и база данных, без учётных данных;
• npm-пакеты, которые импортируют JavaScript-шаги;
• плагины, которые используют шаги и уведомления, с версией и выбранными пресетами.

В файл не попадают:

• значения переменных, в названии которых есть признак секрета, например token, key, password, secret или auth, а также переменных с запретом экспорта;
• секретные настройки плагинов;
• история версий шагов, история запусков и артефакты.

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

Экспорт

Чтобы экспортировать одну задачу, нажмите значок экспорта (Экспортировать в файл) в её строке в списке задач. Чтобы выгрузить все задачи папки, нажмите Экспортировать папку у папки.

Чтобы выбрать несколько задач:

1. Нажмите Экспортировать задачи над списком задач.
2. Отметьте задачи или воспользуйтесь полем Поиск задач и кнопкой Выбрать все. В окне видно, сколько выбрано, например Выбрано: 3.
3. Оставьте включённым Сохранить папки и теги, если при импорте задачи должны попасть в те же папки.
4. Нажмите Экспортировать и выберите, куда сохранить файл.

Учётные данные, вписанные прямо в API-шаг, например заголовок Authorization или пароль в URL, являются частью шага и попадают в файл как есть. Перед экспортом QueryLane находит их и показывает окно Учётные данные в задачах со списком шагов. Нажмите Отмена и перенесите значения в секретные переменные или нажмите Всё равно экспортировать.

Импорт

1. Нажмите Импортировать задачи из файла над списком задач и выберите файл. Файл можно и просто перетащить на список задач.
2. Проверьте разделы окна Импорт задач и нажмите Импортировать.

Задачи перечисляет задачи из файла. Если задача с таким же id или названием уже есть, выберите Импортировать копией (по умолчанию) или вариант Заменить с названием вашей задачи. Копия получает свободное название, например Daily report (2). Заменённая задача сохраняет своё место, расписание и историю версий шагов: у изменённых шагов появляется запись Импорт, а шаги, которых нет в файле, попадают в Удаленные шаги (см. Версии и git).

Что задачи читают и куда отправляют показывает файлы, которые читают задачи, и хосты, на которые они отправляют запросы.

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

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

Пакеты JavaScript показывает npm-пакеты, которые нужны шагам, но не установлены. Нажмите Установить рядом с каждым.

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

Разложить по папкам и тегам из файла помещает новые задачи в папки и теги из файла и создаёт недостающие.

Задачи выполняются на вашем Mac с вашим доступом к файлам, сети и базам данных. Импортируйте файлы только от тех, кому доверяете.

Ограничения

В файле может быть до 500 задач, размер файла до 20 МБ. Файл из более новой версии QueryLane откроется только после обновления приложения.

Агенты, подключённые по MCP, работают с тем же форматом через querylane_jobs_export и querylane_jobs_import.