Требования управления, не изменяя файлы модели Simulink

Simulink Requirements поддерживает два различных способа хранить данные о ссылке для моделей Simulink: можно или встроить данные о ссылке в .slx файл, или можно сохранить ссылки во внешнем .slmx файл (внешний .req файл для R2017a и более ранних релизов).

Для более старых моделей Simulink в .mdl формат, встроенное устройство хранения данных не является возможным началом R2017b, необходимо или хранить данные о ссылке внешне (в отдельном .slmx файл, или необходимо обновить файл модели Simulink до .slx формат. Вам предложат обновить ваши данные, когда вы загрузите такую модель впервые после обновления до R2017b.

Встроенное устройство хранения данных облегчает совместно использовать вашу работу - вы не должны отслеживать дополнительный *.slmx файл, но это имеет недостаток, что файл модели изменяется каждый раз, когда вы добавляете, редактируете или удаляете ссылку требований. Кроме того, при использовании внешнего *.slmx файлы, можно управлять несколькими наборами ссылок требований для той же модели путем конфигурирования сеанса, чтобы загрузить один или другой .slmx файл.

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

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

rmimap.map('slvnvdemo_powerwindowController', 'clear');
open_system('slvnvdemo_powerwindowController');
Nothing to clear 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.slreqx';
testReqLink.id = '?passenger input consists of a vector with three elements';
rmi('set', 'slvnvdemo_powerwindowController/Mux4', testReqLink);

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

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

  • Сохраните или Сохраните как модель Simulink, даже если строка заголовка не указывает на несохраненные изменения.

  • Закройте модель. Вам предложат сохранить изменения ссылок если таковые имеются.

  • Используйте Сохраняют Ссылки... или Сохраняют Ссылки Как... ярлыки под подменю Analysis> Requirements> Link File.

Закройте модель. Вам предложат о ссылке, которую вы только создали. Можно сохранить файл ссылок с 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.slmx');
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.slmx

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

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

  • Откройте другую модель, которая внутренне хранила данные RMI.

  • Повторно сохраните с новым именем, чтобы создать writeable копию.

  • Выберите Analysis> Requirements> Links File> Save Links As..., чтобы открыть файловый браузер.

  • Выберите имя файла для нового внешнего .slmx файл и нажимает ОК. Модель является resaved без встроенных ссылок и нового .slmx файл

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

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

  • Необходимо будет нести дополнительный .slmx файл наряду с файлом модели.

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

  • Когда один пользователь сконфигурировал местоположение не по умолчанию или имя для .slmx файл сопоставил с моделью, другие пользователи RMI должны будут вручную выбрать ссылки Load, когда они откроют модель. Заданное местоположение сохранится в настройках каждого пользователя и не должно изменяться, если файлы не будут перемещены или переименованы снова.

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 с файлом модели:

  • Каждое изменение в ссылках RMI изменит файл модели.

  • Внешний .slmx файлы игнорируются когда .slx файл содержит данные о ссылках трассируемости.

Очистка

Шаги в этом примере могут создать файлы в папке в качестве примера и изменить ваше сохраненное отображение .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 .slmx 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/BR2020ad_1302590_239645/publish_examples0/fuelsys_officereq_copy.slx