Добавление в Rational DOORS служб OSLC

Сообщество OSLC (Open Services for Lifecycle Collaboration) занимается стандартизацией взаимодействия между инструментами жизненного цикла. IBM® Rational DOORS поддерживает спецификацию обмена данными OSLC как поставщик для домена Requirements Management и как потребитель для других доменов из портфеля Rational.

Обмен данными OSLC между доменами строится на основе общего набора ресурсов, форматов и архитектурных служб REST.

Обмен данными поддерживает следующие транзакции:
  • Подключение по протоколу HTTP
  • Идентификация ресурсов по URI
  • Поиск информации с использованием стандартных типов носителей

Краткое руководство по Rational DOORS

В следующей таблице перечислены домены OSLC и службы, которые принимает Rational DOORS, а также разрешенные операции над ресурсами из этих доменов. Приложение Change Management V1 впервые появилось в Rational DOORS версии 9.3. Поддержка всех других доменов и служб была добавлена в Rational DOORS версии 9.4.

В следующих таблицах перечислены домены OSLC и службы, которые принимает Rational DOORS версии 9.4 и более поздних версий, а также разрешенные операции над ресурсами из этих доменов.

Табл. 1. Домены OSLC и операции с Rational DOORS
Rational DOORS 9.4 и более поздних версий Выбор Создание Предварительный просмотр (сжатый вывод)
Change Management V1 Поддерживается Поддерживается Поддерживается
Change Management V2 Поддерживается Поддерживается Поддерживается
Quality Management V1 Поддерживается Поддерживается Поддерживается
Quality Management V2 Поддерживается Поддерживается Поддерживается
Requirements Management V1* Поддерживается Поддерживается Поддерживается
Requirements Management V2* Поддерживается Поддерживается Поддерживается
Architecture Management V2 Поддерживается Поддерживается Поддерживается
*Rational DOORS не должен быть настроен для приема своего интерфейса OSLC. Поддержка предоставляется только для обмена данными между хранилищами.

В следующих таблицах перечислены связи OSLC, используемые при связывании артефактов по различным направлениям:

Табл. 2. Связь по направлениям при помощи Change Management V1
Связь через Change Management V1
Исходящая связь Входящая связь
Реализована

http://jazz.net/xmlns/prod/jazz/calm/1.0/implementedBy

Реализует

http://jazz.net/xmlns/prod/jazz/calm/1.0/implementsRequirement

Табл. 3. Связь по направлениям при помощи Change Management V2
Связь через Change Management V2
Исходящая связь Входящая связь
Изменяется

http://open-services.net/ns/rm#affectedBy

Изменяет

http://open-services.net/ns/cm#affectsRequirement

Реализована

http://open-services.net/ns/rm#implementedBy

Реализует

http://open-services.net/ns/cm#implementsRequirement

Отслеживается

http://open-services.net/ns/rm#trackedBy

Отслеживает

http://open-services.net/ns/cm#tracksRequirement

Табл. 4. Связь по направлениям при помощи Quality Management V1
Связь через Quality Management V1
Исходящая связь Входящая связь
Проверяется

http://jazz.net/xmlns/prod/jazz/calm/1.0/validatedBy

Проверяет

http://jazz.net/xmlns/prod/jazz/calm/1.0/validatesRequirement

Табл. 5. Связь по направлениям при помощи Quality Management V2
Связь через Quality Management V2
Исходящая связь Входящая связь
Проверяется

http://open-services.net/ns/rm#validatedBy

Проверяет

http://open-services.net/ns/qm#validatesRequirement

Проверяется

http://open-services.net/ns/rm#validatedBy

Проверяет

http://open-services.net/ns/qm#validatesRequirementCollection

Табл. 6. Связь по направлениям при помощи Requirements Management V1
Связь через Requirements Management V1
Исходящая связь Входящая связь
Дополнена

http://jazz.net/xmlns/prod/jazz/calm/1.0/elaboratedBy

Дополняет

http://jazz.net/xmlns/prod/jazz/calm/1.0/elaboratesRequirement

Табл. 7. Связь по направлениям при помощи Requirements Management V2
Связь через Requirements Management V2
Исходящая связь Входящая связь
Дополнена

http://open-services.net/ns/rm#elaboratedBy

Дополняет

http://open-services.net/ns/rm#elaborates

Определена

http://open-services.net/ns/rm#specifiedBy

Определяет

http://open-services.net/ns/rm#specifies

Табл. 8. Связь по направлениям при помощи Architecture Management V2
Связь через Architecture Management V2
Исходящая связь Входящая связь
Неприменимо Уточняет

http://jazz.net/ns/dm/linktypes#refine

Неприменимо Удовлетворяет

http://jazz.net/ns/dm/linktypes#satisfy

Неприменимо Трассировка

http://jazz.net/ns/dm/linktypes#trace

Когда пользователь открывает модуль в Rational DOORS, система "обнаруживает" внешние ссылки OSLC на и из других продуктов жизненного цикла и сохраняет результаты в кэше на уровне всей базы данных, так что последующие открытия модулей происходят быстрее. Этот процесс обнаружения ссылок может сказаться на производительности при открытии модуля, в зависимости от производительности интегрированного продукта. Тайм-аут кэша по умолчанию составляет 5 минут. По истечении этого времени ссылки необходимо "обнаруживать заново", так чтобы в кэше хранилось их текущее состояние. Значение тайм-аута можно изменить с помощью команды DXL perm setCachedExternalLinkLifeTime. Дополнительная информация приведена в разделе "Обнаружение ссылок OSLC" Справочного руководства DXL, доступного в формате PDF, а также из меню Справка.

Rational DOORS предоставляет и поддерживает следующие элементы и операции пользовательского интерфейса (UI) из домена Requirements Management.

Элементы и операции пользовательского интерфейса OSLC RM V1

Интерфейс OSLC RM V1 доступен в Rational DOORS версии не младше 9.3.

Для RM V1 реализованы следующие элементы пользовательского интерфейса:
  • Делегированный пользовательский интерфейс для раздела ресурсов Требования.
  • Делегированный пользовательский интерфейс для создания ресурсов Требования.
  • Делегированный пользовательский интерфейс для выбора ресурсов Наборы требований (представления).
  • Сжатый вывод (предварительный просмотр) ресурсов Требования.
  • Сжатый вывод (предварительный просмотр) ресурсов Наборы требований (представления).
  • Ресурс Фабрика для программного создания ресурсов Требования.
Для RM V1 реализованы следующие операции:
  • Поиск служб.
  • POST для создания требований. Операция Post создает требование в качестве первого объекта в модуле.
  • GET над набором требований.
  • PUT над набором требований
  • GET над требованием.
  • PUT над требованием.

Операция POST недоступна на уровне баз данных в дереве поиска служб.

URI набора требований содержит ссылку на модуль либо на модуль, к которому применено представление.

Внутренние связи Rational DOORS (не входящие и не исходящие) не раскрываются в результатах операции V1 GET.

Внешние связи Rational DOORS не раскрываются в результатах операции V1 GET.

Дополнительная информация приведена в разделе Спецификация OSLC RM V1.

Элементы и операции пользовательского интерфейса OSLC RM V2

Интерфейс OSLC RM V2 доступен в Rational DOORS начиная с версии 9.4.

Для RM V2 реализованы следующие элементы пользовательского интерфейса:
  • Делегированный пользовательский интерфейс для раздела ресурсов Требования.
  • Делегированный пользовательский интерфейс для создания ресурсов Требования.
  • Делегированный пользовательский интерфейс для выбора ресурсов Наборы требований (представления).
  • Сжатый вывод (предварительный просмотр) ресурсов Требования.
  • Сжатый вывод (предварительный просмотр) ресурсов Наборы требований (представления).
  • Ресурс Фабрика для программного создания ресурсов Требования.
Для RM V2 реализованы следующие операции:
  • Поиск служб.
  • Определение ресурсов.
  • POST для создания требований. Операция Post создает требование в качестве первого объекта в модуле.
  • GET над набором требований.
  • PUT над набором требований.
  • GET над требованием.
  • PUT над требованием.
  • Также поддерживается QUERY на уровне модулей.

Операция POST недоступна на уровне баз данных в дереве поиска служб.

URI набора требований содержит ссылку на модуль либо на модуль, к которому применено представление.

Внутренние исходящие связи Rational DOORS раскрываются в результатах операции V2 GET. Для их представления используется URI ресурса Модуль связи в качестве URI пространства имен с добавлением к нему слова "references". Пример:
http://localhost:8080/dwa/rm/urn:rational::1-46dd5d7806b96973-M-0001cc43/linkTypes/references
Внешние связи Rational DOORS раскрываются в результатах операции V2 GET. Они представлены в следующей форме:
  • входящие связи - http://purl.org/dc/terms/isReferencedBy
  • исходящие связи - http://purl.org/dc/terms/references
Дополнительная информация приведена приведена на веб-странице Спецификация OSLC RM V2.

Документ Root Services

Если сервер Rational DOORS Web Access Server установлен в каталоге {СЕРВЕР}, напримерhttp://doors.example.com/, документ Root Services будет находиться в:
  • Для версий Rational DOORS Web Access до версии 1.4.0.2 расположением будет {СЕРВЕР}/rm/discovery/rootservices
  • Для Rational DOORS Web Access 1.4.0.2 или более поздних версий расположением будет {СЕРВЕР}/public/rootservices
Документ Root Services не входит в спецификацию OSLC, но содержит точку входа для документов OSLC Service Discovery, а также некоторые другие URL конфигурации, необходимые для приема служб OSLC.

Безопасность

Безопасность является обязательным требованием; она обеспечивается протоколом OAuth 1.0a. Это открытый протокол для безопасной авторизации API при помощи простого стандартного метода из приложений для настольных ПК и веб-приложений.

Почти все URI OSLC (поиск служб, требования, наборы требований) доступны только для зарегистрированных пользователей. Исключением из общего правила является URI Root Services. Дополнительная информация приведена в разделе Спецификация OAuth 1.0a.

Информация о расширении Rational DOORS при помощи служб DXL приведена в разделе Службы OSLC DXL для Rational DOORS. См. также раздел Работа с DXL (язык расширений Rational DOORS).


Комментарии