Проектировщики отчетов могут использовать Document Studio для
импорта схем источников данных и построения шаблонов отчетов.
Прежде чем начать
Совет: Установка
Rational Publishing Engine
включает набор примеров отчетов. Прежде чем
публиковать документы, вы можете изучить пример сценария
генерации документа. См. раздел
Создание примера шаблона REST.
Ознакомьтесь со службой REST
Rational Rhapsody
и различными URL, необходимыми для извлечения данных из
Rational Rhapsody
при работе с
Rational Publishing Engine.
Для того чтобы найти в справочной системе Information
Center информацию о нужной версии
Rational Rhapsody,
обратитесь к разделу
О
продукте
Rational Rhapsody
Information Center.
Об этой задаче
Данные извлекаются с помощью API REST.
Этот интерфейс устанавливается и реализуется приложением
источника данных и работает независимо от
Rational Publishing Engine.
Дополнительная информация об API REST для источника
данных приведена в документации по источнику данных.
Процедура
- Обзор процесса разработки шаблона приведен в разделе
Разработка шаблонов документов. Приступите к планированию структуры документа и
данных, которые он может содержать. Например, определите, будет ли окончательный документ создан на
основе одного шаблона или нескольких шаблонов, каждый из которых
содержит многократно используемые фрагменты информации.
- В приложении Document Studio создайте шаблон документа.
- Добавить схему источника данных в шаблон документа. Для
Rational Rhapsody
можно выполнить следующие действия:
- В Document Studio выберите
.
- В поле Тип схемы выберите тип схемы в списке. Для
Rational Rhapsody
выберите REST.
- В поле Файл схемы вставьте URL схемы
источника данных и добавьте к нему строку
?metadata=schema. Базовый URL
Rational Rhapsody:
https://сервер:порт/Rational/Rhapsody/.
После добавления строки ?metadata=schema
URL выглядит следующим образом: https://сервер:порт/Rational/Rhapsody/?metadata=schema
Кроме того, вы можете нажать кнопку Обзор
и выбрать схему источника данных, входящую в
состав продукта Rational Rhapsody.
Расположение по умолчанию схемы Rational Rhapsody: Rational_Rhapsody_HOME\RPE\Schemas. Пример: Rational_Rhapsody_HOME\RPE\Schemas\default.xsd
При выборе схемы из модели с примененными профайлами и
новыми терминами убедитесь, что такая модель загружена в
Rational Rhapsody.
- В поле ИД источника данных введите имя источника данных в шаблоне. Нажмите кнопку
Далее.
- Укажите имя пользователя, если ресурс расположен на защищенном
сервере.
- Укажите пароль, если ресурс расположен на защищенном сервере.
- Выберите Тип идентификации в списке. Если тип не выбран, то правильный тип определяется путем
проверки всех типов. Это может привести к увеличению времени
создания документов.
- Нажмите Готово. Выбранная схема источника данных отображается на панели Схема
источника данных.
- Добавьте элементы в шаблон. Rational Publishing Engine
содержит полный набор элементов шаблона, позволяющих
структурировать документ. Вы можете перетаскивать элементы
в редактор содержимого шаблона.
Например, можно добавить элемент Контейнер для размещения
нескольких абзацев.
Каждый абзац может контролироваться тестовым условием, связывающим
его только с определенными данными. Дополнительная информация
приведена в разделах Элементы шаблона на панели Палитра
и Добавление элементов в шаблон.
- Добавьте данные в шаблон с помощью
запросов,
атрибутов
и
переменных. Эти элементы указывают, какие фрагменты информации
генерируются в отчете.
- Добавьте параметры форматирования и стиля элементов, чтобы
настроить их внешний вид в выводе.
- Создайте фильтры для ограничения данных, добавляемых в отчет. С помощью фильтров, представляющих собой более детализированные
разновидности общего URI источника данных, можно указывать конкретные
подмножества данных, так чтобы
Rational Publishing Engine
не извлекал больше информации, чем необходимо, из источника данных во
время генерации отчета. Эти фильтры должны быть
достаточно широки для извлечения всех необходимых данных,
на которые ссылается шаблон, в противном случае
генерируемый отчет будет неполным. Rational Rhapsody
поддерживает источники данных Reportable Rest v1 во внутренних
фильтрах. Встроенные фильтры Reportable Rest v1 требуются
только для вводе текста между квадратных скобок []. Остальной фильтр создается
Rational Publishing Engine. Дополнительная информация приведена в
разделе
Reportable Rest v1. См. также раздел Условия фильтра, поддерживаемые внутренними фильтрами REST.
- Для уточнения результатов запроса можно воспользоваться фильтром запроса на
преобразование типов. Функция
преобразования типов работает как альтернативный фильтр для
элементов источника данных; подробная информация приведена
в разделе
Преобразование типов.
- Создайте
сортировки для организации данных в отчете.