Разработка шаблонов с помощью Rational RequisitePro в качестве источника данных

Проектировщики отчетов могут использовать Document Studio для импорта схем источников данных и построения шаблонов отчетов.

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

Совет: Установка Rational Publishing Engine включает набор примеров отчетов. Прежде чем публиковать документы, вы можете изучить пример сценария генерации документа. См. раздел Создание примера шаблона REST.
Ознакомьтесь с требованиями Rational RequisitePro для извлечения данных с помощью Rational Publishing Engine. Для того чтобы найти в справочной системе Information Center информацию о нужной версии Rational RequisitePro, обратитесь к разделу О продукте Rational RequisitePro Information Center.

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

Данные извлекаются с помощью API REST. Этот интерфейс устанавливается и реализуется приложением источника данных и работает независимо от Rational Publishing Engine. Дополнительная информация об API REST для источника данных приведена в документации по источнику данных.

Процедура

  1. Обзор процесса разработки шаблона приведен в разделе Разработка шаблонов документов. Приступите к планированию структуры документа и данных, которые он может содержать. Например, определите, будет ли окончательный документ создан на основе одного шаблона или нескольких шаблонов, каждый из которых содержит многократно используемые фрагменты информации.
  2. В приложении Document Studio создайте шаблон документа.
  3. Добавить схему источника данных в шаблон документа. Для поиска схемы источника данных Rational RequisitePro можно ввести базовый URL приложения.
    1. В Document Studio выберите Данные > Поиск схем > Поиск схем REST.
    2. Введите Имя источника данных.
    3. Введите Описание источника данных.
    4. Укажите Базовый URL для ресурса.
    5. Выберите Тип идентификации в списке. Для адаптера Rational RequisitePro, предоставленного Службами данных, необходимо указать тип идентификации Basic. Если тип не выбран, то правильный тип определяется путем проверки всех типов. Это может привести к увеличению времени создания документов.
    6. Укажите имя пользователя, если ресурс расположен на защищенном сервере.
    7. Укажите пароль, если ресурс расположен на защищенном сервере.
    8. Нажмите кнопку Далее. К указанному базовому URL автоматически добавляется строка ?metadata=schema.
    9. Нажмите Готово. Выбранная схема источника данных отображается на панели Схема источника данных.
  4. Добавьте элементы в шаблон. Rational Publishing Engine содержит полный набор элементов шаблона, позволяющих структурировать документ. Вы можете перетаскивать элементы в редактор содержимого шаблона. Например, можно добавить элемент Контейнер для размещения нескольких абзацев. Каждый абзац может контролироваться тестовым условием, связывающим его только с определенными данными. Дополнительная информация приведена в разделах Элементы шаблона на панели Палитра и Добавление элементов в шаблон.
  5. Добавьте данные в шаблон с помощью запросов, атрибутов и переменных. Эти элементы указывают, какие фрагменты информации генерируются в отчете.
  6. Добавьте параметры форматирования и стиля элементов, чтобы настроить их внешний вид в выводе.
  7. Создайте фильтры для ограничения данных, добавляемых в отчет. С помощью фильтров, представляющих собой более детализированные разновидности общего URI источника данных, можно указывать конкретные подмножества данных, так чтобы Rational Publishing Engine не извлекал больше информации, чем необходимо, из источника данных во время генерации отчета. Эти фильтры должны быть достаточно широки для извлечения всех необходимых данных, на которые ссылается шаблон, в противном случае генерируемый отчет будет неполным. Встроенные фильтры Reportable Rest v1 требуются только для вводе текста между квадратных скобок []. Остальной фильтр создается Rational Publishing Engine. Следующий пример внутреннего фильтра Reportable Rest v1 извлекает схему Rational RequisitePro PRRequirements с помощью Stability='High'.
    Добавьте выражение фильтра в узел из категории Устройства, чтобы разрешить выбор только устройств конкретного производителя.
    fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)
  8. Создайте сортировки для организации данных в отчете. Rational RequisitePro не поддерживает использование внутренней сортировки. Вместо этого можно создать сортировку в Rational RequisitePro:
    1. Создать таблицу и ввести данные.
    2. Отсортировать данные.
    3. Создать представление и сохранить в нем данные.
    4. Выполнить экспорт представления для использования в качестве схемы источника данных в Rational Publishing Engine. Приложение Reporting Data Services обнаруживают представление автоматически.
    5. Добавить схему источника данных в шаблон Rational Publishing Engine.
    Данные Rational RequisitePro, созданные в выводе Rational Publishing Engine, сохраняют порядок сортировки, который был задан в представлении, однако, некоторые вложенные данные могут не отображаться как вложенные.

Комментарии