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

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

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

open_system('slvnvdemo_fuelsys_officereq');

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

Этот пример запускается с модели, которая только имеет несколько ссылок требований. Используйте модель Analysis> Requirements Traceability> Highlight, чтобы подсветить требования. Оранжевое выделение соответствует объектам со связанными требованиями. Выделение пустой заливки для подсистем, у дочерних элементов которых есть ссылки на требования. Дважды кликните топливный блок контроллера скорости, чтобы открыть подсистему и рассмотреть дочерние объекты с требованиями.

open_system('slvnvdemo_fuelsys_officereq/fuel rate controller');
rmi('highlightModel', 'slvnvdemo_fuelsys_officereq');

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

Щелкните правой кнопкой по блоку вычисления Потока воздуха по топливной подсистеме контроллера скорости и выберите Requirements> оценка потока воздуха Mass наверху контекстного меню.

Это открывает соединенный документ и выбирает целевое содержимое.

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

Дважды кликните блок графика управляющей логики в топливной подсистеме контроллера скорости, чтобы открыть график. Подсвечены состояния и переходы, соединенные с требованиями. Щелкните правой кнопкой по Богатому состоянию Смеси, выберите Requirements Traceability и перейдите по ссылке наверху к связанной с представлением документации.

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

В slvnvdemo_FuelSys_DesignDescription.docx от предыдущего шага убедитесь, что элементы управления ActiveX включены: если вы видите панель Предупреждения системы безопасности во главе окна документа, нажмите Options, чтобы открыть настройки элемента управления ActiveX, выберите Enable это содержимое, нажмите OK.

Теперь найдите раздел 3,3 Разнообразными типами отказа давления в документе и дважды кликните значок Simulink в конце подзаголовка. Это отображает соответствующую схему Подсистемы Simulink с подсвеченным целевым объектом. Закройте все окна модели и повторную навигацию из документа. Схемы или графики открыты по мере необходимости, пока образцовый файл может быть расположен.

Создание новых ссылок

Чтобы избежать непреднамеренной модификации к документам требований, настройка по умолчанию не должна вставлять значки ActiveX в документы. Созданные ссылки позволяют навигацию от Simulink до документов, но не в другом направлении. Чтобы сконфигурировать ваши настройки для создания двунаправленных ссылок, сделайте следующее:

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

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

Ссылки требований в блоках Signal Builder

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

Генерация отчета требований

Выберите Analysis> Requirements Traceability> отчет Generate автоматически сгенерировать отчет относительно всех ссылок требований в модели. Отчет по умолчанию сгенерирован согласно шаблону, который включен с продуктом.

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

К подмножеству опций также получают доступ через вкладку Report диалогового окна Analysis> Requirements Traceability> Settings. Например, можно хотеть отключить Подсветку модель прежде, чем сгенерировать флажок отчета, если получившийся отчет будет распечатан в черно-белых тонах или рассмотрен через проектор, или можно хотеть включать списки объектов, которые не имеют никаких ссылок на требования.

Проверка непротиворечивости требований

Используйте Model Advisor, чтобы автоматически обнаружить и зафиксировать несоответствия в данных о ссылках требований. Нажмите Analysis> Requirements Traceability> Check Consistency... пункт меню, чтобы поднять Model Advisor только с активированными контрольными точками RMI. Ссылки проверяются на недостающие документы, несопоставленные местоположения в документах, несопоставленные метки для основанных на выборе ссылок и противоречивую информацию о пути.

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

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

Нажмите Fix, или Update in Model Advisor сообщают, чтобы автоматически решить, сообщили несоответствия. Повторно выполните проверки, чтобы гарантировать, что проблема, о которой сообщают, разрешена.

Фильтрация требований к пользовательскому свойству тегов

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

Вы можете дальнейшее использование эти теги, чтобы фокусировать вашу работу над подмножеством ссылок или автоматически лишить подмножество ссылок из модели. Этим управляют через вкладку Filters диалогового окна Analysis> Requirements Traceability> Settings.

Когда образцовые требования "подсвечены", изменение установки фильтра обновляет представление, чтобы только показать соответствующие ссылки требований. Ссылки требований в этой модели в качестве примера помечены с одним из следующего: "проект", "требование", "тест". Представление настраивает соответственно, когда вы изменяете настройки фильтра. Например, требования Подсветки, которые помечены "проект".

Подсветите требования, которые помечены "требование".

Подсветите требования, которые помечены "тест".

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

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

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

Это иногда происходит, в который документы должны быть переименованы или перемещены после того, как ссылки были созданы. Например, если Microsoft Word 2007 не доступен при испытании этого примера, необходимо использовать ".doc" версии документов требований, которые также включены с этой установкой. Однако все ссылки в модели в качестве примера указывают на ".docx" версии документов требований. Используйте rmidocrename утилиту командной строки, чтобы одновременно настроить все ссылки в модели.

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

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

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

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

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

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

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

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

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

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

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