文档模板

文档模板是用于生成文档的蓝图。模板定义要从数据源中截取哪些数据以及如何在输出中格式化这些数据。

文档模板是自包含归档文件,扩展名为 .dta(文档模板归档)。Rational® Publishing Engine 模板与可能随附其他产品提供的模板稍有不同。对于其他产品,模板为使用信息预填充的示例工件,供您学习和定制。在 Rational Publishing Engine 中,模板为用于构建报告输出的基本文件。模板中可能具有预填充的信息,如果您以其他人的模板文件作为基本文件,那么新模板为空。

使用 IBM® Rational Publishing Engine 先前版本创建的文档模板可以与最新版本一起使用。但是,如果数据提供者不支持最新版本的 Rational Publishing Engine 模板结构,那么您可以将模板版本设为使用来自 Rational Publishing Engine 先前版本的模板结构。

可以在文档模板中添加静态和动态内容。静态内容包含设计模板时所提供的文本和图像。动态内容由生成文档时从数据源获取的数据表示。模板也定义格式化信息,虽然某些数据可能会保留数据源内嵌入这些数据中的格式化信息。

一个文档模板可包含:

模板中的数据源模式

定义模板时,请使用您数据结构的定义(称为模式),而不使用静态数据。模式可让模板应用到其结构与该定义数据源的结构相匹配的任何数据源。一个模板可以包含任何数目的数据源模式。

当数据源与数据源模式不完全匹配时,Rational Publishing Engine 会处理与该模式相匹配的元素并忽略非关键错误。 例如,如果在模板中使用 Rational DOORS® 属性 status,但实际数据源(Rational DOORS 模块)没有此属性,那么缺省情况下,会继续生成文档。

Rational Publishing Engine 提供用来为多种数据源类型(例如 IBM Rational DOORSIBM Rational Tau 和 Rational REST 数据源)创建或获取模式的机制。有关标准模式定义的更多信息,请参阅 http://www.w3.org/XML/Schema。可以使用第三方应用程序从 XML 数据生成模式。

模板复用

可复用已存储在本地、远程位置或“中央管理”组件中的模板内的模板结构。创建新的模板之后,当您正在导入的模板不影响其他模板时,您可以将整个模板导入您正在处理的主模板。为您经常复用的文档部分(例如页眉和页脚)创建片段。

导入模板时,您可以动态引用它们,也可以物理嵌入它们。动态引用模板或所包括的文件时,根据生成模板时所使用的输出类型,生成输出时您是在添加指向该模板或文件的链接或者装入已导入模板的内容。 物理嵌入模板或文件时,您是在将其内容立即导入主模板,而不是在运行时导入。

如果主模板与您正在引用或嵌入的模板之间有任何冲突,那么系统会提示您解决这些冲突。例如,冲突可能包括不同的数据源模式。当数据源模式不同时,可将已导入的模板中的模式添加到主模板以解决冲突。

缺省文档规范

缺省情况下,每一个模板都与空白文档规范相关联。从 Document Studio 应用程序预览或发布模板时,无论是否对该空白文档规范进行定制,都可以使用此空白文档规范来生成输出。当您打开或保存模板时,Document Studio 会将该模板与缺省文档规范保持同步。

反馈