Соедините с требованиями в IBM DOORS затем

В этом примере показано, как соединиться с требованиями в IBM® DOORS® Next® и сравнивает два способа создать ссылки. Для получения дополнительной информации смотрите Требования Импорта от IBM DOORS Затем и Требования Ссылки и Трассировки с IBM DOORS Затем.

Управление Требованиями Разработки IBM DOORS Затем (раньше известный как Следующее поколение DOORS или DNG) является инструментом управления требований в IBM Совместная платформа управления жизненным циклом. Трассируемость основанных на файле артефактов MBD (Блоки Simulink, Тесты, Записи в словаре данных) с элементами, управляемыми на разделяемом сервере и, получила доступ посредством веб-браузера, может быть выполнен несколькими различными способами. Ваш выбор рабочего процесса будет зависеть от потребностей и ограничений данного проекта. Этот пример дает анализ DOORS Следующие функции интеграции, поддержанные Simulink Requirements, он включает постепенную инструкцию по настройке и сравнивает альтернативные рабочие процессы. Работа с IBM® DOORS® Next® поддерживается на Microsoft Windows®.

Обзор

Simulink Requirements позволяет двум различным способам объединяться с DOORS: прямое соединение между элементами дизайна и веб-требованиями и живым кэшем приближается, где вы устанавливаете трассируемость исходно в рабочей области Simulink Requirements. Каждый подход имеет уникальные преимущества и проблемы.

Прямое Соединение подхода позволяет устанавливать навигацию с одним нажатием кнопки от вашего проекта до связанных требований в DOORS, и от требований DOORS назад к соединенным элементам дизайна. Поскольку этот подход требует взаимодействий системного веб-браузера, настройка серверной стороны DOORS необходима, а также системная настройка браузера пользователем. Поскольку места назначения ссылки являются 'внешними' к Simulink Requirements, можно только использовать ограниченное подмножество функций продукта Simulink Requirements. Например, дополнительные сценарии будут требоваться для анализа состояния Implementation и Verification, и для Отслеживания изменений. С другой стороны, у вас есть выбор хранить информацию ссылки в серверных данных DOORS, так, чтобы ссылки могли просматриваться и анализироваться на стороне DOORS без сеанса MATLAB/Simulink.

Живой подход Кэша использует импорт снимка состояния Требований DOORS в Simulink Requirements. Навигация из проекта или теста к связанному требованию в DOORS все еще возможна, но вовлекает промежуточную запись прокси в набор Simulink Requirements. Поскольку оба конца ваших созданных ссылок принадлежат областям семейства Simulink, можно в полной мере воспользоваться функциями трассируемости в продукте Simulink Requirements. Кэшируемое содержимое может быть обновлено в любое время, когда существуют изменения на серверной стороне DOORS. Кроме того, потому что ссылки хранятся только на стороне MATLAB/Simulink, этот подход избегает проблем устаревших или конфликтных ссылок на сервер. Этот подход делает не, обязательно требует настройки серверной стороны.

Детали ниже помогут вам решить, какой подход является лучшим для вашего проекта.

Прямое соединение

Можно соединить непосредственно с DOORS Следующие артефакты, с помощью Ссылки на Выбранный пункт (пункты) в ярлыке DNG в меню Requirements для объектов Simulink, коде MATLAB или Случаях Simulink Test. Эта возможность подразумевает, что сеанс работы с MATLAB знает о вашем выборе в DOORS Следующий веб-браузер, который является, почему требуются дополнительные шаги настройки:

  1. Simulink Requirements пользовательские файлы виджета должен быть скопирован в DOORS Следующий сервер, чтобы сделать виджет доступным для DOORS Следующие пользователи.

  2. Каждый пользователь заинтересовал соединением с Simulink, должен добавить виджет в Мини-Инструментальную панель в DOORS Следующий веб-интерфейс.

  3. Системному браузеру нужно позволить связаться со встроенным сервером HTTPS MATLAB (localhost:31515).

Каждый необходимый шаг настройки детализирован ниже.

Настройка серверной стороны

Этот шаг выполняется DOORS Следующий администратор сервера однажды на установку сервера IBM. Необходимо будет скопировать dngsllink_config подпапка от MATLAB_INSTALL_DIR/toolbox/slrequirements/slrequirements/resources/ в DOORS пользовательская папка расширений Следующего сервера. Местоположение пользовательской папки расширений зависит от конкретной Джазовой версии сервера. Например, если вы запускаете Джазовый сервер на компьютере Windows, ваша папка расширений могла бы быть здесь:

C:\Program Files\IBM\JazzTeamServer\server\liberty\servers\clm\dropins\war\extensions

Вы, возможно, также должны "включить dropins" в DOORS Следующая настройка сервера. Инструкция ниже основана на странице следующей IBM: https://jazz.net/wiki/bin/view/Main/RMExtensionsHostingGuide605

  1. Найдите server.xml файл в C:\[JAZZ_INSTALL_DIR]\server\liberty\servers\clm папка.

  2. Откройте этот файл в текстовом редакторе и найдите эту линию: <applicationMonitor dropinsEnabled='false' pollingRate='10s' updateTrigger='mbean'/>

  3. Измените dropinsEnabled к 'true'.

  4. Перезапустите сервер.

Обратитесь к странице IBM для более подробных инструкций для хостинга пользовательских расширений.

Клиентская настройка браузера

Этот шаг должен быть выполнен однажды каждым DOORS Следующий пользователь, заинтересованный соединением с MATLAB/Simulink. После dngsllink_config пользовательские дополнительные файлы доступны на ваших DOORS Следующий сервер, выполняют эти шаги, чтобы добавить этот пользовательский виджет в Мини-Инструментальную панель в DOORS Следующий веб-интерфейс. Убедитесь, что ваши DOORS, Следующий сервер безопасен (HTTPS) или виджет, не будут функционировать правильно. После логгирования в DOORS Затем:

1. В Мини-Инструментальной панели нажмите кнопку Add Widget:

Пользовательское меню гаджетов откроется.

2. Нажмите Add OpenSocial Gadget:

3. Задайте URL, который совпадает с местоположением кода виджета Simulink Requirements по вашему серверу. Например:

https://JAZZSERVERNAME:9443/extensions/dngsllink_config/dngsllink_config.xml:

4. Нажмите Add Widget. Ваша Мини-Инструментальная панель должна теперь отобразить виджет Simulink Requirements:

Конфигурирование сеанса работы с MATLAB

Этот шаг должен быть выполнен каждый раз, когда сеанс работы с MATLAB перезапущен. Используйте slreq.dngConfigure команда, чтобы подготовить ваш сеанс работы с MATLAB к соединению с DOORS Затем. Следуйте за подсказками и введите требуемые значения. Сервер URL, номер порта и имя пользователя хранится в ваших настройках индивидуального пользователя. Однако необходимо войти в ДВЕРИ Следующий пароль каждый раз.

1. Когда запрошено, войдите в свои ДВЕРИ Следующее доменное имя сервера и номер порта. Если вы не видите номера порта, отображенного в строке поиска вашего системного браузера при просматривании Следующих страниц DOORS введите значение по умолчанию "9 443".

2. Войдите в свои ДВЕРИ Следующее имя пользователя, которое может отличаться от вашего компьютерного имени зарегистрированного пользователя:

3. Когда запрошено, войдите в свои ДВЕРИ Следующий пароль и нажмите Enter. Нормально видеть несколько предупреждений в командном окне MATLAB при установлении связи с DOORS Затем. Функция будет действовать, если не будут ошибки.

4. После того, как успешная связь с сервером устанавливается, диалоговое окно, кажется, позволяет вам, выбирают DOORS Next проекты из списка, а также предпочтительный поток настройки (если включено для выбранного проекта).

5. browser-to-localhost связь тестовые прогоны автоматически. Этот канал связи требуется для вашего сеанса работы с MATLAB получить сообщения, когда вы выбираете элемент DOORS Next в веб-браузере. Можно видеть пустую страницу браузера и всплывающее окно из MATLAB, указывающего, что вы готовы к соединению:

6. Если вы не видите подтверждающее сообщение как показано выше, ваш системный браузер может блокировать связи HTTPS с https://localhost:31515. Чтобы решить этот вопрос, позвольте связь. Точные шаги зависят от вашего веб-браузера. Например:

В этом случае нажмите Advanced и затем кликните по гиперссылке, чтобы позволить связь:

Если вы все еще не получаете всплывающее окно от MATLAB, ваш сеанс работы с MATLAB может слушать на различном номере порта (не по умолчанию), который может произойти при запуске больше чем одного экземпляра MATLAB на том же хосте. Чтобы быстро проверять номер активного порта, запустите эту команду: connector.securePort. Если эта команда возвращает что-нибудь кроме 31 515, убедитесь, что у вас нет никаких других экземпляров MATLAB, работающих на том же хосте, то перезапустите MATLAB. Повторите connector.securePort команда, чтобы подтвердить правильный номер порта. Повторно выполните slreq.dngConfigure установите шаги.

Если вы видите диалоговое окно подтверждения, не закрывайте окно браузера. Лучше снова использовать это то же окно браузера для ваших DOORS Следующий сеанс при соединении с Simulink Requirements, потому что вы только что разрешили этот экземпляр приложения веб-браузера связываться с MATLAB. Если вы открываете новое окно браузера, в зависимости от типа веб-браузера и версии, безопасная связь с MATLAB может быть блокирована снова. Если это происходит, вы можете просто вставка копии следующий URL в строку поиска вашего браузера: https://localhost:31515/matlab/oslc/inboundTest затем, снова, нажмите на "Proceed to localhost", чтобы позволить связь с MATLAB.

Односторонние Ссылки от MATLAB/Simulink до DOORS Затем

В DOORS Затем открываются, Показывают представление артефактов для набора требований интереса и устанавливают флажок для элемента, с которым вы хотите соединиться. Вы заметите, что виджет Simulink Requirements обновляется, чтобы подтвердить ID и метку выбранного пункта. Эта информация отправляется в MATLAB, когда вы взаимодействуете с DOORS Следующие флажки элемента.

В Simulink щелкните правой кнопкой по блоку, который вы хотите соединить от, затем выбрать Link to Selected Item in DNG под контекстным меню Requirements. Может потребоваться несколько секунд для MATLAB, чтобы получить дополнительные данные от DOORS Затем и создать ссылку.

Кликните по тому же блоку снова, чтобы видеть новую ссылку наверху подменю Requirements. Кликните по метке ссылки, чтобы перейти от Simulink до DOORS Затем:

Примечание: если вы не видите Ссылку на Выбранный пункт (пункты) в ярлыке DNG в контекстном меню Requirements, вы, возможно, должны включить DOORS, соединяющие опцию во вкладке Selection Linking диалогового окна Настроек Требований:

В качестве альтернативы можно управлять этой установкой через API командной строки:

rmipref('SelectionLinkDoors',true);

Рассмотрение Ссылок MATLAB/Simulink от DOORS Следующая Сторона

DOORS Следующая функция интеграции в Simulink Requirements позволяют вам запрашивать ссылки MATLAB/Simulink от DOORS Следующий контекст. Когда вы выбираете элемент из списка артефактов в Следующей странице DOORS, информации об отображениях виджета Simulink Requirements о выбранном пункте, и обеспечивает гиперссылку для запроса ссылок, как сохранено в Simulink Requirements. Нажмите Query Links from SL, чтобы получить всплывающее окно со списком входящих ссылок для выбранных DOORS Следующий элемент.

Нужно иметь в виду, что эти ссылки не могут быть обнаружены, когда MATLAB не запускается, или когда соответствующие файлы данных не загружаются на стороне Simulink. Например, ссылка, которую мы создали выше, хранится в .slmx файл для соединенной модели Simulink. Если этот .slmx файл не загружается на текущем сеансе MATLAB/Simulink, ни о каких ссылках не сообщат во всплывающем окне браузера. При доверии Ссылкам Запроса от SL, чтобы рассмотреть ссылки, необходимо сначала гарантировать что:

  1. MATLAB запускается

  2. Сеанс работы с MATLAB сконфигурирован для DOORS, Затем соединяющихся (slreq.dngConfigure шаг был завершен),

  3. загружаются все связанные соединенные артефакты проекта

Можно рассмотреть список загруженных Наборов Ссылки путем открытия Редактора Требований путем ввода slreq.editor в командной строке MATLAB. В Редакторе Требований нажмите Show Links.

Сохраните ссылки в DOORS затем для двухсторонней трассируемости

Если вы предпочитаете всегда находить свои ссылки MATLAB/Simulink в DOORS Следующим контекстом, независимым от того, запускается ли Simulink или загружаются ли соединенные артефакты MBD, у вас есть опция действительно двунаправленного соединения. Вновь откройте диалоговое окно Настроек Требований для вкладки Selection Linking и включите Изменить месту назначения для двунаправленного флажка соединения.

В качестве альтернативы можно использовать API командной строки rmipref('BiDirectionalLinking',true) переключить опцию. Если двунаправленное соединение включено, каждая новая ссылка, которую вы создаете, не только добавит запись в Наборе Ссылки Simulink Requirements, но также вставит Внешнюю ссылку на сайт от DOORS Затем, которые вы видите в панели Ссылок для соединенных DOORS Следующий элемент. Можно использовать гиперссылки в панели Ссылок, чтобы переместиться от DOORS по Следующему элементу к связанным объектам в MATLAB/Simulink.

Когда включение Изменяет место назначения для двунаправленной опции соединения в Настройках Требований, рассматривает следующее:

1. Каждый DOORS Следующий пользователь будет видеть эти ссылки при работе с той же версией этого DOORS Следующий проект, даже если они не будут использовать Simulink или не будут иметь доступа к соединенным артефактам MBD.

2. Навигация от DOORS Затем перестанет работать, если MATLAB не запустится, и соединенный артефакт или уже загружен или может быть найден на пути MATLAB.

3. Ссылки, вставленные в DOORS Затем Simulink Requirements, не синхронизируются автоматически. Если вы удаляете ссылку на сторону Simulink, ссылка в DOORS Затем остается, и необходимо удалить его вручную.

4. Продукт Simulink Requirements не проверяет на конфликты в DOORS, Затем соединяется. Например, если пользователь Simulink соединенный DOORS, Следующее требование с блоком в модели Simulink, ссылки, вставленные в DOORS Затем, будет последовательно вести себя для этого пользователя, но пользователь Б будет видеть ссылку от DOORS Затем и может переместиться по ней с тем же блоком в его версии той же модели Simulink, даже если его копия модели Simulink не хранит ссылку от блока Simulink до DOORS Затем. Если пользователь Б решит создать свою собственную ссылку от того же блока до тех же DOORS Следующий элемент, в то время как его персональная настройка сконфигурирована для двунаправленного соединения, это вставит дублирующуюся ссылку на DOORS Следующая сторона. Если пользователь более позднее передумало и удалило ссылку от блока до Simulink, и затем пробует к очистке обратные ссылки от DOORS Затем, обе ссылки должны будут быть удалены на DOORS Следующая сторона, и теперь пользователя Б оставят только с односторонней ссылкой от Simulink до DOORS Затем. Используя персональные потоки и changesets в DOORS Затем должен минимизировать этот вид проблем.

rmipref('BiDirectionalLinking', true);

Работа с кэшируемыми наборами требований

Как видно из вышеупомянутого и прямые решения для соединения с 2 путями и с 1 путем имеют недостатки:

  • прямое соединение требует, чтобы вы изменили DOORS Следующая настройка сервера и установили Simulink Requirements пользовательский гаджет,

  • прямое соединение требует связи HTTPS между вашим системным браузером и локальным процессом MATLAB, который мог представить угрозу безопасности при использовании этого того же браузера для внешних веб-страниц,

  • Ссылки с 1 путем затрудняют, чтобы обнаружить от DOORS Следующую сторону и полностью скрыты, если соединенные артефакты не загружаются в текущем сеансе работы с MATLAB,

  • Ссылки с 2 путями могут стать трудными справиться в больших многопользовательских проектах или при переключении между DOORS Следующих потоков и changesets,

  • вы не можете управлять Типом ссылок от DOORS Рядом с MATLAB/Simulink, ссылки всегда имеют типовую "Ссылку На" тип,

  • встроенный анализ в продукте Simulink Requirements не покрывает прямые ссылки.

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

Вы не сможете отредактировать кэшируемые DOORS Следующее содержимое локально, и вы не будете сразу видеть обновления, когда полученные требования будут обновлены на сервере, но вы получаете преимущество нативной поддержки соединения между артефактами Simulink, включая перетаскивать-отбрасывание, соединяющееся с объектами Simulink, не нарушая серверную сторону, и можно использовать все функции продукта Simulink Requirements для рассмотрения и анализа ссылок, включая состояние реализации и верификации, а также изменить обнаружение удара и управление.

Получите DOORS следующие наборы в набор Simulink Requirements

В Редакторе Требований нажмите Import. Выберите "IBM DOORS Next Generation" в селекторе Типа документа:

Как прежде, вам предложат DOORS, Затем входят в систему пароль. Если это будет вашей начальной связью для текущего сеанса работы с MATLAB, вам также предложат подтвердить сервер URL и имя пользователя.

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

Два различных режима поддерживаются для получения DOORS Следующее содержимое в Simulink Requirements. Можно импортировать заданный модуль, включая иерархические отношения между DOORS Следующие требования, или можно переключиться в Фильтр по режиму запроса, который производит плоский список совпадающих требований.

При использовании Фильтра по опции запроса, в большинстве случаев, вы не должны будете вводить выражение запроса вручную, но использовать диалоговое окно Конструктора запросов, чтобы сконфигурировать фильтр:

Когда вы импортируете Фильтр использования по запросу, можно только использовать один фильтр за один раз.

В обоих случаях вы получаете узел Импорта верхнего уровня с ID, который совпадает с именем ваших DOORS Следующий проект. Итоговый текст узла Импорта укажет на параметры, используемые при собирании данных от DOORS Затем. Можно теперь работать с импортированными элементами, как вы были бы с обычными записями в Simulink Requirements:

  • создайте ссылки со связанными артефактами MBD и используйте все встроенные аналитические возможности.

  • перейдите к исходным требованиям в DOORS Затем путем нажатия на Show в кнопке документа,

  • обновите полученное содержимое с помощью кнопки Update from Server,

  • когда вы сохраняете в .slreqx файл, ссылки сохранены в соответствующий .slmx файл.

Одно существенное различие, однако, то, что вы не можете разблокировать и изменить кэшируемые требования: все необходимые обновления должны произойти на серверной стороне. Вы затем используете кнопку запроса Повторного выполнения для узла Импорта (или кнопку Update from Server для одного требования) к обновлениям получения по запросу - в с сервера.

Вы не можете импортировать изображения или таблицы от DOORS Рядом с Simulink Requirements.

Соединение с полученными DOORS следующие элементы

Теперь, когда вы получили DOORS Следующий набор требований интереса в Набор Требования и сохраненный это к .slreqx файл, вы можете легко установленная трассируемость между Требованиями и проектом, затем управлять вашими Наборами Ссылки вместе с остальной частью артефактов MBD, не влияя на других пользователей тех же DOORS Следующий проект. Например, можно переключить модель Simulink в вид в перспективе Требований, затем открыть полученный набор DOORS Следующие требования в браузере требований и создать ссылки перетаскивать-отбрасыванием между браузером требований и блоками в схеме Simulink. Вы будете видеть соединенные блоки, подсвеченные вместе с соединенными кэшируемыми DOORS Следующие элементы в браузере требований.

Рассмотрение и анализ данных о трассируемости

Как со ссылками на внутренне управляемые требования, вы можете, чтобы получить доступ к большему количеству деталей о ссылках, когда вы выбираете Links от выпадающего Представления. Можно отредактировать свойства ссылок, такие как Тип, Описание, Объяснение, ключевые слова и Комментарии.

Как со всеми другими ссылками Simulink Requirements, вы позволяете отображению состояния Implementation и Verification проверять, какие требования испытывают недостаток в покрытии, и который тестирует потребность, которая будет повторно выполнена или обновлена.

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