Когда вы интегрируете
Rational Publishing Engine
с
Rational DOORS,
вы можете генерировать документы непосредственно из
Rational DOORS.
Перед тем, как начать
Изучите модуль
Rational DOORS,
с которым вы собираетесь работать, и его содержимое. Для того чтобы найти в справочной
системе Information Center информацию о нужной версии
Rational DOORS,
обратитесь к разделу
О
продукте
Rational DOORS
Information Center.
Совет: Вы можете использовать сочетание свойств модуля,
атрибутов объектов и представлений, хранящихся в модулях.
Просмотрите модуль и выясните,
какие из имеющихся в нем представлений содержат вычисляемые столбцы, включая трассируемые
представления и, возможно, столбцы DXL макета. Эти представления не соответствуют
атрибутам
Rational DOORS,
но в них может быть информация, заслуживающая включения в отчет.
Установка
Установите
Rational DOORS
до установки
Rational Publishing Engine.
Rational Publishing Engine
должен изменить ключ реестра, созданный
Rational DOORS.
Прим.: Установка
Rational Publishing Engine
в Windows обновляет несколько записей реестра
для
Rational DOORS.
Если
Rational DOORS
устанавливается после
Rational Publishing Engine,
откройте
IBM® Installation Manager,
нажмите кнопку
Изменить и следуйте
инструкциям мастера
Rational Publishing Engine,
чтобы сбросить конфигурацию
Rational DOORS.
Это приведет к обновлению последних изменений в реестре, внесенных программой установки
Rational Publishing Engine.
Инструкции по обновлению реестров вручную приведены в разделе
Обновление реестров Rational DOORS вручную.
Во время установки
Rational Publishing Engine
вы можете установить встраиваемый модуль
Rational DOORS.
После установки встраиваемого модуля вы сможете публиковать шаблоны
Rational Publishing Engine
непосредственно из
Rational DOORS.
Если
Rational Publishing Engine
устанавливается до
Rational DOORS,
то ключ реестра не обновляется и
Rational DOORS
не может найти модуль Publish, содержащийся во встраиваемом модуле
Rational DOORS.
Компоновка шаблона
- Сгенерируйте новую схему с помощью мастера поиска схемы
Rational DOORS. Когда вы находите схему модуля
Rational DOORS,
вы можете решить, какие атрибуты и столбцы следует сделать доступными для использования в
шаблоне. Эти элементы можно выбрать и поместить их в шаблон. См. раздел
Добавление схемы источника данных Rational DOORS с помощью мастера поиска схемы.
Кроме того, впоследствии атрибуты можно будет повысить при проектировании шаблона.
Атрибуты добавляют декларативную информацию в элементы, помимо обычных предопределенных
ключевых слов.
Пользовательские атрибуты
Rational DOORS
доступны только через узлы Attribute в стандартном файле схемы
Rational DOORS. Для использования этих атрибутов можно их поднять до атрибутов XML,
используя мастер поиска схемы XML. У атрибута может быть
единственное вхождение, например, Module
Name, и свойство Last Modified
On. Атрибуты могут применяться к объектам и иметь
несколько вхождений, например Object
Heading и Object Text. Вы можете также выяснить, какие атрибуты
объекта присутствуют в модуле
Rational DOORS,
а затем оценить, насколько они необходимы в отчете
Rational Publishing Engine.
С помощью пункта меню
откройте список атрибутов, включенных в модуль.
- Добавьте данные в шаблон с помощью
запросов,
атрибутов
и
переменных.
- Спроектируйте шаблон с помощью Document Studio. См.
раздел
Создание шаблонов с помощью Document Studio.
Подключившись к схеме источника данных, спланируйте
структуру документа и определите содержимое для извлечения
данных.
Обзор процесса разработки
шаблона приведен в разделе
Разработка шаблонов документов. Если документ велик, то вы можете создать отдельные шаблоны
для каждого блока документа.
- Создайте общий элемент контейнера для хранения
нескольких абзацев.
Каждый абзац контролируется тестовым
условием, связывающим его только с определенными данными из
исходного модуля
Rational DOORS.
Для создания вывода используются управляющие символы
форматирования и спецификации стилей. См. раздел
Добавление элементов в шаблон.
Для хранения аналитических диаграмм
Rational DOORS,
содержащихся в таблице 1x1, можно использовать элементы контейнера
вместо таблиц.
- Создайте таблицу из данных
Rational DOORS.
См. раздел
Добавление элемента таблицы. Прямая поддержка воспроизведения таблицы
Rational DOORS
в точности так, как она представлена в
Rational DOORS,
отсутствует; вы можете воспользоваться имеющимися
атрибутами таблицы
Rational DOORS
и создать новую таблицу.
- С помощью элемента Data Source
Configuration вы можете определить некоторые
свойства, неизвестные на момент выполнения. См. раздел
Добавление элемента конфигурации источника данных. Например, вы можете добавить проект
Rational DOORS,
который пока еще не создан, и сгенерировать пробный отчет
для использования в будущем.
- С помощью фильтров, представляющих собой более детализированные
разновидности общего URI источника данных, можно указывать конкретные
подмножества данных, так чтобы
Rational Publishing Engine
не извлекал больше информации, чем необходимо, из источника данных во
время генерации отчета. Эти фильтры должны быть
достаточно широки для извлечения всех необходимых данных,
на которые ссылается шаблон, в противном случае
генерируемый отчет будет неполным. Дополнительная
информация об использовании фильтров
Rational Publishing Engine
в стандартном виде, приведена в разделе
Извлечение
данных с помощью стандартных фильтров.
Публикация документа
- После создания шаблона отчета и заполнения его
указателями на данные
Rational DOORS
вы можете приступить к генерации отчета в различных
форматах. Когда вы генерируете отчет, вы должны быть
подключены к источнику данных, содержащему информацию для
включения в отчет. Инструкции по созданию указателей на
соответствующие данные приведены в разделе
Подключение к источнику данных Rational DOORS.
Совет: Вы можете извлечь объекты OLE (связывание и внедрение объектов)
из источника данных
Rational DOORS. См. раздел
Объекты OLE.
- Если схемы источников данных добавляются в
шаблон после назначения шаблона спецификации документа, то
спецификация документа становится несинхронизированной. Вы
можете
вручную
синхронизировать спецификацию документа или выбрать
опцию автоматической синхронизации спецификации документа с
текущим шаблоном. Инструкции по настройке параметра
Сохранить синхронизацию спецификации документа с
текущим шаблоном? приведены в разделе
Настройка параметров создания документов.
- Перед тем, как опубликовать документ,
ознакомьтесь с разделом
Задание свойств вывода,
содержащим дополнительную информацию об имеющихся опциях
вывода и позволяющим определить, какая из них окажется
наиболее подходящей для элементов шаблона.
- Теперь вы готовы к тому, чтобы
опубликовать документ. См. раздел
Создание документа.
- Если вы установили встраиваемый модуль
Rational DOORS,
то вы можете публиковать непосредственно из
пользовательского интерфейса
Rational DOORS.
- Когда вы нажимаете Опубликовать в панели
База данных, вам предлагается указать конфигурации шаблона и
спецификации документа, как в случае выбора
в разделе
Rational Publishing Engine.
- При нажатии кнопки Опубликовать на панели
Модуль, можно выбрать новую спецификацию документа и добавить в нее
шаблоны; кроме того, можно выбрать существующую спецификацию
документа, в которую уже добавлены шаблоны. Затем, если шаблон использует
источник данных
Rational
DOORS,
Rational Publishing Engine
настраивает этот источник для вас, основываясь на
информации из открытого модуля, для генерации документа. Если какая-либо информация о конфигурации, существующая в
спецификации документа, не соответствует информации в
открытом модуле, то она заменяется на информацию из
открытого модуля.
Прим.: В версии Rational Publishing Engine
1.1.2.2 пользователь мог выбрать шаблон для публикации и спецификация
документа создавалась в автоматическом режиме. В
Rational Publishing Engine
1.2 и более поздних версиях пользователи должны создавать
спецификации документов перед
публикацией, поскольку они больше не создаются в автоматическом
режиме.
Важное замечание: В
случае локального создания документов Rational Publishing Engine
может подключаться к активному клиенту
Rational DOORS; однако такая возможность не предусмотрена для удаленного создания
документов.
Если публикация выполняется с помощью удаленной службы создания
документов на панели База данных или Модуль, укажите
идентификационные данные в спецификации документа перед
созданием документа, чтобы удаленная служба Rational Publishing Engine
могла создать новый экземпляр клиента
Rational DOORS для извлечения данных отчета.