Пример: извлечение артефактов из приложений, поддерживающих API RESTful

Этот пример иллюстрирует извлечение артефактов из приложения Управление требованиями Rational solution for Collaborative Lifecycle Management и создание элементов в IBM® Rational Focal Point.

Цель

Если у вас есть требования в приложении Управление требованиями, и необходимо присвоить им приоритет в Rational Focal Point, то можно извлечь требования с помощью команды просмотра клиента REST.
Предварительное условие:
  • Укажите IP-адрес и имя сервера Rational solution for CLM в файле host на компьютере, с которого настраивается интеграция. В системах Windows файл host обычно находится в каталоге C:\Windows\System32\drivers\etc, а в системах Linux - в каталоге /etc/hosts.
  • Добавьте приложение Управление требованиями в качестве элемента Друзья (исходящие) в Rational Focal Point. Дополнительная информация приведена в разделе Подключение к серверу приложений решения Rational для Collaborative Lifecycle Management.
  • Необходимо иметь представление о структуре XML артефактов приложения Управление требованиями и иметь права доступа к ним.

Пример

В этом примере предполагается, что в Rational Focal Point есть рабочая область FP-RRC и представление Просмотр требований RRC. В таблице показано несколько атрибутов, доступных в Rational Focal Point и в приложении Управление требованиями.
Табл. 1. Атрибуты для Rational Focal Point и приложения Управление требованиями
Атрибуты Rational Focal Point Атрибуты приложения Управление требованиями
Вид топлива rrm:description
Эффективность топлива rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
Ссылка на интеграцию rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
Название ds:location/ds:project/rrm:title
  1. В Rational Focal Point откройте рабочую область FP-RRC, в которую требуется извлечь артефакты.
  2. Выберите Настроить > Команда просмотра клиента REST, затем выберите пункт Добавить команду просмотра.
  3. В поле Имя коннектора клиента REST введите Коннектор RRC, чтобы идентифицировать соединение.
  4. В поле Метод запроса REST выберите метод GET.
  5. В списке Список друзей выберите RRC.
  6. В поле URL запроса приложения REST введите URL приложения, содержащий артефакты, которые требуется извлечь. Например, для получения артефактов из приложения Управление требованиями введите https://<хост>:<порт>/rm/<проект>/<набор>
    Совет: Откройте браузер и введите URL, который указывался при добавлении приложения Управление требованиями в друзья. Откроется список артефактов высокого уровня. Найдите артефакт, который требуется извлечь, и скопируйте его URL в поле URL запроса приложения REST.
  7. Выберите Подключиться.
  8. Выберите Выбрать корневой путь XPath для ограничения области поиска артефактов одним набором. Выберите /ds:dataSource/ds:artifact. XPath позволяет сузить поиск до уровня артефактов. Правила XPath - это иерархическая структура XML приложения.
  9. Для того чтобы исключить дублирование артефактов, в разделе Связывание ИД выберите Добавить и свяжите Вид топлива из Rational Focal Point с rrm:description из приложения Управление требованиями. Привязывать можно только один атрибут.
  10. В разделе Преобразование атрибутов выберите Добавить, чтобы связать между собой следующие атрибуты приложения Управление требованиями и Rational Focal Point. Связанные атрибуты отображаются рядом с элементом, извлеченным из приложения. Убедитесь, что атрибуты доступны для редактирования.
    Прим.: Атрибут, выбранный в разделеСвязывание ИД, не показывается в разделе Преобразование атрибутов, так как он связывается внутренне и доступен для выбираемых элементов.
    Табл. 2. Связывание атрибутов между Rational Focal Point и приложением Управление изменениями и конфигурацией
    Атрибуты Rational Focal Point Атрибуты приложения Управление требованиями
    Эффективность топлива rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    Ссылка на интеграцию rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    Название ds:location/ds:project/rrm:title
  11. В поле Формат даты, поддерживаемый приложением REST введите 2012-08-18.
  12. В поле Разделитель Focal Point оставьте , как есть.
  13. Нажмите кнопку Сохранить.
  14. Откройте представление Просмотр требований RRC и выберите в выпадающем списке пункт Коннектор RRC. Будет извлечен список требований и атрибутов, для которых в представлении будут созданы соответствующие элементы.

Отправить комментарий