Создание документов трассируемости из приложений CLM с помощью профайла POX

Теперь значительно упрощено создание документов трассируемости из приложений CLM. Можно настроить URL OSLC для возврата данных представления Reportable REST, если включить в запрос специальный заголовок с помощью POX (Plain Old XML).

Прежде чем начать

Должны быть установлены продукты Rational Publishing Engine 2.1.0 и выше и Rational solution for CLM 6.0.2 и выше.

Об этой задаче

Раньше было сложно создавать документы трассируемости, поскольку некоторые приложения, например, Rational Quality Manager и Rational Team Concert, используют URL OSLC, а для Rational Publishing Engine требуются отчетные URL REST. Это усложняло процесс проектирования шаблона, поскольку было необходимо преобразовывать URL из OSLC в отчетные REST. Иногда представление OSLC артефакта не содержало достаточно информации, требуемой для создания документа, например, с отформатированным текстом.

Профайл POX позволяет использовать URL OSLC таким образом, как если они были отчетными API REST. Можно использовать профайл POX в Rational Publishing Engine, чтобы запрашивать и получать отчетные данные REST непосредственно путем предоставления дополнительного заголовка. Больше нет необходимости преобразовывать URL или дублировать запросы. Служба создания документов возвратит дополнительный XML при наличии заголовка.

Пример: создания документа трассируемости из Rational DOORS Next Generation в Design Management

Процедура

  1. В Document Studio добавьте схему Rational DOORS Next Generation.
  2. Создайте элементы шаблона для печати информации из артефакта.
    Элемент DNG
  3. Повторно укажите ссылку в требовании.
    Ссылка DNG
  4. В Design Management скопируйте URL артефакта, щелкнув на значке Показать постоянную ссылку в пути.
  5. В Document Studio откройте мастер Добавить схему источника данных.
  6. (Новое) Вставьте URL в поле Схема и добавьте &?metadata=schema в конце URL.
  7. (Новое) В поле Дополнительные заголовки.
    Добавление схемы DM с профайлом POX
  8. Нажмите кнопку Далее, а затем - Готово.
  9. В шаблоне создайте элементы шаблона, которые следуют по ссылке обратно к Rational DOORS Next Generation. Откройте Конфигурацию источника данных на панели Свойства и перейдите на вкладку Динамическая настройка:
    1. (Новое) В поле URI введите значение атрибута href из Rational DOORS Next Generation.
    2. (Новое) В поле Принять заголовок введите application/xml.
    3. (Новое) В поле Дополнительные заголовки выберите ссылку на профайл POX. При обнаружении поля Дополнительные заголовки приложение возвращает информацию REST несмотря на то, что применяется URL OSLC.
      Настройка источника данных для профайла POX
  10. Создайте элементы шаблона для печати информации Design Management.
    Элемент DM
  11. Откройте панель запуска RPE для создания документа.
  12. На панели Спецификация документов откройте контекстное меню источника данных Rational DOORS Next Generation и выберите Настроить источник данных.
    1. URL: введите URL постоянной ссылки из Rational DOORS Next Generation.
    2. Если необходимо, введите имя пользователя и пароль.
    3. Идентификация: выберите OAuth.
    4. Заголовок Accept: введите application/xml.
    5. (Новое) Дополнительные заголовки: выберите ссылку на профайл POX для запроса данных REST для создания отчетов из Rational DOORS Next Generation.
  13. На главной панели инструментов выберите Создать документ. На панели Консоль показано, что Rational Publishing Engine запрашивает данные из Design Management и Rational DOORS Next Generation с помощью URL OSLC. Design Management и Rational DOORS Next Generation выполняются перенаправление на URL REST для создания отчетов. Документ вывода содержит требование из Rational DOORS Next Generation и связанные данные модели из Design Management.
    Результат с данными DNG и данными DM