Вы можете определить
IBM® Rational ClearQuest
как источник данных в
IBM Rational Publishing Engine.
Перед тем, как начать
- Ознакомьтесь со службой REST
Rational ClearQuest
и различными URL, необходимыми для извлечения данных из
Rational ClearQuest
с помощью
Rational Publishing Engine.
См. раздел
О
продукте
Rational ClearQuest
Information Center.
- Подключитесь к схеме источника данных. См. раздел
Добавление схемы источника данных.
- Схема может находиться в локальной файловой системе. Rational Publishing Engine использует службы данных Rational для поиска схемы и запроса данных. URL, который можно
использовать для поиска схемы:
https://сервер:порт/DataServices/ClearQuest.
См. раздел
Добавление схемы источника данных REST с помощью мастера поиска схемы.
- Схемой может быть любой URI, доступный с компьютера. Вы можете построить URI,
указывающий на схему источника данных. Откройте схему источника данных и затем возьмите
URI для конкретного ресурса из файла XML. Добавьте ?metadata=schema
в конец этого URI. Например:
https://сервер:порт/service/cq/records/defects?metadata=schema.
- В последних версиях
Rational ClearQuest
для создания схемы источника данных можно также воспользоваться REST v2 Schema Discovery. См. раздел
Добавление схемы источника данных REST с помощью мастера поиска схемы.
Прим.: В случае применения REST v2 Schema Discovery,
Rational Publishing Engine
не требуется Rational Data Services. Rational Publishing Engine
может найти схему в
Rational ClearQuest
путем запуска поиска ресурсов REST v2 из URL ServiceProvider.
Пользователи могут узнать URL ServiceProvider,
введя URL REST v2 ServiceCatalog
Rational ClearQuest, такой как
https://сервер:порт/context/oslc.
Задайте 2.0 в качестве значения OSLC-Core-Version для заголовков HTTP и
примите application/rdf+xml. В возвращенном результате найдите URL
ServiceProvider rdf:about.
- Если для создания документа используется API REST v2,
то требуется указать URL-адрес схемы источника данных, указывающий
на поставщика служб, а не на корневую запись. Пример:
- Неправильно: https://сервер:порт/cqweb/oslc
- Правильно: https://сервер:порт/cqweb/oslc/repo/repository/db/schema_repository/
- После подключения к схеме источника данных вы можете создать или импортировать эскиз
шаблона. Rational Publishing Engine
Document Studio позволяет составить эскиз шаблона отчета. Этот эскиз определяет макет
отчета. Создание шаблонов с помощью Document Studio.
- Спланируйте структуру документа и определите содержимое
для извлечения данных. Обзор процесса разработки
шаблона приведен в разделе
Разработка шаблонов документов. Если документ велик, то вы можете создать отдельные шаблоны для каждого блока документа.
- С помощью фильтров, представляющих собой более детализированные разновидности общего
URI источника данных, можно указывать конкретные подмножества данных, так чтобы
Rational Publishing Engine
не извлекал больше информации, чем необходимо, из хранилища
Rational ClearQuest
во время генерации отчета. Эти фильтры должны быть достаточно широки для извлечения всех
необходимых данных, на которые ссылается шаблон, в противном случае генерируемый отчет
будет неполным. См. раздел
Извлечение
данных с помощью стандартных фильтров.
- После создания шаблона отчета и заполнения его указателями на данные
Rational ClearQuest
вы можете приступить к генерации отчета в различных форматах. Когда вы генерируете отчет,
вы должны быть подключены к источнику данных. Инструкции по созданию указателей на
соответствующие данные приведены в разделе
Подключение к источнику данных.
- Если схемы источников данных добавляются в
шаблон после назначения шаблона спецификации документа, то
спецификация документа становится несинхронизированной. Вы
можете
вручную
синхронизировать спецификацию документа или выбрать
опцию автоматической синхронизации спецификации документа с
текущим шаблоном. Инструкции по настройке параметра
Сохранить синхронизацию спецификации документа с
текущим шаблоном? приведены в разделе
Настройка параметров создания документов.
- Перед тем, как опубликовать документ,
ознакомьтесь с разделом
Задание свойств вывода,
содержащим дополнительную информацию об имеющихся опциях
вывода и позволяющим определить, какая из них окажется
наиболее подходящей для элементов шаблона.
- Теперь вы готовы к тому, чтобы
опубликовать документ. См. раздел
Создание документа.