Документация Комплексный отчёт о прогоне плана (v2)

Отчёт о прогоне плана

Отчёт тест-плана показывает результат прогона и каждого его шага. Он помогает разобраться в ошибке, поделиться итогами с командой или передать результат в CI. Прогон можно открыть в Mockarty или скачать в одном из шести форматов.

Об URL в примерах: если сервер работает не на вашем компьютере, замените localhost:5770 на адрес своего Mockarty.

Связанные страницы: Просмотр прогона · Переопределения · Тест-планы · Тест-планы в CI/CD

Что внутри отчёта

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

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

Откройте прогон через Тест-планы → Прогоны, чтобы посмотреть элементы до выгрузки. Подробность данных зависит от типа теста и того, что было собрано при этом прогоне.

Применения форматов

Для прогона тест-плана доступны шесть вариантов выгрузки:

Формат Когда использовать Суффикс URL
Allure JSON Читать Allure-совместимый результат программно /report
Allure ZIP Передать результаты и вложения в Allure или артефакты CI /report.zip
JUnit XML Показать результаты тестов в CI /report.junit.xml
Markdown Отправить понятную сводку в сообщении или wiki /report.md
HTML Открыть или напечатать отчёт в браузере /report.html
Mockarty JSON Обработать прогон своей программой /report.unified.json

Суффикс добавляется к адресу:

/api/v1/namespaces/:namespace/test-plans/:idOrNumericID/runs/:runID

Например, так можно сохранить JUnit XML для прогона:

mockarty-cli testplan report <runID> --plan <planID> --format junit -o report.junit.xml

HTML-отчёт содержит собственные стили. Его можно сохранить в PDF через печать в браузере. Запрос report.html?standalone=true встраивает вложения для передачи файла без доступа к серверу; размер файла может вырасти. Перед передачей проверьте, какие тестовые данные и вложения попали в выгрузку.

Отчёты других движков

Для поддерживаемых типов прогонов есть единая страница /ui/runs/<kind>/<id>/report и API /api/v1/runs/<kind>/<id>/report. Подробнее об этом представлении и его CLI-команде — в разделе Прогоны тестов. Шесть URL выше относятся именно к прогонам тест-планов.

Для этого единого API запросы ?format=allure_zip и ?format=allure_dir включают вложения, указанные в отчёте. Если файл вложения недоступен, скачивание завершается ошибкой вместо выдачи архива без файла. Проверьте хранилище вложений и повторите экспорт.

Загрузка больших отчётов

Если сохранённый артефакт Allure или HTML доступен, Mockarty отдаёт его из хранилища. Если его нет, отчёт создаётся из данных прогона. Большие отчёты и вложения могут загружаться дольше: дождитесь завершения скачивания файла.

Защита данных в отчёте

Mockarty маскирует распознанные секретные поля в сохранённом контексте плана и параметрах отчёта. Перед отправкой выгрузки за пределы команды просмотрите её: запросы, ответы и вложения могут содержать данные тестируемой системы. Ограничивайте доступ к отчёту так же, как доступ к прогону.

Частые проблемы

  • Отчёта ещё нет: убедитесь, что прогон завершился и выбраны нужные идентификаторы плана и прогона.
  • CI не показывает результат: скачайте JUnit XML и проверьте, что CI публикует этот файл как отчёт о тестах.
  • HTML слишком велик: используйте обычный HTML или краткую сводку Markdown вместо варианта со встроенными вложениями.

Права

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

Дальше: Переопределения объясняют изменение входных данных плана, а Просмотр прогона — экран живого прогона.