Вы можете определить
Rational Quality Manager
как источник данных в
Rational Publishing Engine.
Данные извлекаются посредством API REST
Rational Quality Manager. Этот интерфейс устанавливается и реализуется приложением и
работает независимо от
Rational Publishing Engine.
Совет: Rational Publishing Engine
поставляется с набором примеров отчетов. Прежде чем
публиковать документы, вы можете изучить пример сценария
генерации документа. См. раздел
Создание примера шаблона REST.
Перед тем, как начать
- Ознакомьтесь со службой REST
Rational Quality Manager
и различными URL, необходимыми для извлечения данных из
Rational Quality Manager
с помощью
Rational Publishing Engine.
См. раздел
Документация
по API REST
Rational Quality Manager.
- Подключитесь к схеме источника данных. См. раздел
Добавление схемы источника данных.
- Схема может находиться в локальной файловой системе. Например,
https://сервер:порт/jazz/service/com.ibm.rqm.integration.service.IntegrationService/schema/feed.xsd
- это файл схемы, использующий аргумент
feed. С помощью этой схемы вы можете
добавлять конкретные фрагменты данных, например сведения о
тестовом наборе или тестовые сценарии, из своего проекта
Rational Quality Manager
или обращаться к отдельному ресурсу с известным URL.
- Если для создания документа используется API REST v2,
то требуется указать URL-адрес схемы источника данных, указывающий
на поставщика служб, а не на корневую запись. Пример:
- Неправильно: https://сервер:порт/qm/oslc_qm/catalog
- Правильно: https://сервер:порт/qm/oslc_qm/catalog/repository/db/schema_repository/
Вы можете воспользоваться элементами схемы
источника данных для добавления запросов в шаблон. Эти
запросы указывают, какие фрагменты информации генерируются
в отчете.Для получения полного списка возвратов из источника данных ленты
новостей Rational Quality Manager
необходимо задать тип схемы Базовый XML и добавить
строку ?abbreviate=false в конец URI. Пример: https://rqmserver:9443/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/JKE Banking (Quality Management)/testcase?abbreviate=false
- После подключения к схеме источника данных вы можете
создать или импортировать эскиз шаблона. Rational Publishing Engine
Document Studio позволяет составить эскиз шаблона отчета. Этот эскиз определяет макет отчета. См. раздел
Создание шаблонов с помощью Document Studio.
- Спланируйте структуру документа и определите
содержимое для извлечения данных. Обзор процесса разработки
шаблона приведен в разделе
Разработка шаблонов документов. Если документ велик, то вы можете создать отдельные шаблоны
для каждого блока документа.
- Rational Publishing Engine
содержит полный набор элементов шаблона, позволяющих
структурировать документ. Вы можете перетаскивать элементы
в редактор содержимого шаблона.
Дополнительные сведения
приведены в разделе
Элементы шаблона на панели Палитра.
- Добавьте данные в шаблон с помощью
запросов,
атрибутов
и
переменных.
- С помощью элемента Data Source
Configuration вы можете определить некоторые
свойства, неизвестные на момент выполнения. См. раздел
Добавление элемента конфигурации источника данных. Например, схема данных qm задается
динамически на основе схемы данных feed. Вы всегда используете эту схему и динамически настраиваете
ее для конкретных фрагментов данных в шаблоне из своего
проекта
Rational Quality Manager.
- С помощью фильтров, представляющих собой более
детализированные разновидности общего URI источника данных,
можно указывать конкретные подмножества данных, так чтобы
Rational Publishing Engine
не извлекал больше информации, чем необходимо, из хранилища
Rational Quality Manager
во время генерации отчета. Эти фильтры должны быть
достаточно широки для извлечения всех необходимых данных,
на которые ссылается шаблон, в противном случае
генерируемый отчет будет неполным. См. раздел
Извлечение данных с помощью фильтра Rational Publishing Engine.
- После создания шаблона отчета и заполнения его
указателями на данные
Rational Quality Manager
вы можете приступить к генерации отчета в различных
форматах. Когда вы генерируете отчет, вы должны быть
подключены к источнику данных, содержащему информацию для
включения в отчет. Введите URI, указывающий на хранилище
Rational Quality Manager
с соответствующими данными. Инструкции по созданию
указателей на соответствующие данные приведены в разделе
Подключение к источнику данных.
Прим.: По умолчанию для API OSLC
IBM Rational Quality Manager
в том случае, если в спецификации документа не указан заголовок
accept,
Rational Quality Manager
возвращает представление HTML ресурса. Для получения данных XML
следует задать в заголовке accept значение
application/xml.
- Если схемы источников данных добавляются в
шаблон после назначения шаблона спецификации документа, то
спецификация документа становится несинхронизированной. Вы
можете
вручную
синхронизировать спецификацию документа или выбрать
опцию автоматической синхронизации спецификации документа с
текущим шаблоном. Инструкции по настройке параметра
Сохранить синхронизацию спецификации документа с
текущим шаблоном? приведены в разделе
Настройка параметров создания документов.
- Перед тем, как опубликовать документ,
ознакомьтесь с разделом
Задание свойств вывода,
содержащим дополнительную информацию об имеющихся опциях
вывода и позволяющим определить, какая из них окажется
наиболее подходящей для элементов шаблона.
- Теперь вы готовы к тому, чтобы
опубликовать документ. См. раздел
Создание документа.