exponenta event banner

sltest.testmanager. TestSpecReport

Создание отчета о спецификациях испытаний

Описание

пример

sltest.testmanager.TestSpecReport(testObj,filePath,Name,Value) создает отчет о тестовых спецификациях для указанного testObj и сохраняет отчет в указанном filePath местоположение.

Примеры

свернуть все

Создание отчета PDF с использованием шаблона по умолчанию. В этом примере сообщается о тестовых случаях из файла диспетчера тестов AutopilotTestFile модель. В отчете указывается автор теста и название отчета. Он исключает пользовательские критерии из отчета и запускает отчет после его создания. Другие свойства по умолчанию true и, таким образом, их информация включается в доклад.

testmgrFile = 'AutopilotTestFile.mldatx';
sltest.testmanager.load(testmgrFile);

tfiles = sltest.testmanager.getTestFiles;
tcases = tfiles.getTestSuites.getTestCases;

sltest.testmanager.TestSpecReport(tcases,'testReport.pdf',...
	'Author','Test File Author',...
	'Title','Test Specification Details',...
	'IncludeCustomCriteria',false,...
    'LaunchReport',true);

Создайте пользовательский шаблон тестового случая. После редактирования шаблона используйте его при создании отчета. Примеры изменений пользовательского шаблона включают переупорядочивание разделов отчета и изменение шрифтов отчета. В этом примере показано, как сгенерировать настраиваемую программу StartCaseReporter. Создание настраиваемого шаблона StartSuiteReporter аналогично и используется для создания разделов отчетов Test Suite и Test File. Для настройки шаблонов требуются лицензии MATLAB Report Generator и Simulink Report Generator.

Создание и распаковка файла шаблона PDF

sltest.testmanager.TestCaseReporter.createTemplate(...
   'MyCustomTemplate','pdf');
unzipTemplate('MyCustomTemplate.pdftx');

Редактирование файлов шаблонов

Затем отредактируйте файлы шаблонов в папке MyCustomTemplate.

Архивировать файлы шаблонов

zipTemplate('MyCustomTemplate.pdftx');

Использовать файл пользовательского шаблона для отчета

testmgrFile = 'AutopilotTestFile.mldatx';
sltest.testmanager.load(testmgrFile);

tfiles = sltest.testmanager.getTestFiles;
tcases = tfiles.getTestSuites.getTestCases;

sltest.testmanager.TestSpecReport(tcases,'testReport.pdf',...
   'Author','Test Author','Title','Test',...
   'LaunchReport',true,...
   'TestCaseReporterTemplate','MyCustomTemplate.pdftx');

Входные аргументы

свернуть все

Тестовые объекты, на основе которых создается отчет о тестовых спецификациях, указанный как массив sltest.testmanager.TestFile, sltest.testmanager.TestSuite, или sltest.testmanager.TestCase объекты. Нельзя включать другие типы объектов в один и тот же массив.

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

  • pdf - отчет в формате PDF

  • docx - Отчет Word

  • zip - HTML-отчет в ZIP-файле

Пример: «reports/test_specs/new_report.pdf»

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'IncludeCallbackScripts',false

Имя автора отчета, указанное как строковый или символьный вектор.

Пример: 'Author','J. Smith'

Заголовок отчета, указанный как символьный вектор.

Параметр для включения сведений о тестировании в отчет, указанный как логический. Если trueподробные данные теста, включенные в отчет, представляют собой теги тестирования, версии, описание и требования.

Параметр для включения параметров тестового файла в отчет, указанный как логический. Если true, параметры тестового файла, включенные в отчет:

  • Закрыть ли открытые фигуры

  • Сохранение данных MATLAB

  • Создавать ли отчет после выполнения

  • Параметры создания отчетов о результатах

    • Название отчета

    • Автор

    • Включение версии MATLAB

    • Типы включаемых результатов теста (все, только неудачные или только пройденные)

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

    • Формат выходного файла

    • Имя выходного файла

    • Пользовательский класс отчета

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

Опция для включения тестируемой системы в отчет, указанная как логическая. Если true, информация о проверяемой системе, включенная в отчет:

  • Имя модели и изображение

  • Имя и изображение кабеля

  • Последовательность испытаний и оценочные данные (если они существуют в тестовом жгуте)

  • Настройки моделирования - режим моделирования, время начала (если переопределено), время окончания (если переопределено) и начальное состояние (если переопределено)

  • Целевые настройки - целевая информация для тестов в реальном времени

Параметр для включения переопределений настроек конфигурации, указанных как логические. Если true, отчет включает настройки, которые отличаются от настроек конфигурации модели.

Параметр для включения сценариев обратного вызова в отчет, указанный как логический.

Параметр для включения переопределений параметров в отчет, указанный как логический. Если true, отчет включает имя набора параметров или переменной рабочей области, значение переопределения, источник переменной и элемент модели.

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

Возможность включения регистрируемых сигналов, указанных как логические. Если true, отчет включает имя, источник, индекс порта и индекс графика для каждого зарегистрированного сигнала.

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

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

Параметр для включения информации об итерациях в отчет, указанный как логический. Если true, отчет включает имя итерации и значения внешних входов, набор параметров и набор регистрируемых сигналов для каждой итерации. Он также включает содержимое раздела Сценарий итераций (Iterations Script) из Диспетчера тестов (Test Manager).

Возможность включения в отчет логических и временных оценок, указанных как логические. Если trueотчет включает в себя обратные вызовы оценки, определения оценки и символы из тестового случая.

Параметр для включения в отчет пользовательского сценария критериев прохождения/отказа, указанного как логический.

Опция открытия отчета после его создания, заданная как логическая.

Путь к шаблону репортера тестового случая, указанному как символьный вектор. Имя файла пути шаблона должно использовать pdftx, html, или dotx для шаблона PDF, HTML или Word соответственно. Указанный шаблон используется вместо шаблона по умолчанию TestCaseReporter шаблон. Использование шаблонов, отличных от шаблонов по умолчанию, доступно только при наличии лицензии Simulink ® Report Generator™.

Путь к шаблону репортера набора тестов, указанному как вектор символов. Имя файла в пути шаблона должно использовать pdftx, html, или dotx для шаблона PDF, HTML или Word соответственно. TestSuiteReporter шаблон используется как для тестовых наборов, так и для тестовых файлов. Указанный шаблон используется вместо шаблона по умолчанию TestSuiteReporter шаблон. Использование шаблонов, отличных от шаблонов по умолчанию, доступно только при наличии лицензии Simulink Report Generator.

Представлен в R2019b