Запрос в Tetiva всегда лежит внутри коллекции, а коллекция — внутри рабочего пространства. Рабочее пространство изолирует данные: у каждого свои коллекции, окружения, история и cookies. Коллекция — это папка, которая содержит запросы и другие коллекции и раздаёт им общие настройки: авторизацию и pre/post-скрипты.
Рабочие пространства#
Переключатель рабочих пространств находится вверху сайдбара. Рядом с именем стоит иконка: облако — пространство связано с сервером синхронизации, монитор — оно только локальное. Подробности про связку — на странице Синхронизация.
При первом запуске уже есть рабочее пространство Default Workspace и активное окружение Default. Из контекстного меню переключателя пространство можно переименовать, создать новое или удалить. Удалить последнее оставшееся пространство нельзя — приложение вернёт ошибку. При создании доступен флажок «Sync to server»: он сразу заводит парное пространство на сервере.
Переключение пространства меняет всё разом — дерево коллекций, список окружений, историю и cookie jar. Это удобный способ развести личные эксперименты и рабочие проекты, не смешивая переменные.
Вложенные коллекции#
Коллекция может лежать в корне пространства или внутри другой коллекции — глубина не ограничена. Пункт «New Sub-Collection» в контекстном меню создаёт дочернюю папку, «New Request» — запрос внутри неё. Запрос всегда принадлежит какой-то коллекции; положить его в корень нельзя.
Вложенность — это не только визуальная группировка. Запрос с авторизацией Inherit ищет настройки вверх по дереву, и точно так же наследуются скрипты коллекций. Обход останавливается на 50-м уровне вложенности — см. Авторизацию и Скрипты.
Поиск по дереву — поле в строке шапки сайдбара, рядом с кнопками; фокус по Cmd/Ctrl+F. Совпадения подсвечиваются, а найденная папка раскрывается вместе со всем содержимым.
Описание, авторизация и скрипты#
Пункт «Open Details» открывает коллекцию отдельной вкладкой с тремя разделами.
Overview показывает счётчики запросов и папок и поле описания. Описание понимает Markdown: заголовки, списки, ссылки, code-блоки. Кнопка справа переключает режимы Edit и Preview, клик по отрендеренному тексту возвращает в редактирование. Сырой HTML внутри описания не выполняется, а голые URL превращаются в ссылки автоматически.
Authorization задаёт авторизацию для всех вложенных запросов, у которых выбран Inherit. Набор типов тот же, что и у запроса, плюс «Inherit from parent» для вложенных коллекций.
Scripts хранит pre- и post-скрипты уровня коллекции.
Описание и авторизация переживают экспорт и импорт в формате Postman — см. Импорт и экспорт.
Множественный выбор#
В сайдбаре работает выделение нескольких элементов сразу:
- Cmd/Ctrl+Click — добавить элемент в выделение или убрать из него;
- Shift+Click — выделить диапазон от предыдущего элемента до текущего по видимым строкам дерева;
- Esc — снять выделение;
- Delete или Backspace — удалить всё выделенное.
Пока что-то выделено, контекстное меню меняется: вместо обычных пунктов в нём остаются «Move to...» и «Delete N items». Массовое удаление всегда проходит через диалог подтверждения — случайное нажатие Backspace ничего не сотрёт молча.
Перенос элементов#
«Move to...» доступен и для одиночного элемента, и для выделенной группы. Диалог показывает дерево коллекций и отдельный пункт «Root (top level)» — верхний уровень доступен только коллекциям, запросу нужна коллекция-приёмник.
Перенос коллекции внутрь собственного потомка запрещён: приложение проверяет цепочку родителей и возвращает ошибку вместо того, чтобы порвать дерево.
Удаление#
Удаление мягкое: запись помечается удалённой, а не стирается из базы. Диалог подтверждения предупреждает, что коллекция уйдёт вместе со всем содержимым; открытые вкладки вложенных коллекций и запросов при этом закрываются.
Данные коллекций и окружений живут рядом — если запросы ссылаются на {{base_url}}, переменную стоит завести до массового переноса. Как это устроено, описано в разделе Окружения и переменные.