Открыть пример модели

Функции управления требованиями демонстрируются на примере модели отказоустойчивой системы управления топливом. Эту модель можно открыть путем анализа следующего кода.

open_system('slvnvdemo_fuelsys_officereq');

Настройка диспетчера требований для работы со ссылками

Если в какой-либо момент времени в этом примере изменить выбор на «Требования» в выпадающем меню «Вид» в браузере «Требования», будут изменены кнопки, которые вы можете видеть, и вы не сможете правильно следовать инструкциям без возврата к разделу «Ссылки».

Просмотр существующих требований

Этот пример начинается с модели с несколькими связями требований. На вкладке Требования (Requirements) щелкните Выделить связи (Highlight Links), чтобы выделить блоки со ссылками требований или оценить следующий код.

rmi('highlightModel', 'slvnvdemo_fuelsys_officereq');

Выделение оранжевого цвета соответствует объектам со связанными требованиями. Выделение пустой заливки предназначено для подсистем, дочерние компоненты которых имеют ссылки на требования. Дважды щелкните значок fuel rate controller чтобы открыть подсистему и просмотреть дочерние объекты с требованиями, или оценить следующее.

open_system('slvnvdemo_fuelsys_officereq/fuel rate controller');

Перейти к документу

Щелкните правой кнопкой мыши Airflow calculation блок в fuel rate controller и выберите в контекстном меню «Требования» > «Оценка массового воздушного потока».

Откроется связанный документ и будет выбрано целевое содержимое. Также можно проанализировать следующий код: rmidemo_callback('view','slvnvdemo_fuelsys_officereq/fuel rate controller/Airflow calculation',1)

Ссылки на требования в диаграммах потока состояний

Дважды щелкните значок control logic блок диаграммы в fuel rate controller для открытия диаграммы. Если его не удается найти, оцените следующий код.

rmidemo_callback('locate','slvnvdemo_fuelsys_officereq/fuel rate controller/control logic');

Выделяются состояния и переходы, связанные с требованиями. Щелкните правой кнопкой мыши Rich Mixture выберите «Требования» и перейдите по ссылке вверху для просмотра связанной документации. Можно также вычислить следующий код: rmidemo_callback('view','slvnvdemo_fuelsys_officereq/fuel rate controller/control logic:26',1)

Переход от документа требований к объектам модели

В slvnvdemo_FuelSys_DesignDescription.docx на предыдущем шаге найдите в документе раздел 3.3 Режим отказа манифольда под давлением и дважды щелкните значок Simulink в конце подзаголовка. Отображается соответствующая схема подсистемы Simulink с выделенным целевым объектом. Закройте все окна модели и повторите навигацию из документа.

Схемы или диаграммы открываются при необходимости, пока можно найти файл модели.

Создание новых связей

Чтобы настроить настройки для создания двунаправленных ссылок, выполните следующие действия.

Теперь создайте новые ссылки, подобные тем, по которым вы только что перешли. Примечание.Microsoft Word не позволяет создавать ссылку, если документ имеет статус ReadOnly. На следующем шаге этого примера рекомендуется сохранить локальную копию документа и использовать ее вместо установленного документа.

rmidemo_callback('locate',['slvnvdemo_fuelsys_officereq/fuel rate controller/' ...
    'Airflow calculation/Pumping Constant']);

Щелкните правой кнопкой мыши Pumping Constant снова блокировать. Теперь необходимо просмотреть вновь созданную ссылку в верхней части контекстного меню. Щелкните его для перехода к цели в разделе 2.2 slvnvdemo_FuelSys_DesignDescription.docx.

Ссылки на требования в блоках построителя сигналов

Сигнальные линии связи присоединены к отдельным группам сигналов, а не к блоку Формирователя сигналов в целом. Этот тип ссылок используется для тестовых примеров, определенных как группы Signal Builder.

rmidemo_callback('locate','slvnvdemo_fuelsys_officereq/Test inputs');

rmidemo_callback('signalgroup','slvnvdemo_fuelsys_officereq/Test inputs',2)

Создание отчета по требованиям

На вкладке Требования (Requirements) щелкните Общий доступ (Share) > Создать отчет об отслеживании модели (Generate Model Traceability Report), чтобы автоматически создать отчет по всем ссылкам требований в модели или оценить следующий код. rmidemo_callback('report','slvnvdemo_fuelsys_officereq') % Generate a model traceability report

Отчет по умолчанию создается в соответствии с шаблоном, включенным в продукт.

Интерфейс генератора отчетов обеспечивает полный контроль над содержимым созданных отчетов, включая создание совершенно новых шаблонов. Доступ к нему можно получить, оценив следующее: setedit('requirements')

Подмножество опций также доступно на вкладке Требования (Requirements) в разделе Общий доступ (Share) > Параметры отчета (Report Options). Например, можно отключить флажок Подсветить модель перед созданием отчета, если результирующий отчет будет напечатан черно-белым цветом или просмотрен с помощью проектора, или можно включить списки объектов, не имеющих ссылок на требования.

Проверка согласованности требований

Используйте Model Advisor для автоматического обнаружения и устранения несоответствий в данных связей требований. Щелкните Проверить согласованность (Check Consistency) на вкладке Требования (Requirements), чтобы открыть Model Advisor с активированными только контрольными точками RMI. Ссылки проверяются на наличие отсутствующих документов, несоответствующих расположений в документах, несоответствующих меток для ссылок на основе выбора и противоречивых сведений о путях. Для открытия Model Advisor можно также оценить следующее: rmidemo_callback('check','slvnvdemo_fuelsys_officereq')

Нажмите кнопку Выполнить выбранные проверки (Run Selected Checks), чтобы проверить согласованность связей в модели. RMI автоматически откроет связанные документы и проверит непротиворечивость хранимых данных. По завершении щелкните отдельные элементы проверки, чтобы просмотреть результаты на правой панели. В этом примере одна из ссылок указывает на недопустимое расположение в документе:

Другая ссылка имеет метку, которая не соответствует исходному выделению при создании связи:

Щелкните Исправить (Fix) или Обновить (Update) в отчете Model Advisor, чтобы автоматически устранить сообщенные несоответствия. Повторите проверки, чтобы убедиться, что проблема устранена.

Требования к фильтрации для свойства тега пользователя

Ссылки требований в Simulink поддерживают дополнительное свойство User Tag, которое может хранить любые строковые значения, разделенные запятыми. Используйте эти теги, чтобы различать различные типы ссылок, например ссылки на функциональные требования, ссылки на описание конструкции или ссылки на сведения о тестировании. Можно указать теги при создании новых связей или позже с помощью диалогового окна «Открытие исходящих связей»... диалоговое окно.

Позднее эти теги можно использовать для фокусировки работы на подмножестве связей или для автоматического удаления подмножества связей из модели. Управление осуществляется с помощью вкладки Фильтры (Filters) меню Параметры требований (Requirements Settings), открываемого с помощью команды Параметры связи (Link Settings) > Параметры связи (Linking Options) на вкладке Требования (Require

Когда требования к модели подсвечиваются, изменение настройки фильтра обновляет представление так, чтобы отображались только соответствующие связи требований. Ссылки требований в этом примере модели помечены одним из следующих тегов: «design», «requirement», «test». При изменении настроек фильтра вид корректируется соответствующим образом. Например, можно выделить только ссылки с тегами «requirement».

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

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

Обновление всех ссылок при перемещении или переименовании документов требований

Иногда после создания ссылок документы необходимо переименовать или переместить. Использовать rmidocrename утилита командной строки для одновременной корректировки всех связей в модели.

help rmidocrename

 RMIDOCRENAME Update model requirements document paths and file names.
    RMIDOCRENAME(MODEL_HANDLE, OLD_PATH, NEW_PATH)
    RMIDOCRENAME(MODEL_NAME, OLD_PATH, NEW_PATH)
    
    RMIDOCRENAME(MODEL_HANDLE, OLD_PATH, NEW_PATH) collectively
    updates the links from a Simulink(R) model to requirements files whose
    names or locations have changed. MODEL_HANDLE is a handle to the
    model that contains links to the files that you have moved or renamed.
    OLD_PATH is a string that contains the existing file name or path or 
    a fragment of file name or path.
    NEW_PATH is a string that contains the new file name, path or fragment.
 
    RMIDOCRENAME(MODEL_NAME, OLD_PATH, NEW_PATH) updates the
    links to requirements files associated with MODEL_NAME. You can pass
    RMIDOCRENAME a model handle or a model name string.
 
    When using the RMIDOCRENAME function, make sure to enter specific
    strings for the old document name fragments so that you do not
    inadvertently modify other links.
 
    RMIDOCRENAME displays the number of links modified.
 
    Examples:
 
        For the current Simulink(R) model, update all links to requirements
        files whose names contain the string 'project_0220', replacing 
        with 'project_0221': 
            rmidocrename(gcs, 'project_0220', 'project_0221');
        
        For the model whose handle is 3.0012, update links after all
        documents were moved from C:\My Documents to D:\Documents
            rmidocrename(3.0012, 'C:\My Documents', 'D:\Documents');
 
 
    See also RMI RMITAG

    Documentation for rmidocrename
       doc rmidocrename

open_system('slvnvdemo_fuelsys_officereq')
save_system('slvnvdemo_fuelsys_officereq','slvnvdemo_fuelsys_officereq_copy.slx')

rmidemo_callback('filter','slvnvdemo_fuelsys_officereq_copy','requirement') 

rmidemo_callback('locate',['slvnvdemo_fuelsys_officereq_copy/fuel rate controller/' ...
    'Airflow calculation/Relational Operator3'],1);

Вставка элементов управления навигацией в документы для сопоставления с односторонними ссылками

Если ранее были созданы односторонние ссылки из объектов Simulink на документы, а позже необходимо включить навигацию из расположений в документах обратно к соответствующим объектам в Simulink, используйте rmiref.insertRefs для вставки соответствующих ссылок «return» в документ требований.

Один из документов, включенных в этот пример, slvnvdemo_FuelSys_DesignDescription.doc не имеет элементов управления навигацией Simulink. Она имеет закладки в расположениях, которые соответствуют конструкции с тегами связей в модели примера.

open_system('slvnvdemo_fuelsys_officereq_copy')

rmidemo_callback('locate',['slvnvdemo_fuelsys_officereq_copy/fuel rate controller/' ...
    'Airflow calculation']);

Невозможно вставить элементы управления навигацией, если в документе отсутствует указанная закладка местоположения. В этом примере документ не был сохранен после создания последней ссылки. В окне команд появляется следующее предупреждение: именованный элемент «Simulink_requirement_item_7» не может быть расположен в закладках или заголовках разделов.

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

Удалить все ссылочные кнопки Simulink из документа

При вставке элементов управления навигацией Simulink в документ Microsoft Office перед переходом в Simulink необязательно сохранять документ. Это позволяет при необходимости временно вставлять объекты навигации. Если документ был сохранен с вставленными кнопками навигации и теперь необходимо вернуться к чистому документу, используйте rmiref.removeRefs для удаления кнопок. Например, для удаления кнопок, вставленных на предыдущем шаге этого примера, выполните следующие действия:

Восстановление ссылок из документов в Simulink

Элементы управления навигацией Simulink, встроенные в документы по требованиям, могут устареть при изменении или перемещении моделей Simulink. Это приводит к разрыву связей. Используйте rmiref.checkDoc утилита для обнаружения и восстановления ссылок из внешних документов в Simulink. В этом примере будет исправлена одна разорванная ссылка в slvnvdemo_FuelSys_DesignDescription.docx документе.

Все функциональные ссылки перечислены в нижней части отчета. Из этого отчета можно перейти к связанным объектам в Simulink (столбец Цель в Simulink) и к целевым расположениям в документе (столбец Содержимое документа).

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

Очистка

Следующий код выполняется для очистки рабочей области после выполнения примеров. Все данные требований удаляются из рабочей области, а все модели Simulink закрываются.

slreq.clear;
bdclose('all');