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

Открытая модель в качестве примера

Этот пример будет использовать Модели контроллеров Окна со стеклоподъемником, чтобы продемонстрировать, как работать с внешне сохраненными ссылками RMI. Откройте модель. В случае, если вы экспериментировали с этой моделью прежде, используйте rmimap.map(MODEL,'clear') команда, чтобы отбросить любой известный .slmx файл, сопоставляющий прежде, чем открыть модель:

rmimap.map('slvnvdemo_powerwindowController', 'clear');
open_system('slvnvdemo_powerwindowController');

Removing all mapping for [MATLAB]/toolbox/slrequirements/slrequirementsdemos/slvnvdemo_powerwindowController.slx

Сконфигурируйте RMI, чтобы сохранить ссылки внешне

Выберите Analysis> Requirements Traceability> Settings и откройте диалоговое окно Settings для вкладки Storage. Нажмите Store внешне переключатель.

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

rmipref('StoreDataExternally', true);
rmi('highlightModel', 'slvnvdemo_powerwindowController');

Создание и управление ссылки RMI

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

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

testReqLink = rmi('createEmpty');
testReqLink.description = 'testReqLink';
testReqLink.doc = 'powerwin_reqs\PowerWindowSpecification.docx';
testReqLink.id = '?passenger input consists of a vector with three elements';
rmi('set', 'slvnvdemo_powerwindowController/Mux4', testReqLink);

Сохранение требований соединяет данные с внешними файлами

При работе с моделью, которая хранит данные RMI внешне, изменения в ссылках требования сохранены когда вы:

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

close_system('slvnvdemo_powerwindowController', 0);

Загрузка ссылок требований из внешних файлов

Когда вы откроете модель, RMI попытается загрузить данные о ссылках требований из недавно используемого местоположения для этой модели. Можно также выбрать Analysis> Requirements> Links File> ссылки Load..., чтобы выбрать различный .slmx (или более старый .req) файл. Это позволяет использовать несколько наборов ссылок с той же моделью, например, ссылок на описания конструктивного изменения, которые отличаются от ссылок до спецификаций первоначального проекта.

open_system('slvnvdemo_powerwindowController');
otherReqFile = fullfile(matlabroot, 'toolbox', 'slrequirements', 'slrequirementsdemos', 'powerwin_reqs', 'slvnvdemo_powerwindowRequirements.req');
rmimap.map('slvnvdemo_powerwindowController', otherReqFile);
rmi('highlightModel', 'slvnvdemo_powerwindowController');

Mapping [MATLAB]/toolbox/slrequirements/slrequirementsdemos/slvnvdemo_powerwindowController.slx to [MATLAB]/toolbox/slrequirements/slrequirementsdemos/powerwin_reqs/slvnvdemo_powerwindowRequirements.req

Движущиеся ссылки RMI с внутреннего на внешнее устройство хранения данных

Модель с существующими встроенными ссылками требований может быть преобразована во внешнее устройство хранения данных. Соединитесь данные больше не будут храниться в .slx файле, но в новом .slmx файл. Испытать это:

Ваша способность использовать и управлять ссылками в этой модели теперь зависит от внешнего файла.

Точки, чтобы иметь в виду, прежде чем вы переместите внутренне сохраненные ссылки на внешний файл:

open_system('slvnvdemo_fuelsys_officereq')
tempModelName = 'fuelsys_officereq_copy';
tempModelCopy = fullfile(tempdir, [tempModelName '.slx']);
save_system('slvnvdemo_fuelsys_officereq', tempModelCopy);
tempLinkFile = strrep(tempModelCopy, '.slx', '_links.slmx');
rmidata.saveAs(tempModelName, tempLinkFile);
rmi('highlightModel', tempModelName);

Движущиеся ссылки RMI с внешнего на внутреннюю память

Чтобы встроить данные RMI с моделью Simulink, так, чтобы вся информация была в одном месте и вы не должны отслеживать дополнительные файлы, выбрать Analysis> Requirements> Links File> Copy to Model. Внешний .slmx файл все еще существует, но он НЕ читается, когда вы вновь открыли модель, которая теперь встроила данные RMI. Можно испытать это с fuelsys_officereq_copy модель.

Точки, чтобы иметь в виду, прежде чем вы встроите данные RMI с файлом модели:

Очистка

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

close_system('slvnvdemo_powerwindowController', 0);  % close demo model, discard changes
tmpfilepath = fullfile(matlabroot, 'toolbox', 'slrequirements', 'slrequirementsdemos', 'slvnvdemo_powerwindowController.slx');
rmimap.map(tmpfilepath, 'clear');     % forget mdl-to-req mappings
tmpfilepath = strrep(tmpfilepath, '.slx', '.slmx');
if exist(tmpfilepath, 'file') == 2, delete(tmpfilepath); end   % delete links file

close_system('fuelsys_officereq_copy', 0);
rmimap.map(tempModelCopy, 'clear');     % forget model to Links File mappings
if exist(tempModelCopy,'file') == 2, delete(tempModelCopy); end    % delete temporary copy of model file
if exist(tempLinkFile, 'file') == 2, delete(tempLinkFile); end   % delete .req file we just saved

clear tmpfilepath tempModelCopy tempLinkFile;

rmiut.closeDlg(getString(message('Slvnv:reqmgt:highlightObjectsWithReqs')));  % close popup if still open

Removing all mapping for [MATLAB]/toolbox/slrequirements/slrequirementsdemos/slvnvdemo_powerwindowController.slx
Removing all mapping for /tmp/BR2019bd_1170825_64229/publish_examples0/fuelsys_officereq_copy.slx