Документация TMS DoQA

Тема

Автотесты ​

Автотест появляется в DoQA только тогда, когда в систему приходят результаты его выполнения, — добавить его вручную нельзя. Базовые понятия — на этой странице, практические руководства — в карте раздела.

Что такое автотест ​

Автотест в DoQA живёт в двух местах:

  • Каталог автотестов — реестр всех автотестов пространства: раздел «Автотесты» в меню пространства, вкладки «Каталог» и «Кластеры ошибок». Здесь у автотеста есть карточка с историей, показателями стабильности и привязками — см. Каталог автотестов.
  • Прогоны — результаты каждого выполнения. Они попадают в обычные прогоны рядом с ручными тест-кейсами; разбор результата — Результаты и разбор падений.

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

Внешний ID ​

Основной идентификатор автотеста — внешний ID (externalId). Он уникален в пределах пространства и задаётся в коде теста:

  • в Java-адаптере — аннотацией @DoqaId;
  • в Allure-отчёте — меткой doqa_id;
  • в JUnit XML — свойством <property name="doqa_id" value="..."/>.

Если явного ID нет, Java-адаптер выводит его сам — по строгому приоритету:

  1. маркер в имени теста: [DOQA-123] или @DOQA:123 в display name;
  2. совместимый ID из Allure-разметки, если она есть в проекте, — Переезд с Allure;
  3. хэш сигнатуры метода — стабилен, пока не меняются класс и сигнатура теста.

Если внешний ID не передан вовсе, DoQA опознаёт автотест по полному имени. Это работает, но хрупко: при переименовании тестового метода для DoQA это будет новый автотест без накопленной истории. С внешним ID переименование безопасно — история, стабильность и привязки остаются у той же записи каталога.

Задавайте внешний ID явно

Явный внешний ID — единственный способ сохранить историю автотеста при переименовании и переносе между классами. Для новых проектов задавайте его с первого дня.

Переход на внешний ID ​

Если автотест раньше отчитывался без внешнего ID, а затем стал присылать его, вторая запись в каталоге не создаётся. DoQA находит существующий автотест по имени и записывает ему присланный внешний ID — накопленная история «усыновляется» новым ключом. Если у найденного по имени автотеста уже записан другой внешний ID, ключ не перезаписывается: результаты продолжают попадать в существующую запись со старым ключом.

Как результаты попадают в DoQA ​

СпособКогда подходитПодробнее
Загрузка отчёта в интерфейсеразовая выгрузка готового отчёта JUnit XML или Allure — DoQA создаёт прогон с результатамиОтправка результатов автотестов
doqa-cliотправка из CI или локально: watch шлёт результаты по мере выполнения тестов, report — готовый отчёттам же
POST /api/autotests/reportтот же приём отчёта по HTTP, без утилитытам же
Адаптер тестового фреймворкабиблиотека в тестовом проекте: результаты в реальном времени, с шагами, вложениями и метками, без файлов отчётовАдаптеры для тестовых фреймворков
Собственный адаптерготового адаптера под ваш язык или фреймворк нет — прямое API /api/autotests/*Autotest API
Запуск из DoQADoQA сама запускает пайплайн в подключённой CI-системе; результаты попадают в прогон по ходу или по завершении пайплайна — смотря как пайплайн их отправляетЗапуск автотестов из DoQA

Способы можно совмещать: например, ежедневные запуски идут из DoQA по расписанию, а разовые локальные прогоны разработчики отправляют через doqa-cli. Результаты в любом случае попадут в один и тот же автотест каталога — идентичность определяет внешний ID, а не способ доставки.

Связь с тест-кейсами ​

Связь автотеста с ручным тест-кейсом показывает, что кейс покрыт автоматизацией. Один автотест может покрывать несколько тест-кейсов; у тест-кейса — не больше одного автотеста.

Способы привязки:

СпособОткуда задаётсяПоведение
Список кейсовметка doqa_cases в отчёте или аннотация @DoqaCaseIds в Java-адаптере — ID нескольких кейсоваддитивно: прежние связи не снимаются
По коду кейсакод тест-кейса совпадает с внешним ID автотестааддитивно, срабатывает автоматически с обеих сторон: при приёме результата и при создании или изменении кейса; если кейсов с таким кодом несколько — привяжутся все
Вручную из каталогадействие «Привязать кейс» в каталоге автотестов — по ID кейса, в том числе массовоаддитивно

Для проектов с Allure-разметкой работает и привязка по Allure ID (связь один-к-одному) — Переезд с Allure.

Тест-кейсы при привязке не создаются: если кейса с присланным ID в пространстве нет, привязка молча пропускается. Автотест без привязанного кейса помечается в каталоге как «Без кейса» — для таких есть отдельный чип и фильтр.

Статус автоматизации ​

У тест-кейса три значения «Статуса автоматизации»:

  • «Ручной»;
  • «Подлежит автоматизации» — пометка о том, что тест-кейс планируется автоматизировать;
  • «Автоматизирован» — тест-кейс связан с автотестом.

«Автоматизирован» проставляет система при появлении связи, вручную выбрать это значение нельзя. Чтобы разорвать связь, выберите в редакторе тест-кейса «Ручной» или «Подлежит автоматизации».

Что рвёт связь

Смена «Статуса автоматизации» на любое другое значение рвёт связь тест-кейса с автотестом. Копия тест-кейса связь не наследует: у копии связи с автотестом нет.

статусы автоматизации

Связь с требованиями ​

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

Страницы раздела ​

Смотрите также