iec.ExportTraceReport

Сгенерируйте файл XLS, который содержит матрицу трассируемости

Описание

Экземпляры iec.ExportTraceReport сгенерируйте XLS файл, который содержит матрицу трассируемости. Матрица трассируемости обеспечивает трассируемость между объектами модели, сгенерированным кодом и требованиями модели. Для получения дополнительной информации смотрите, Обеспечивают Трассируемость Между Объектами модели, Сгенерированным кодом и Требованиями Модели.

Прежде, чем сгенерировать отчет при помощи iec.ExportTraceReport:

  • Сгенерируйте код и отчет трассируемости генерации кода для вашей модели. У вас должна быть лицензия Embedded Coder®

  • Отмена выбора (off) параметр конфигурации Classic call interface (GRTInterface).

  • Чтобы включать документацию требований в матрицу трассируемости, сначала присоедините документы требований модели.

Для получения дополнительной информации смотрите Предпосылки для Генерации Матричных Ограничений Матрицы и Трассируемости Трассируемости.

Свойства

свернуть все

Имя модели, для который матрица трассируемости XLS файл сгенерирован.

Типы данных: char

Имя XML-файла, который содержит матрицу трассируемости.

В первый раз вы вызываете iec.ExportTraceReportИмя является дополнительным. Однако, чтобы регенерировать матрицу трассируемости, необходимо задать name.

Если вы не обеспечиваете name, имена функций файл при помощи следующего соглашения, где <DateTimeStamp> дата и время что вы последнее обновление модель:

<Model>_Trace_<DateTimeStamp>.xls

Типы данных: char

(Необязательно) Полный путь к местоположению, где вы хотите сохранить XML-файл. Если местоположение не задано, XML-файл сохранен в местоположение, заданное в MATLAB®.

(Необязательно) Задает порядок, в котором столбцы представлены в матричном отчете трассируемости, который доступен под вкладкой Report в XML-файле. Столбцы в отчете могут включать:

  • Имя объекта модели

  • Оптимизированный объект модели

  • Путь к объекту модели

  • Подсистема объекта модели

  • Местоположение файла кода

  • Имя файла кода

  • Функция кода

  • Номер строки кода

  • Тип объекта модели

  • Источник требований

  • Местоположение требований

  • Уникальный идентификатор объекта модели

  • Объяснение оптимизации модели

  • Контрольная сумма комментария к коду

Примеры

свернуть все

Сгенерируйте электронную таблицу XML, которая обеспечивает матрицу трассируемости между объектами модели и сгенерированным кодом в rtwdemo_hyperlinks модель.

Открыть rtwdemo_hyperlinks модель и генерирует код, использует эти функции:

  • open_system ─ Открывает модель.

  • set_param ─ Установите параметр конфигурации GenCodeOnly к On, который указывает, что процесс сборки генерирует код и make-файл.

  • rtwbuild ─ Генерирует код от основанного на модели на настройках параметра конфигурации текущей модели.

% Open the model.
open_system('rtwdemo_hyperlinks');
% Generate code only.
set_param('rtwdemo_hyperlinks', 'GenCodeOnly', 'on');
% Initiate the build process.
rtwbuild('rtwdemo_hyperlinks');

Сгенерируйте электронную таблицу трассируемости для модели при помощи iec.ExportTraceReport функция.

% Generate a traceability spreadsheet.
iec.ExportTraceReport('rtwdemo_hyperlinks'); 

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

Если вы не задаете имя файла или местоположение, программное обеспечение применяет имя файла по умолчанию rtwdemo_hyperlinks_Trace_<DateTimeStamp>.xlsx и сохраняет электронную таблицу в местоположение, заданное в MATLAB.

% Generate a traceability spreadsheet.
iec.ExportTraceReport('rtwdemo_hyperlinks','rtwdemo_hyperlinks_Trace_ProjectXYZ','C:\temp'); 

Программное обеспечение генерирует матричную электронную таблицу трассируемости rtwdemo_hyperlinks_Trace_ProjectXYZ.xlsx и сохранил файл к C:\temp папка.

Сгенерируйте электронную таблицу XML, которая обеспечивает матрицу трассируемости между объектами модели, сгенерированным кодом и требованиями модели в slvnvdemo_fuelsys_docreq модель.

Открыть slvnvdemo_fuelsys_docreq модель, задайте параметры отчета, и сгенерируйте код, используйте эти функции:

  • open_system ─ Открывает модель

  • set_param ─ Используйте параметр конфигурации GenerateReport создать отчет генерации кода. Используйте GenerateTraceReport сгенерировать отчет трассируемости. Параметр конфигурации GenCodeOnly указывает, что процесс сборки генерирует код и make-файл.

  • rtwbuild ─ Генерирует код от основанного на модели на настройках параметра конфигурации текущей модели.

% Open the model.
open_system('slvnvdemo_fuelsys_docreq');
% Select the code generation report and traceability report parameters.
set_param('slvnvdemo_fuelsys_docreq', 'GenerateReport', 'on');
set_param('slvnvdemo_fuelsys_docreq', 'GenerateTraceReport', 'on');
set_param('slvnvdemo_fuelsys_docreq', 'GenerateTraceReportSl', 'on');
set_param('slvnvdemo_fuelsys_docreq', 'GenerateTraceReportSf', 'on');
set_param('slvnvdemo_fuelsys_docreq', 'GenerateTraceReportEml', 'on');
% Generate code only.
set_param('slvnvdemo_fuelsys_docreq', 'GenCodeOnly', 'on');
% Initiate the build process.
rtwbuild('slvnvdemo_fuelsys_docreq');

Сгенерируйте электронную таблицу трассируемости для модели при помощи функционального iec.ExportTraceReport.

% Generate a traceability spreadsheet.
iec.ExportTraceReport('slvnvdemo_fuelsys_docreq'); 

Программное обеспечение генерирует матричную электронную таблицу трассируемости slvnvdemo_fuelsys_docreq_Trace_<DateTimeStamp>.xlsx. Откройте электронную таблицу трассируемости и рассмотрите вкладку Report. Содержимое специфично для docreq.

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

Сгенерируйте матричную электронную таблицу трассируемости rtwdemo_hyperlinks_Trace_ProjectXYZ.xlsx.

model = 'rtwdemo_hyperlinks';

% Open the model.
open_system(model);
% Generate code only.
set_param(model, 'GenCodeOnly', 'on');
% Initiate the build process.
rtwbuild(model);
% Generate a traceability spreadsheet.
iec.ExportTraceReport('rtwdemo_hyperlinks','rtwdemo_hyperlinks_Trace_ProjectXYZ_withComments'); 

Открытая матричная электронная таблица трассируемости rtwdemo_hyperlinks_Trace_ProjectXYZ_withComments.xlsx.

Во вкладке Report создайте столбец для своих комментариев, который имеет уникальный заголовок столбца. Добавьте по крайней мере одну запись в столбец комментариев кроме заголовка столбца.

Примечание

Комментарии должны решить к текстовой строке. Например, ссылка на изображение решает к текстовой строке, но копия изображения не делает.

В электронной таблице сохраните следующие столбцы:

  • Имя объекта модели

  • Путь к объекту модели

  • Подсистема объекта модели

  • Местоположение файла кода

  • Имя файла кода

  • Функция кода

  • Номер строки кода

  • Уникальный идентификатор объекта модели

  • Оптимизированный объект модели

  • Контрольная сумма комментария к коду

Сохраните и закройте электронную таблицу, rtwdemo_hyperlinks модель и отчет генерации кода.

(Необязательно), Чтобы включать последнюю информацию о трассируемости модели к коду, регенерируйте и повторно смотрите код для rtwdemo_hyperlinks модель прежде, чем сгенерировать матрицу трассируемости.

Примечание

Если вы регенерируете код в том же расположении файла, удаляете slprj и rtwdemo_hyperlinks_ert_rtw папки.

model = 'rtwdemo_hyperlinks';

% Open the model.
open_system(model);
% Generate code only.
set_param(model, 'GenCodeOnly', 'on');
% Initiate the build process.
rtwbuild(model);

Чтобы регенерировать матричную электронную таблицу трассируемости, используйте функциональный iec.ExportTraceReport. Путь 'C:\temp' задан как местоположение, где матрица трассируемости сохранена.

% Generate a traceability spreadsheet.
iec.ExportTraceReport('rtwdemo_hyperlinks','rtwdemo_hyperlinks_Trace_ProjectXYZ_withComments','C:\temp'); 

Программное обеспечение регенерирует матричную электронную таблицу трассируемости и делает их:

  • Ранее сгенерированная матричная электронная таблица трассируемости переименована в rtwdemo_hyperlinks_Trace_ProjectXYZ_withComments_BAK.xlsx.

  • Новая матричная электронная таблица трассируемости сохранена как rtwdemo_hyperlinks_Trace_ProjectXYZ_withComments.xlsx.

Проверьте что недавно сохраненная матричная электронная таблица трассируемости, rtwdemo_hyperlinks_Trace_ProjectXYZ_withComments.xlsx, включает ваши комментарии.

Когда вы изменяете модель и регенерируете матрицу трассируемости, iec.ExportTraceReport функция идентифицирует комментарии, что вы добавляете к матрице трассируемости.

Задайте порядок столбцов на вкладке Report в электронной таблице трассируемости XML.

Открыть rtwdemo_hyperlinks модель и генерирует код, использует эти функции:

model = 'rtwdemo_hyperlinks';

% Open the model.
open_system(model);
% Generate code only.
set_param(model, 'GenCodeOnly', 'on');
% Initiate the build process.
rtwbuild(model);

Используя colHead, задайте порядок столбцов. Сгенерируйте матричную электронную таблицу трассируемости при помощи iec.ExportTraceReport функция.

colHead = {
    'Code Line Number';
    'Model Object Type';
    'Requirements Source';
    'Requirements Location';
    'Model Object Unique ID';
    'Code Comment Checksum';
    'Model Object Optimized';
    'Model Object Path';
    'Model Object Subsystem';
    };
rname = [model,'_Trace_',datestr(now,30)];
rpath = pwd;
iec.ExportTraceReport(model, rname, rpath, colHead); 

Программное обеспечение генерирует матричную электронную таблицу трассируемости rtwdemo_hyperlinks_Trace_<DateTime>.xlsx. Порядок столбцов на вкладке Report в матричной электронной таблице трассируемости эквивалентен заданный в коде. Остальные столбцы, порядок которых не задан в коде, перечислены после заданных столбцов.

Введен в R2010a