Exponenta Banner

rmi

Взаимодействуйте программно с Requirements Management Interface

свернуть все на странице

Синтаксис

reqlinks = rmi('createEmpty')
reqlinks = rmi('get', object)
reqlinks = rmi('get', sig_builder, group_idx)
rmi('set', model, reqlinks)
rmi('set', sig_builder, reqlinks, group_idx)
rmi('cat', model, reqlinks)
cnt = rmi('count', object)
rmi('clearAll', object)
rmi('clearAll', object, 'deep')
rmi('clearAll', object, 'noprompt')
rmi('clearAll', object, 'deep', 'noprompt')
cmdStr = rmi('navCmd', object)
[cmdStr, titleStr] = rmi('navCmd', object)
object = rmi('guidlookup', model, guidStr)
rmi('highlightModel', object)
rmi('unhighlightModel', object)
rmi('view', object, index)
dialog = rmi('edit', object)
guidStr = rmi('guidget', object)
rmi('report', model)
rmi('report', matlabFilePath)
rmi('report', dictionaryFile)
rmi('projectreport')
rmi setup
rmi register linktypename
rmi unregister linktypename
rmi linktypelist
number_problems = rmi('checkdoc')
number_problems = rmi('checkdoc', docName)
rmi('check', matlabFilePath)
rmi('check', dictionaryFile)
rmi('doorssync', model)
[objHs, parentIdx, isSf, objSIDs] = rmi('getObjectsInModel', model)
[objName, objType] = rmi('getObjLabel', object)
rmi('setDoorsLabelTemplate', template)
template = rmi('getDoorsLabelTemplate')
label = rmi('doorsLabel', moduleID, objectID)
totalModifiedLinks = rmi('updateDoorsLabels', model)

Описание

пример

reqlinks = rmi('createEmpty') создает пустой экземпляр структуры данных ссылок требования.

пример

reqlinks = rmi('get', object) возвращается требование соединяет структуру данных для object.

reqlinks = rmi('get', sig_builder, group_idx) возвращается требование соединяет структуру данных для группы Signal Builder, заданной индексом group_idx.

пример

rmi('set', model, reqlinks) наборы reqlinks как требования соединяется для model.

rmi('set', sig_builder, reqlinks, group_idx) наборы reqlinks как требования соединяет для группы сигнала group_idx в блоке Signal Builder sig_builder.

пример

rmi('cat', model, reqlinks) добавляет ссылки требований в reqlinks к существующим требованиям соединяется для model.

cnt = rmi('count', object) возвращает количество ссылок требований для object.

rmi('clearAll', object) удаляет все ссылки требований для object.

rmi('clearAll', object, 'deep') удаляет все ссылки требований в модели, содержащей object.

rmi('clearAll', object, 'noprompt') удаляет все ссылки требований для object и не запрашивает подтверждение.

rmi('clearAll', object, 'deep', 'noprompt') удаляет все ссылки требований в модели, содержащей object и не запрашивает подтверждение.

cmdStr = rmi('navCmd', object) возвращает команду MATLAB® cmdStr используемый, чтобы перейти к object.

[cmdStr, titleStr] = rmi('navCmd', object) возвращает команду MATLAB cmdStr и заголовок titleStr это предоставляет описательный текст для object.

object = rmi('guidlookup', model, guidStr) возвращает имя объекта в model это имеет глобально уникальный идентификатор guidStr.

rmi('highlightModel', object) подсветки все объекты в родительской модели object это имеет ссылки требования.

rmi('unhighlightModel', object) удаляет выделение объектов в родительской модели object это имеет ссылки требования.

rmi('view', object, index) получает доступ к требованию, пронумерованному index в документе требований, сопоставленном с object.

dialog = rmi('edit', object) отображает диалоговое окно Requirements для object и возвращает указатель диалогового окна.

guidStr = rmi('guidget', object) возвращает глобально уникальный идентификатор для object. Глобально уникальный идентификатор создается для object если это испытывает недостаток в том.

пример

rmi('report', model) генерирует отчет Трассируемости требований в формате HTML для model.

rmi('report', matlabFilePath) генерирует отчет Трассируемости требований в формате HTML для файла кода MATLAB, заданного matlabFilePath.

rmi('report', dictionaryFile) генерирует отчет Трассируемости требований в формате HTML для словаря данных Simulink®, заданного dictionaryFile.

rmi('projectreport') генерирует отчет Трассируемости требований в формате HTML для текущего проекта. Страница верхнего уровня этого отчета имеет ссылки HTTP на отчеты для каждого элемента проекта, который имеет ассоциации трассируемости требований. Для получения дополнительной информации смотрите, Создают Отчет Трассируемости требований для Проекта.

rmi setup конфигурирует RMI для использования с вашим программным обеспечением MATLAB и устанавливает интерфейс для использования с программным обеспечением IBM® Rational® DOORS®.

rmi register linktypename указывает тип настраиваемой ссылки, заданный функциональным linktypename. Для получения дополнительной информации смотрите Регистрацию Типа Настраиваемой ссылки.

rmi unregister linktypename удаляет тип настраиваемой ссылки, заданный функциональным linktypename. Для получения дополнительной информации смотрите Регистрацию Типа Настраиваемой ссылки.

rmi linktypelist отображает список в настоящее время зарегистрированных типов ссылки. Список указывает, является ли каждый тип ссылки встроенным или пользовательским, и обеспечивает путь к функции, используемой для ее регистрации.

number_problems = rmi('checkdoc') валидность проверок ссылок на Simulink из документа требований в Microsoft® Word, Microsoft Excel® или Rational DOORS IBM. Это запрашивает название документа требований, возвращает общее количество проблем, обнаруженных, и открывает отчет HTML в веб-браузере MATLAB. Для получения дополнительной информации смотрите, Подтверждают Ссылки Требований в Документе Требований.

number_problems = rmi('checkdoc', docName) валидность проверок ссылок на Simulink из документа требований задана docName. Это возвращает общее количество обнаруженных проблем и открывает отчет HTML в веб-браузере MATLAB. Для получения дополнительной информации смотрите, Подтверждают Ссылки Требований в Документе Требований.

rmi('check', matlabFilePath) непротиворечивость проверок ссылок трассируемости сопоставлена с линиями кода MATLAB в .m файл matlabFilePath, и открывает отчет HTML в веб-браузере MATLAB.

rmi('check', dictionaryFile) непротиворечивость проверок ссылок трассируемости сопоставила со словарем данных Simulink dictionaryFile, и открывает отчет HTML в веб-браузере MATLAB.

rmi('doorssync', model) открывает диалоговое окно настроек синхронизации DOORS, где можно настроить настройки синхронизации и синхронизировать модель с открытым проектом в базе данных IBM Rational DOORS.

[objHs, parentIdx, isSf, objSIDs] = rmi('getObjectsInModel', model) возвращает список объектов Simulink, которые могут быть рассмотрены для включения в модуль суррогата Rational DOORS IBM.

[objName, objType] = rmi('getObjLabel', object) возвращает имя объекта Simulink и информацию о Типе для объекта Simulink, с которым вы соединяетесь со сторонним приложением для управления требованиями.

пример

rmi('setDoorsLabelTemplate', template) задает новый пользовательский шаблон для меток ссылок требований на Rational DOORS IBM. Шаблон метки по умолчанию содержит номер раздела и объектное достижение цели ссылки требования DOORS. Чтобы вернуться шаблон метки ссылки назад к значению по умолчанию, введите rmi('setDoorsLabelTemplate', '') в командной строке MATLAB.

template = rmi('getDoorsLabelTemplate') возвращает в настоящее время заданный пользовательский шаблон для меток ссылок требований на Rational DOORS IBM.

label = rmi('doorsLabel', moduleID, objectID) генерирует метку для ссылки требований на объект IBM Rational DOORS, заданный objectID в модуле DOORS, заданном moduleID, согласно текущему шаблону.

пример

totalModifiedLinks = rmi('updateDoorsLabels', model) обновления все требования Rational DOORS IBM соединяют метки в model согласно текущему шаблону.

Примеры

свернуть все

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

Получите ссылку требования, сопоставленную с блоком вычисления Потока воздуха в slvnvdemo_fuelsys_officereq модель в качестве примера.

slvnvdemo_fuelsys_officereq;
blk_with_req = ['slvnvdemo_fuelsys_officereq/fuel rate controller/'...
'Airflow calculation']
reqts = rmi('get', blk_with_req);

Измените описание ссылки требования.

reqts.description = 'Mass airflow estimation';

Сохраните измененное описание ссылки требования для блока вычисления Потока воздуха.

addpath(fullfile(matlabroot,'toolbox','slrequirements',...
'slrequirementsdemos','fuelsys_req_docs'))
rmi('set', blk_with_req, reqts);

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

new_req = rmi('createempty');
new_req.doc = 'fuelsys_requirements2.htm';
new_req.description = 'New requirement';

Добавьте новую ссылку требования к существующим ссылкам требований для блока вычисления Потока воздуха.

rmi('cat', blk_with_req, new_req);

Создайте отчет HTML данных о трассируемости требований в модели в качестве примера.

Создайте отчет требований HTML для slvnvdemo_fuelsys_officereq модель в качестве примера.

rmi('report', 'slvnvdemo_fuelsys_officereq');

Веб-браузер MATLAB открывается, показывая отчет.

Задайте новый шаблон метки для ссылок на требования в DOORS и метки обновления всех ссылок требований DOORS в вашей модели, чтобы соответствовать новому шаблону.

Задайте новый шаблон метки для ссылок требований на Rational DOORS IBM так, чтобы новые ссылки на объекты DOORS были помечены соответствующим ID модуля, возразили абсолютному номеру и значению 'Резервного' атрибута. 

rmi('setDoorsLabelTemplate', '%m:%n [backup=%<Backup>]');

Задайте новый шаблон метки для ссылок требований на Rational DOORS IBM и установите максимальную длину метки на (например), 200 символов. 

rmi('setDoorsLabelTemplate', '%h %200');

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

rmi('updateDoorsLabels', example_model);

Входные параметры

свернуть все

Модель Simulink или диаграмма Stateflow, с которой требования могут быть сопоставлены в виде вектора символов или указателя.

Пример: 'slvnvdemo_officereq'

Типы данных: char

Объект модели, с которым требования могут быть сопоставлены в виде вектора символов или указателя.

Пример: 'slvnvdemo_fuelsys_officereq/fuel rate controller/Airflow calculation'

Типы данных: char

Блок Signal Builder, содержащий группу сигнала с ассоциациями трассируемости требований в виде вектора символов или указателя.

Типы данных: char

Группа Signal Builder индексирует в виде скаляра.

Пример 2

Типы данных: char

Файл кода MATLAB с ассоциациями трассируемости требований в виде пути к файлу.

Типы данных: char

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

Типы данных: char

Глобально уникальный идентификатор для объекта модели objectВ виде вектора символов.

Пример: GIDa_59e165f5_19fe_41f7_abc1_39c010e46167

Типы данных: char

Индекс требования, соединенного с объектом модели в виде целого числа.

Документ требований во внешнем приложении в виде вектора символов, который представляет одно из следующего:

  • ID модуля Rational DOORS IBM.

  • путь к документу требований Microsoft Word.

  • путь к документу требований Microsoft Excel.

Для получения дополнительной информации смотрите, Подтверждают Ссылки Требований в Документе Требований.

Пометьте для ссылок на требования в Rational DOORS IBM в виде вектора символов.

Типы данных: char

Обработайте метку по шаблону для ссылок на требования в Rational DOORS IBM в виде вектора символов.

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

%hОбъектный заголовок
%tОбъектный текст
%pПрефикс модуля
%nВозразите абсолютному номеру
%mID модуля
%PНазвание проекта
%MИмя модуля
%UДВЕРНОЙ URL
%<ATTRIBUTE_NAME>Другой атрибут DOORS вы задаете

Пример: '%m:%n [backup=%<Backup>]'

Типы данных: char

Модуль Rational DOORS IBM в виде уникального ID модуля DOORS.

Типы данных: char

Объект IBM Rational DOORS в модуле DOORS moduleIDВ виде локально уникального ID DOORS.

Типы данных: char

Выходные аргументы

свернуть все

Требование соединяет данные, возвращенные как массив структур со следующими полями:

doc

Вектор символов, идентифицирующий документ требований

id

Местоположение определения вектора символов в документе требований. Первый символ задает тип идентификатора:

Сначала
Символ		ИдентификаторПример

?

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

'?Requirement 1'

@

Названный элемент, такой как закладка в файле Microsoft Word или привязка в файле HTML

'@my_req'

#

Страница или номер изделия

'#21'

>

Номер строки

'>3156'

$

Область значений рабочего листа в электронной таблице

'$A2:C5'

linked

Булево значение, задающее, доступна ли ссылка требования для генерации отчета и выделения:

1 (значение по умолчанию). Подсветите объект модели и включайте ссылку требования в отчеты.
0
description

Вектор символов, описывающий требование

keywords

Дополнительный вектор символов, добавляющий description

reqsys

Вектор символов, идентифицирующий ссылку, вводит регистрационное имя; 'other' для встроенных типов ссылки

Команда раньше перемещалась к объекту модели по object, возвращенный как вектор символов.

Пример: rmiobjnavigate('slvnvdemo_fuelsys_officereq.slx', 'GIDa_59e165f5_19fe_41f7_abc1_39c010e46167');

Текстовое описание объекта модели со ссылками требований, возвращенными как вектор символов.

Пример: slvnvdemo_fuelsys_officereq/.../Airflow calculation/Pumping Constant (Lookup2D)

Глобально уникальный идентификатор для объекта модели object, возвращенный как вектор символов.

Пример: GIDa_59e165f5_19fe_41f7_abc1_39c010e46167

Диалоговое окно Requirements для объекта модели object, возвращенный как указатель на диалоговое окно.

Общее количество недопустимых ссылок обнаружило во внешнем документе docName.

Для получения дополнительной информации смотрите, Подтверждают Ссылки Требований в Документе Требований.

Общее количество ссылок требований DOORS обновляется с новым шаблоном метки.

Список числовых указателей, возвращенных как массив.

Индексы иерархии модели, возвращенные как массив.

Логический массив, который указывает, которому соответствуют положения списка, которому возражает Stateflow.

Независимые от сеанса идентификаторы Simulink, возвращенные как массив.

Смотрите также

| | | | |

Представленный в R2006b

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

Поддержка