Шаблоны документа

Шаблон документа - это основа для создания документов. Шаблон определяет, какие данные должны извлекаться из источника данных, и как они должны форматироваться в выводе.

Шаблоны документов представляют собой независимые файлы архива с расширением .dta (Document Template Archive). Шаблоны Rational Publishing Engine незначительно отличаются от шаблонов, которые могут входить в состав других продуктов. С другими продуктами шаблоны являются примерами артефактов с информацией, в которую можно внести изменения. В Rational Publishing Engine шаблон представляет собой базовый файл со структурой вывода отчета. Шаблоны могут содержать предварительно указанную информацию, если вы дополняете существующий шаблон, однако новый шаблон создается пустым.

Шаблоны документа, созданные в предыдущей версии IBM® Rational Publishing Engine, работают с последней версией. Однако, если поставщик данных не поддерживает последнюю версию структуры шаблона Rational Publishing Engine, то можно задать версию шаблона для использования структуры шаблона из предыдущей версии Rational Publishing Engine.

В шаблон документа можно добавлять как статическое, так и динамическое содержимое. Статическое содержимое включает текст и изображения, предоставляемые при проектировании шаблона. Динамическое содержимое представляется данными, получаемыми из источников данных во время документа. Шаблон также определяет информацию о форматировании, хотя для некоторых данных может сохраняться вложенная в них информация о форматировании от источника данных.

Шаблон документа может содержать:

Схема источника данных в шаблонах

При определении документа пользователь использует определение структуры данных (схему), а не статические данные. Схема позволяет применять шаблон к любым источникам данных, структура которых совпадает со структурой источника данных из определения. Шаблон может содержать любое число схем источников данных.

При неточном совпадении источника данных со схемой источника данных программа Rational Publishing Engine обрабатывает элементы, которые совпадают со схемой, и игнорирует несущественные ошибки. Например, если в шаблоне используется атрибут status Rational DOORS, но фактический источник данных (модуль Rational DOORS) не имеет этого атрибута, то создание документа продолжается по умолчанию.

Rational Publishing Engine предоставляет механизмы создания или получения схем для нескольких типов источников данных, таких как IBM Rational DOORS, IBM Rational Tau и источники данных Rational REST. Дополнительная информация о стандартном определении схемы приведена в разделе http://www.w3.org/XML/Schema. Для создания схемы на основе данных XML можно использовать приложение другой фирмы.

Многоразовые шаблоны

Поддерживается повторное использование структур шаблонов, сохраненных на локальном клиенте, на удаленном сервере или в компоненте Централизованное управление. После создания шаблона можно импортировать шаблоны в текущий главный шаблон, если импортируемые шаблоны не содержат ссылки на другие шаблоны. Рекомендуется создавать фрагменты кода для часто используемых разделов документов, таких как верхние и нижние колонтитулы.

В случае импорта шаблонов можно указать динамические ссылки на них или физически встроить их. Создание динамической ссылки на шаблон или включаемый файл предусматривает добавление ссылки на шаблон или файл либо загрузку содержимого импортируемого шаблона на этапе создания вывода (в зависимости от типа вывода). Физическое встраивание шаблона или файла предусматривает импорт его содержимого в главный шаблон.

Если при создании ссылки и встраивании возникнут конфликты, пользователю будет предложено устранить их. Например, конфликты могут возникнуть вследствие разных схем источников данных. В этом случае для устранения конфликта в главный шаблон можно добавить схему из импортированного шаблона.

Спецификации документов по умолчанию

Каждый шаблон по умолчанию связан с пустой спецификацией документа. В ходе предварительного просмотра или публикации шаблона с помощью приложения Document Studio пустую спецификацию документа можно дополнительно настроить или использовать для изменения вывода в исходном виде. Document Studio выполняет синхронизацию шаблона со спецификацией документа по умолчанию при открытии или сохранении шаблона.

Комментарии