Как включать детали связанных требований в сгенерированный отчет

Отчет требований является функцией в RMI, который сканирует модель Simulink для ссылок на внешние документы требований и генерирует отчет. Когда документы доступны для чтения во время требований, сообщает генерация, у вас есть опция, чтобы вставить фрагменты ссылочного документа в сгенерированное содержимое, чтобы представить более подробный отчет.

Открытая модель в качестве примера и загрузка RMI соединяют данные.

Этот пример использует Модели контроллеров Окна со стеклоподъемником и использует внешне сохраненный набор ссылок. Смотрите Требования Управления, Не Изменяя пример Файлов Модели Simulink для подробной демонстрации внешней функции устройства хранения данных в RMI.

Запустите следующие команды к

rmipref('StoreDataExternally', true);
modelPath = which('slvnvdemo_powerwindowController');
reqFilePath = fullfile(matlabroot, 'toolbox', 'slrequirements', 'slrequirementsdemos', 'powerwin_reqs', 'slvnvdemo_powerwindowOffice.slmx');
rmimap.map(modelPath, reqFilePath);
open_system('slvnvdemo_powerwindowController');
Mapping [MATLAB]/toolbox/slrequirements/slrequirementsdemos/slvnvdemo_powerwindowController.slx to [MATLAB]/toolbox/slrequirements/slrequirementsdemos/powerwin_reqs/slvnvdemo_powerwindowOffice.slmx

Переместитесь по ссылкам, чтобы видеть целевое содержимое в документах

Подсветите модель, чтобы определить местоположение объектов со ссылками и перейти к документам. Включенные ссылки демонстрируют несколько возможных стилей соединения с документами Microsoft Office:

rmi('highlightModel', 'slvnvdemo_powerwindowController');

Отчет требований без фрагментов документа

  • Сгенерируйте отчет. Это может взять немного дольше на первом показе.

  • Обратите внимание на то, что таблицы в отчете включают только короткие метки ссылок. Это те же метки строки, которые вы видите в меню контекста объекта и в диалоговом окне Link Editor.

Отчет требований со вставленным содержимым документов

  • Когда целевое местоположение в Microsoft Word является подзаголовком, дочернее содержимое включено в сгенерированный отчет. Используйте эту функцию с осторожностью: соединение с главным подзаголовком в документе могло означать, что большие суммы текста копируются с документа в отчет.

  • Когда целевое местоположение является областью значений ячеек в Microsoft Excel, целевой фрагмент рабочего листа вставляется в отчет.

  • Когда целевое местоположение является отдельной ячейкой в рабочем листе Microsoft Excel, содержимое ячеек справа от целевой ячейки также вставляется в отчет.

Включайте атрибуты Rational DOORS IBM в отчет RMI

Для пользователей, соединяющихся с Rational DOORS IBM, RMI обеспечивает больше управления который атрибуты объектов включать в таблицы требований.

  • Настройка по умолчанию будет включать Заголовок Объекта DOORS, текст Объекта DOORS и все другие атрибуты кроме: "Созданный Через", все атрибуты со значениями пустой строки и системные атрибуты, которые являются ложными.

  • Список названий атрибута, чтобы включать в сгенерированный отчет хранится как часть настроек RMI при пользователе prefdir.

  • Используйте утилиту RptgenRMI.doorsAttribs, чтобы включать/исключать определенные атрибуты и/или группы атрибутов.

current_settings = RptgenRMI.doorsAttribs('show')
help RptgenRMI.doorsAttribs
current_settings =

  5x1 cell array

    {'Object Heading' }
    {'Object Text'    }
    {'$AllAttributes$'}
    {'$NonEmpty$'     }
    {'-Created Thru'  }

 RESULT = RptgenRMI.doorsAttribs(ACTION, ARG)
  API for selecting which DOORS attributes to include in generated
  requirements report when the "Include details from linked documents"
  option in the Requirements Settings is enabled.
 
  Returned RESULT indicates whether the current setting was modified,
  except for the 'show' action, where RESULT is a cell array of the
  currently configured items.
  
  'add' and 'remove' ACTIONS allow you to add or remove attribute named ARG
 
  Use TYPE actions to include/exclude groups of attributes. Valid ARG
  values are 'all', 'user' or 'none'.
 
  Attributes with empty string values are skipped by default to save space
  in generated requirements tables. Use the 'nonempty' ACTION to set the 
  empty value filter 'on' or 'off' for user-defined attributes only.
 
  Use 'show' to query the currently configured set of attributes. Use
  'default' to restore the default state.
 
  Examples:
 
     >> RptgenRMI.doorsAttribs('default');
     >> RptgenRMI.doorsAttribs('show')
  
  ans = 
  
      'Object Heading'
      'Object Text'
      '$AllAttributes$'
      '$NonEmpty$'
      '-Created Thru'
 
  where macro entries are labeled with '$', explicitly added attribute
  names are prefixed with '+' and explicitly excluded attribute names are
  prefixed with a '-'.  The default configuration will include DOORS Object
  Heading, DOORS Object Text, and all other attributes, except "Created
  Thru", attributes with empty string values, and system attributes that
  are false.
 
  To limit the list of attributes to a user-defined subset:
 
     >> RptgenRMI.doorsAttribs('type', 'user')
  
  To exclude "Last Modified By" attribute:
 
     >> RptgenRMI.doorsAttribs('remove', 'Last Modified By')
 
  To include "Last Modified On" attribute, even when system attributes are
  not included as a group:
 
     >> RptgenRMI.doorsAttribs('add', 'Last Modified On')
 
  To turn OFF the "empty value" filter for user-defined attributes:
 
     >> RptgenRMI.doorsAttribs('nonempty', 'off')
 
  If the link label is always the same as the Object Heading for the target
  DOORS object and you do not want to duplicate the information in the
  report, skip the Object Heading:
 
     >> RptgenRMI.doorsAttribs('remove', 'Object Heading')

Очистка

Шаги в этом примере могут создать файлы в папке в качестве примера и изменить ваше сохраненное отображение .slmx/.req имена файлов. Щелкните к очистке.

close_system('slvnvdemo_powerwindowController', 0);  % close demo model, discard changes if any
tmpfilepath = fullfile(matlabroot, 'toolbox', 'slrequirements', 'slrequirementsdemos', 'slvnvdemo_powerwindowController.slx');
rmimap.map(tmpfilepath, 'clear');     % forget mdl-to-req mappings
clear tmpfilepath;
Removing all mapping for [MATLAB]/toolbox/slrequirements/slrequirementsdemos/slvnvdemo_powerwindowController.slx