IBM® Rational® DOORS® Next Generation (DNG) является инструментом управления требований для IBM Рациональная Джазовая платформа. Соединение основанных на файле артефактов MBD (Блоки Simulink, Тесты, Записи в словаре данных) с элементами, управляемыми разделяемым сервером и, получило доступ через веб-клиент, требует определенных шагов configurtion, прежде чем можно будет создать новые ссылки. Этот пример обеспечивает постепенную демонстрацию функции интеграции DNG в Simulink Requirements.
Можно соединиться непосредственно с артефактами DNG, с помощью ярлыка контекстного меню Link to Selected Item in DNG в меню Requirements. Это требует значительных издержек, потому что вы получаете доступ к DNG использование клиента веб-браузера, и ссылки требуют уведомления, о котором является "выбранным пунктом". Следующие несколько разделов этого примера показывают вам, как настроить вашу среду для прямого соединения с DNG.
Скопируйте Джазовый сервер dngsllink_config подпапка в MATLAB_INSTALL_DIR/toolbox/slrequirements/slrequirements/resources/ в пользовательскую папку расширений сервера DNG. Местоположение пользовательской папки расширений зависит от конкретной Джазовой версии сервера:
Например, если вы запускаете Джазовую версию сервера 6.0.6, ваша папка расширений может быть здесь:
C:\Program Files\IBM\JazzTeamServer_6.0.6\server\liberty\servers\clm\dropins\war\extensions
Вы, возможно, также должны "включить dropins" в настройке сервера DNG. См. инструкции DNG для деталей:
https://jazz.net/wiki/bin/view/Main/RMExtensionsHostingGuide605
Необходимо отредактировать server.xml файл в C:\[JAZZ_INSTALL_DIR]\server\liberty\servers\clm папка.
1. Откройте этот файл в текстовом редакторе и найдите эту линию:
<applicationMonitor dropinsEnabled='false' pollingRate='10s' updateTrigger='mbean'/>
2. измените dropinsEnabled к 'true'.
3. Перезапустите сервер. Ниже снимок экрана из инструкции IBM:
Однажды dngsllink_config пользовательское расширение доступно на вашем сервере DNG, каждый пользователь заинтересовал соединением с DNG, должен добавить этот пользовательский виджет к Мини-Инструментальной панели в клиентском браузере DNG. После логгирования в DNG:
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:
Используйте slreq.dngConfigure commad, чтобы подготовить ваш сеанс работы с MATLAB к соединению с DNG. Следуйте за подсказками и введите требуемые значения. Сервер URL, номер порта и имя пользователя хранится в ваших настройках индивидуального пользователя. Однако необходимо ввести пароль DNG каждый раз.
1. Когда запрошено, введите свое доменное имя сервера DNG и номер порта. Если вы не видите номера порта, отображенного в строке поиска вашего системного браузера при просматривании страниц DNG введите значение по умолчанию "443".
2. Введите свое имя пользователя DNG, которое может отличаться от вашего компьютерного имени зарегистрированного пользователя:
3. Когда запрошено, введите свой пароль DNG и нажмите Enter. После связи с сервером список доступных проектов DNG является retrived.
4. Выберите поток настройки и проект. Нормально видеть некоторые предупреждения в командном окне MATLAB при установлении связи с DNG. Функция будет действовать, если не будут ошибки.
5. browser-to-localhost связь тестовые прогоны автоматически. Этот канал связи требуется для вашего сеанса MATLAB® получить сообщения, когда вы взаимодействуете с DNG в системном браузере. Всплывающее окно указывает, что вы готовы к соединению:
6. Если вы не видите подтверждающее сообщение как показано выше, возможно, что ваш системный браузер блокирует связи HTTPS с localhost. Чтобы разрешить это, позвольте связь. Точные шаги зависят от вашего браузера. Например:
В этом случае нажмите Advanced и затем кликните по гиперссылке, чтобы позволить связь:
Когда вы получаете всплывающее окно подтверждения, оно подтверждает, что ваш экземпляр браузера может связаться с прослушивателями HTTPS на вашей машине. Лучше снова использовать это то же окно браузера для вашего сеанса DNG, при соединении с Simulink Requirements.
7. Протестировать ваш браузер, не повторно выполняя slreq.dngConfigure процедура, вставьте следующий URL в строку поиска своего broser: https://localhost:31515/matlab/oslc/inboundTest
В DNG открытые артефакты Показа просматривают для набора требований интереса и устанавливают флажок для элемента, с которым вы хотите соединиться. Вы заметите, что виджет Simulink Requirements обновляется, чтобы подтвердить ID и метку выбранного пункта. Эта информация отправляется MATLAB, когда вы взаимодействуете с флажками элемента DNG.
В Simulink щелкните правой кнопкой по блоку, который вы хотите соединить от, затем выбрать Link to Selected Item in DNG под контекстным меню Requirements. Это делает, занимают несколько секунд для MATLAB, чтобы получить дополнительные данные от DNG и создать ссылку.
Кликните по тому же блоку снова, чтобы видеть новую ссылку наверху подменю Requirements. Кликните по метке ссылки, чтобы перейти от Simulink до DNG:
Примечание: если вы не видите Ссылку на Выбранный пункт (пункты) в ярлыке DNG в контекстном меню Requirements, вы, возможно, должны включить DOORS, соединяющие опцию во вкладке Selection Linking диалогового окна Настроек Требований:
В качестве альтернативы можно управлять этой установкой через API командной строки:
rmipref('SelectionLinkDoors',true);
Функция интеграции DNG в Simulink Requirements позволяет вам запрашивать ссылки MATLAB/Simulink от контекста DNG. Когда вы выбираете элемент из списка артефактов на странице DNG, информации об отображениях виджета Simulink Requirements о выбранном пункте, и обеспечивает гиперссылку для запроса ссылок, как сохранено в Simulink Requirements. Нажмите Query Links from SL, чтобы получить всплывающее окно со списком входящих ссылок для выбранного элемента DNG.
Нужно иметь в виду, что эти ссылки не могут быть обнаружены, когда MATLAB не запускается, или когда соответствующие файлы данных не загружаются на стороне Simulink. Например, ссылка, которую мы создали выше, хранится в .slmx файл для соединенной модели Simulink. Если этот .slmx файл не загружается на текущем сеансе MATLAB/Simulink, ни о каких ссылках не сообщат во всплывающем окне браузера. При доверии Ссылкам Запроса от SL, чтобы рассмотреть ссылки, важно гарантировать, что все связанные соединенные артефакты на стороне MATLAB/Simulink загружаются в текущем сеансе работы с MATLAB, и коммуникация браузера к MATLAB позволена веб-браузером. Можно рассмотреть список загруженных Наборов Ссылки путем переключения Редактора Требований в Представление ссылок (больше на этом ниже).
Если вы предпочитаете всегда находить свои ссылки MATLAB/Simulink в контексте DNG, независимом от того, запускается ли Simulink или загружаются ли соединенные артефакты MBD, у вас есть опция действительно двунаправленного соединения. Вновь откройте диалоговое окно Настроек Требований для вкладки Selection Linking и включите Изменить месту назначения для двунаправленного флажка соединения.
В качестве альтернативы можно использовать API командной строки rmipref('BiDirectionalLinking',true) переключить опцию. Если двунаправленное соединение включено, каждая новая ссылка, которую вы создаете, не только добавит запись в Наборе Ссылки Simulink Requirements, но также вставит Внешнюю ссылку на сайт от DNG, который вы видите в панели Ссылок для соединенного элемента DNG. Можно использовать гиперссылки в панели Ссылок, чтобы перейти от элемента DNG до связанных объектов в MATLAB/Simulink.
Когда включение Изменяет место назначения для двунаправленной опции соединения в Настройках Требований:
1. Каждый пользователь DNG будет видеть эти ссылки при работе с той же версией этого проекта DNG, даже если они не будут использовать Simulink или не будут иметь доступа к соединенным артефактам MBD.
2. Навигация от DNG перестанет работать, если MATLAB не запустится, и соединенный артефакт или уже загружен или может быть найден на пути MATLAB.
3. Ссылки, вставленные в DNG Simulink Requirements, не синхронизируются автоматически. Если вы удаляете ссылку на сторону Simulink, ссылки в DNG все еще существует. Необходимо удалить их вручную.
4. Эти ссылки ведут себя, как совместно использовано. Например, если пользователь Simulink, соединенный, требование DNG с блоком в его модели Simulink и пользователь Б соединили то же требование DNG с различным блоком в том же самом или некоторой другой модели Simulink, оба пользователя, будет видеть обе ссылки и обе ссылки, перейдет с соответствующим соединенным блоком, пока конец MATLAB/Simulink ссылки существует на сеансах обоих пользователей.
rmipref('BiDirectionalLinking', true);
Как видно из вышеупомянутого и прямые решения для соединения с 2 путями и с 1 путем имеют недостатки:
прямое соединение зависит от вашей способности изменить настройку сервера DNG и установить пользовательский гаджет Simulink Requirements,
прямое соединение требует, чтобы вы позволили связь HTTPS между своим системным браузером и локальным процессом MATLAB, который мог быть рассмотрен угрозой безопасности при использовании того же браузера для внешних веб-страниц,
Ссылки с 1 путем затрудняют, чтобы обнаружить со стороны DNG и наложить строгие требования к состоянию сеанса Simulink для ссылок, чтобы стать видимыми на стороне DNG,
Ссылки с 2 путями могут стать трудными справиться в больших многопользовательских проектах или при переключении между потоками DNG и changesets,
вы не можете управлять Типом ссылок от DNG до MATLAB/Simulink, ссылки всегда имеют типовую "Ссылку На" тип,
встроенный анализ в продукте Simulink Requirements не может быть применен к прямым ссылкам.
Разрешить эти ограничения и обойти большинство осложнений, Simulink Requirements offiers совершенно различная опция рабочего процесса: можно кэшировать подмножество требований DNG во внутренне управляемый Набор Simulink Requirements, затем выполнить все соединение и анализ в среде Simulink Requirements, как вы сделали бы с обычными внутренне управляемыми или импортированными записями.
Вы не сможете отредактировать содержимое DNG локально, и вы не будете сразу видеть обновления, когда полученные требования будут обновлены на сервере, но вы получаете преимущество нативной поддержки соединения между артефактами Simulink без "dirtying" серверная сторона, и можно использовать все встроенные аналитические возможности продукта Simulink Requirements, включая состояние реализации и верификации, а также изменить обнаружение удара и управление.
В Редакторе Требований нажмите Import в основном manu:
Выберите "IBM DOORS Next Generation" в селекторе Типа документа:
Как прежде, вам предложат пароль входа в систему DNG, и возможно адрес сервера DNG и имя для входа в систему, если это будет вашей начальной связью для текущего сеанса работы с MATLAB.
Селектор местоположения документа заполнит с именами всего проекта DNG, доступного на заданном сервере. Если вы выбираете Project, чтобы импортировать из, средства управления дополнительной опцией появятся:
Два различных режима поддерживаются для получения содержимого DNG в Simulink Requirements. Можно импортировать заданный модуль, включая herarchical отношения между требованиями DNG, или можно переключиться в Фильтр по режиму запроса, который производит плоский список совпадающих требований.
При использовании Фильтра по опции запроса, в большинстве случаев, вы не должны будете вводить выражение запроса вручную, но использовать диалоговое окно Конструктора запросов, чтобы сконфигурировать фильтр:
В обоих случаях вы получаете узел Импорта верхнего уровня с ID, который совпадает с именем вашего проекта DNG. Итоговый текст узла Импорта укажет на параметры, используемые при собирании данных от DNG. Можно теперь работать с импортированными элементами, как вы были бы с обычными записями в Simulink Requirements:
создайте ссылки со связанными артефактами MBD и используйте все встроенные аналитические возможности.
перейдите к исходным требованиям в DNG путем нажатия кнопки Show in Document,
обновите полученное содержимое с помощью кнопки Update from Server,
когда вы сохраняете в .slreqx файл, ссылки сохранены в соответствующий .slmx файл.
Одно essencial различие, однако, то, что вы не можете разблокировать и изменить импортированные требования: все необходимые обновления должны произойти на серверной стороне. Вы затем используете кнопку запроса Повторного выполнения в узле Импорта (или кнопку Update from Server для одного требования) к обновлениям получения по запросу - в с сервера.
Теперь, когда вы получили набор требований DNG интереса в Набор Требования и сохраненный это к .slreqx файл, вы можете легко установленная трассируемость между Требованиями и проектом, затем управлять вашими Наборами Ссылки вместе с остальной частью артефактов MBD, без affectig другие пользователи полученных требований к серверу DNG. Например, можно переключить модель проекта Simulink в вид в перспективе Требований, затем открыть импортированный набор требований DNG в браузере требований и создать ссылки перетаскивать-отбрасыванием между браузером требований и блоками в схеме Simulink. Вы будете видеть соединенные блоки, подсвеченные вместе с соединенными ссылками DNG в браузере требований.
Как со ссылками на внутренне управляемые требования, можно переключиться в Представление ссылок, чтобы получить доступ к большему количеству деталей о ссылках и отредактировать свойства ссылок, такие как Тип, Описание, Объяснение, ключевые слова и Комментарии.
Как со всеми другими ссылками Simulink Requirements, вы позволяете отображению состояния Implementation и Verification проверять, какие требования испытывают недостаток в покрытии, и который тестирует потребность, которая будет повторно выполнена или обновлена.
Когда требования DNG к серверу обновлены или удалены, вы выполняете автоматизированное обновление полученных подмножеств требований в Simulink Requirements, и вы проверяете Представление ссылок на отмеченные недействительные или неработающие ссылки, чтобы быстро идентифицировать необходимый проект или тестирующие изменения.
