Проектировщики отчетов могут использовать Document Studio для
импорта схем источников данных и построения шаблонов отчетов.
Прежде чем начать
Совет: Установка
Rational Publishing Engine
включает набор примеров отчетов. Прежде чем
публиковать документы, вы можете изучить пример сценария
генерации документа. См. раздел
Создание примера шаблона
Rational DOORS.
Изучите модуль
Rational DOORS,
с которым вы собираетесь работать, и его содержимое. Для того чтобы найти в справочной
системе Information Center информацию о нужной версии
Rational DOORS,
обратитесь к разделу
О
продукте
Rational DOORS
Information Center.
Вы можете использовать сочетание свойств модуля,
атрибутов объектов и представлений, хранящихся в модулях. Просмотрите модуль и выясните,
какие из имеющихся в нем представлений содержат вычисляемые столбцы, включая трассируемые
представления и, возможно, столбцы DXL макета. Эти представления не соответствуют
атрибутам
Rational DOORS,
но в них может быть информация, заслуживающая включения в отчет.
Процедура
- Обзор процесса разработки шаблона приведен в разделе
Разработка шаблонов документов. Приступите к планированию структуры документа и
данных, которые он может содержать. Например, определите, будет ли окончательный документ создан на
основе одного шаблона или нескольких шаблонов, каждый из которых
содержит многократно используемые фрагменты информации.
- В приложении Document Studio создайте шаблон документа.
- Определите схему источника данных из источника данных. Можно использовать
Rational DOORS или Rational DOORS Web
Access.
Для
Rational DOORS:
- В Document Studio выберите .
- Укажите сведения о соединении:
- Для использования активного экземпляра
Rational DOORS
выберите Использовать запущенный экземпляр
DOORS.
- Для запуска
Rational DOORS
в фоновом режиме выберите Запустить новый процесс DOORS в
фоновом режиме.
Укажите имя пользователя, пароль, базу данных и путь к файлу
doors.exe.
- Выберите представление:
- Представление базы данных
- Панель проекта
- Нажмите кнопку Далее.
- Выберите тип атрибута:
- Для добавления атрибутов главных объектов
(элементы схемы Module/Object) выберите
Атрибуты модуля и объектов.
- Для добавления атрибутов связанных элементов
(элемент схемы Module/Object/Link/Linked) выберите
Атрибуты связанных объектов.
- В окне Выбор модуля DOORS выберите
модуль в структуре базы данных
Rational DOORS
и нажмите кнопку Далее.
- В окне Контрольная версия DOORS выберите контрольную версию для модуля. От выбранной контрольной версии зависит набор атрибутов.
- В окне Атрибуты DOORS отображается
следующая информация об атрибутах:
- Имя атрибута: Список атрибутов, доступных в выбранной контрольной версии.
- Область действия: Показывает область действия атрибута в качестве модуля или объекта.
- Имя повышения: Повышенное имя атрибута
применяется в выражениях сценариев. На основе имени атрибута Rational DOORS
создается допустимое имя, чтобы избежать ввода недопустимого
значения. Повышенный атрибут обеспечивает прямой доступ к значению
атрибута из контекста Module/Object.
Атрибуты без повышения доступы только из контекста
Module/Object/Attribute.
Включите переключатель, чтобы указать конкретный атрибут;
кнопка Выбрать все позволяет выбрать все
атрибуты. Кнопка Отменить выбор всех позволяет
отменить выбор всех атрибутов. Нажмите кнопку Далее.
- В окне Панели и столбцы DOORS выберите панель. Затем
выберите отдельные столбцы с помощью переключателей или нажмите
кнопку Выбрать все, чтобы выбрать все столбцы. Нажмите кнопку Далее.
Прим.: Имя повышения столбца отображается в столбце Имя повышения. Столбцы можно повысить из произвольного числа представлений. Впоследствии атрибуты можно будет повысить при
проектировании шаблона.
Атрибуты добавляют декларативную информацию в элементы, помимо обычных предопределенных
ключевых слов. Пользовательские атрибуты
Rational DOORS
доступны только через узлы Attribute в стандартном файле схемы
Rational DOORS. Для использования этих атрибутов можно их поднять
до атрибутов XML, используя мастер поиска схемы XML. У атрибута может быть
единственное вхождение, например, Module
Name, и свойство Last Modified
On. Атрибуты могут применяться к объектам и иметь
несколько вхождений, например Object
Heading и Object Text.
- В окне Выберите параметры схемы заполните следующие поля:
- Выбрать расположение схемы: Нажмите
кнопку Обзор, чтобы выбрать расположение для
сохранения схемы источника данных.
- ИД схемы источника данных: Введите ИД схемы источника данных.
- Включите переключатель Добавить схему источника
данных в текущий шаблон, чтобы добавить схему в
открытый шаблон. Нажмите кнопку Далее.
- Сохраните схемы для повторного использования в других шаблонах
без повторного запуска мастера обнаружения схемы.
- Просмотрите информацию в окне сводки и нажмите кнопку
Готово.
Для
Rational DOORS Web Access:
- В Document Studio выберите
.
- В поле Тип схемывыберите Базовый XML в списке.
- В поле Файл схемы вставьте
URL схемы источника данных.
- В поле ИД источника данных введите имя источника данных в шаблоне. Нажмите кнопку Далее.
- Укажите имя пользователя, если ресурс расположен на защищенном
сервере.
- Укажите пароль, если ресурс расположен на защищенном сервере.
- Выберите тип идентификации OAuth-OSLC в
списке.
- Измените атрибуты. Вы можете выяснить, какие атрибуты объекта присутствуют в
модуле
Rational DOORS,
а затем оценить, насколько они необходимы в отчете
Rational Publishing Engine.
С помощью пункта меню
откройте список атрибутов, включенных в модуль.
- Добавьте элементы в шаблон. Rational Publishing Engine
содержит полный набор элементов шаблона, позволяющих
структурировать документ. Вы можете перетаскивать элементы
в редактор содержимого шаблона.
Например, можно добавить элемент Контейнер для размещения
нескольких абзацев.
Каждый абзац может контролироваться тестовым условием, связывающим
его только с определенными данными. Дополнительная информация
приведена в разделах Элементы шаблона на панели Палитра
и Добавление элементов в шаблон.
Прим.: Для хранения аналитических диаграмм
Rational DOORS,
содержащихся в таблице 1x1, можно использовать элементы контейнера
вместо таблиц.
- Добавьте данные в шаблон с помощью
запросов,
атрибутов
и
переменных. Эти элементы указывают, какие фрагменты информации
генерируются в отчете. Запросы в
IBM® Rational DOORS
начинаются с корневого элемента (модуля), за которым следует его
дочерний элемент (объект) и дочерние атрибуты объекта. Например: Module/Object/Attribute/Name.
- Создайте
таблицу на основе данных Rational DOORS.
Прямая поддержка воспроизведения таблицы
Rational DOORS
в точности так, как она представлена в
Rational DOORS,
отсутствует; вы можете воспользоваться имеющимися
атрибутами таблицы
Rational DOORS
и создать новую таблицу.
С помощью мастера
схемы
Rational DOORS
извлеките информацию о таблицах
Rational DOORS.
Пример:
TableCellWidth –
ширина ячейки в экранных
пикселях. Извлечь информацию о столбцах из
Rational DOORS
можно двумя способами:
- Добавьте параметры форматирования и стиля элементов, чтобы
настроить их внешний вид в выводе.
- Создайте фильтры для ограничения данных, добавляемых в отчет. С помощью фильтров, представляющих собой более детализированные
разновидности общего URI источника данных, можно указывать конкретные
подмножества данных, так чтобы
Rational Publishing Engine
не извлекал больше информации, чем необходимо, из источника данных во
время генерации отчета. Эти фильтры должны быть
достаточно широки для извлечения всех необходимых данных,
на которые ссылается шаблон, в противном случае
генерируемый отчет будет неполным. Дополнительная информация приведена в разделе Пример: внутренние фильтры Rational DOORS.
- Создайте
сортировки для организации данных в отчете. Для
Rational DOORS
текст внутренней сортировки должен быть в формате сортировки
Rational DOORS.
Дополнительная информация приведена в разделе Пример: Внутренние сортировки в Rational DOORS.
Дальнейшие действия
В случае
предварительного
просмотра данных в приложении Document Studio, для извлечения
данных используются представление и контрольная версия по умолчанию.