Когда вы хотите перейти от Simulink® модель или из области MATLAB® код в местоположение внутри документа требований, можно добавить ссылки трассируемости требований к модели или коду.
Ссылки трассируемости требований имеют следующие атрибуты:
Описание длиной до 255 символов.
Имя пути к документу требований, например, Microsoft® Word файла или модуль в IBM® Рациональный® ДВЕРИ® база данных. (RMI поддерживает несколько встроенных форматов документов. Можно также зарегистрировать пользовательские типы документов требований. См. раздел Поддерживаемые типы документа требований.)
Указанное место внутри документа потребности, например:
Закладка
Якорь
Я бы
Номер страницы
Номер линии
Область значений камер
Ссылка на цель
Теги, которые вы задаете
Можно связать ссылки требований между следующими типами объектов модели Simulink:
Диаграммы Simulink и подсистемы
Блоки Simulink и аннотации
Функции Simulink записей в словаре данных
Группы сигналов Signal Builder
Stateflow® графики, субдиаграммы, состояния, переходы и коробки
Функции Stateflow
Линии кода MATLAB
Диспетчер Test™ Simulink тестов
Ссылки с требованиями - это структуры данных, управляемые Simulink, которые идентифицируют конкретное местоположение в документе. Вы получаете и устанавливаете ссылки на блок, используя rmi команда.
Ссылки и типы звеньев работают вместе, чтобы выполнять навигацию и управлять требованиями. The doc и id поля ссылки однозначно идентифицируют связанный элемент во внешнем документе. Оба этих значения RMI передает в навигационную команду, когда вы перемещаетесь по ссылке из модели.
Ссылки типа определяют, как ссылки создаются, идентифицируются, перемещаются и хранятся в инструменте управления требованиями. В следующей таблице описывается каждое из этих свойств.
| Свойство | Описание |
|---|---|
Registration | Имя функции, которая создает тип ссылки. RMI хранит это имя в модели Simulink. |
Label | Строка для идентификации этого типа ссылки. В редакторе исходящих ссылок эта строка появляется в раскрывающемся списке Document type для объекта Simulink или Stateflow. |
IsFile | Свойство Boolean, которое указывает, являются ли связанные документы файлами в компьютерной файловой системе. Если документ является файлом:
|
Extensions | Массив расширений файлов. Используйте эти расширения файлов в качестве опций фильтра в редакторе исходящих ссылок при нажатии кнопки Browse. Расширения файлов выводят тип ссылки на основе имени документа. Если вы зарегистрировали несколько типов ссылок для одного и того же расширения файла, то тип ссылок, который вы зарегистрировали, приобретает первый приоритет. |
LocDelimiters | Строка , содержащая список поддерживаемых разделителей навигации. Первый символ в идентификаторе требования задает тип идентификатора. Например, идентификатор может ссылаться на определенный номер страницы ( |
NavigateFcn | Коллбэк MATLAB вызывается при клике по ссылке. Функция имеет два входных параметров: поле документа и поле идентификатора ссылки: feval(LinkType.NavigateFcn, Link.document, Link.id) |
ContentsFcn | Коллбэк MATLAB вызывается при нажатии на вкладку Document Index в редакторе исходящих ссылок. Эта функция имеет один входной параметр, который содержит полный путь разрешенной функции или, если тип ссылки не является файлом, Document содержимое поля. Функция возвращает три выхода:
|
BrowseFcn | Коллбэк MATLAB вызывается при нажатии кнопки Browse в редакторе исходящих ссылок. Вам не нужна эта функция, когда тип ссылки является файлом. Функция не принимает входных параметров и возвращает один выходной аргумент, который идентифицирует выбранный документ. |
CreateURLFcn | Коллбэк MATLAB, который создает имя к требованию. Эта функция использует путь к документу или URL-адрес для создания определенного URL-адреса требования. URL-адрес требования основан на идентификаторе местоположения, заданном в третьем входном параметре. Входные параметры:
Эта функция возвращает один выходной аргумент, заданный как вектор символов. Используйте этот аргумент при переходе к требованию из сгенерированного отчета. |
IsValidDocFcn | Коллбэк MATLAB вызывается при запуске проверки согласованности требований. Функция принимает один входной параметр - полное имя для документа требований. Возвращает true, если документ может быть найден; оно возвращает false, если документ не может быть найден или имя документа недопустимо. |
IsValidIdFcn | Коллбэк MATLAB вызывается при запуске проверки согласованности требований. Эта функция принимает два входных параметров:
|
IsValidDescFcn | Коллбэк MATLAB вызывается при запуске проверки согласованности требований. Эта функция имеет три входных параметров:
|
DetailsFcn | Коллбэк MATLAB вызывается при создании отчета о требованиях с опцией Include details from linked documents. Эта функция возвращает подробное содержимое, сопоставленное с требованием, и имеет три входных параметров:
The
|
SelectionLinkFcn | Коллбэк MATLAB вызывается при использовании основанного на выборе опции меню связывания для этого типа документа. Эта функция имеет два входных параметров:
|
GetResultFcn | Коллбэк MATLAB вызывается при соединении внешних тестов с требованиями к пользовательскому файлу типа ссылки. Он используется в файле пользовательского типа ссылок и извлекает внешние результаты для интеграции со статусами верификации. Эта функция имеет один входной параметр:
Функция возвращает один выходной аргумент,
|
Можно создавать, редактировать и удалять ссылки трассируемости требований с помощью редактора исходящих ссылок. Чтобы открыть Редактор исходящих ссылок:
в редакторе Simulink щелкните правой кнопкой мыши объект модели, который имеет трассируемость требований ссылку. В контекстном меню выберите Requirements > Open Outgoing Links dialog.
в редакторе MATLAB щелкните правой кнопкой мыши в области кода, которая имеет трассируемость требований ссылку. В контекстном меню выберите Requirements > Open Outgoing Links dialog.
Откроется Редактор исходящих ссылок, как показано ниже.
В редакторе исходящих ссылок можно:
Создайте ссылки требований из одного или нескольких объектов модели Simulink или линий кода MATLAB.
Настройка информации о ссылках требований, включая указание тегов пользователей для фильтрации подсветки требований и создания отчетов.
Удалите существующие ссылки требований.
Измените сохраненный порядок требований, чтобы контролировать порядок меток в контекстных меню для связанных объектов.
На вкладке Requirements вы задаете подробную информацию о ссылке, включая:
Описание требования (до 255 слов). Если вы создаете ссылку с помощью индекса документа, если описание не существует, то имя расположения индекса становится описанием для ссылки.
Имя пути к документу требований.
Тип документа (Microsoft Word, Microsoft Excel®, IBM RATIONAL DOORS, MuPAD®HTML, текстовый файл и т.д.).
Расположение требования (текст поиска, именованное местоположение, страница или номер элемента).
Заданный пользователем тег или ключевое слово.
Вкладка Document Index доступна, только если вы указали файл в поле Document на вкладке Requirements, которая поддерживает индексацию. На вкладке Document Index RMI генерирует список местоположений в указанном документе потребности для следующих видов документов потребности:
Microsoft Word
IBM Rational DOORS
HTML файлов
MuPAD
Примечание
RMI не может создать индексы документов для PDF файлов.
Из индекса документа выберите требуемое требование из индекса документа и нажатия кнопки OK. Если описание не существует, имя расположения индекса становится описанием для ссылки.
При внесении каких-либо изменений в документ требований для загрузки вновь созданных местоположений в индекс документа необходимо щелкнуть Refresh. Во время сеанса Работы с MATLAB RMI не перезагружает индекс документа, если вы не нажмете кнопку Refresh.
