Проектировщики отчетов могут использовать Document Studio для
импорта схем источников данных и построения шаблонов отчетов.
Прежде чем начать
Совет: Установка
Rational Publishing Engine
включает набор примеров отчетов. Прежде чем
публиковать документы, вы можете изучить пример сценария
генерации документа. См. раздел
Создание примера шаблона
Rational DOORS.
Изучите модуль
Rational DOORS,
с которым вы собираетесь работать, и его содержимое. Для того чтобы найти в справочной
системе Information Center информацию о нужной версии
Rational DOORS,
обратитесь к разделу
О
продукте
Rational DOORS
Information Center.
Вы можете использовать сочетание свойств модуля,
атрибутов объектов и представлений, хранящихся в модулях. Просмотрите модуль и выясните,
какие из имеющихся в нем представлений содержат вычисляемые столбцы, включая трассируемые
представления и, возможно, столбцы DXL макета. Эти представления не соответствуют
атрибутам
Rational DOORS,
но в них может быть информация, заслуживающая включения в отчет.
Процедура
- Обзор процесса разработки шаблона приведен в разделе
Разработка шаблонов документов. Приступите к планированию структуры документа и
данных, которые он может содержать. Например, определите, будет ли окончательный документ создан на
основе одного шаблона или нескольких шаблонов, каждый из которых
содержит многократно используемые фрагменты информации.
- В приложении Document Studio создайте шаблон документа.
- Определите схему источника данных из источника данных. Источник данных можно добавить двумя способами: через мастер Поиск схемы DOORS или через мастер Схема источника данных. Для добавления источника данных с помощью мастера Схема источника данных выполните следующие действия:
- В Document Studio выберите
.
- В поле Предопределенные выберите схему базы данных Doors.
- В поле Тип выберите тип схемы в списке. Для Rational DOORS выберите DOORS.
- При необходимости измените поле Схема или нажмите кнопку Обзор и выберите путь к файлу схемы.
- Укажите имя пользователя, если ресурс расположен на защищенном
сервере.
- Укажите пароль, если ресурс расположен на защищенном сервере.
- Выберите Тип идентификации в списке. Для Rational DOORS применяется тип идентификации OAuth-OSLC. Если значение OAuth-OSLC не выбрано, то
правильный тип идентификации выбирается путем проверки всех типов
идентификации. Это может привести к увеличению времени создания
документов.
Для добавления источника данных с помощью мастера Поиск схемы 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,
а затем оценить, насколько они необходимы в отчете
Rational Publishing Engine.
С помощью пункта меню
откройте список атрибутов, включенных в модуль.
- Добавьте элементы в шаблон. Rational Publishing Engine
содержит полный набор элементов шаблона, позволяющих
структурировать документ. Вы можете перетаскивать элементы
в редактор содержимого шаблона.
Например, можно добавить элемент Контейнер для размещения
нескольких абзацев.
Каждый абзац может контролироваться тестовым условием, связывающим
его только с определенными данными. Дополнительная информация
приведена в разделах Элементы шаблона на панели Палитра
и Добавление элементов в шаблон.
- Элементы контейнера
- Для хранения аналитических диаграмм
Rational DOORS,
содержащихся в таблице 1x1, можно использовать элементы контейнера
вместо таблиц.
- Элементы изображений
- Изображения извлекаются из модуля
Rational DOORS
со значениями атрибута. Запросить одни только изображения
нельзя.
Для настройки размера извлекаемых изображений задайте
свойства
Максимальная ширина
изображения и
Максимальная высота
изображения.
Эти свойства можно задать в двух
местах:
- Информация о формате элемента определяет размер
изображений, содержащихся в этом элементе шаблона. Доступна
только для текстовых элементов шаблона.
- Метаданные спецификации документа определяют размер
изображений во всех шаблонах. Значения формата элемента
переопределяют эти глобальные значения.
- Элементы таблицы
Таблицу
Rational DOORS
не всегда удается воспроизвести
Rational Publishing Engine
в том же виде, в котором она отображается в
Rational DOORS;
можно создать новую таблицу с помощью доступных атрибутов
таблицы
Rational DOORS.
С помощью мастера
схемы
Rational DOORS
извлеките информацию о таблицах
Rational DOORS.
Пример:
TableCellWidth –
ширина ячейки в экранных
пикселях. Извлечь информацию о столбцах из
Rational DOORS
можно двумя способами:
Если ячейки в таблицах
Rational DOORS
занимают несколько строк, то
Rational Publishing Engine
создает первую ячейку, а остальные ячейки удаляются.
Дополнительная информация о таблицах приведена в разделе
Добавление элемента таблицы.
- Добавьте данные в шаблон с помощью
запросов,
атрибутов
и
переменных. Эти элементы указывают, какие фрагменты информации
генерируются в отчете. Запросы в
IBM® Rational DOORS
начинаются с корневого элемента (модуля), за которым следует его
дочерний элемент (объект) и дочерние атрибуты объекта. Например: Module/Object/Attribute/Name.
Дополнительная информация приведена в разделе Схема Rational DOORS.
- Добавьте параметры форматирования и стиля элементов, чтобы
настроить их внешний вид в выводе.
- Создайте фильтры для ограничения данных, добавляемых в отчет. С помощью фильтров, представляющих собой более детализированные
разновидности общего URI источника данных, можно указывать конкретные
подмножества данных, так чтобы
Rational Publishing Engine
не извлекал больше информации, чем необходимо, из источника данных во
время генерации отчета. Эти фильтры должны быть
достаточно широки для извлечения всех необходимых данных,
на которые ссылается шаблон, в противном случае
генерируемый отчет будет неполным. К запросам на ссылки можно применять стандартные
фильтры. Дополнительная информация приведена в разделе Пример: внутренние фильтры Rational DOORS.
- Создайте
сортировки для организации данных в отчете. Для
Rational DOORS
текст внутренней сортировки должен быть в формате сортировки
Rational DOORS.
Дополнительная информация приведена в разделе Пример: внутренние сортировки в Rational DOORS.
Дальнейшие действия
В случае
предварительного
просмотра данных в приложении Document Studio, для извлечения
данных используются представление и контрольная версия по умолчанию.