数据属性定制文档如何显示内容。使用数据属性来添加目录,以及定制计算值,定义条件、过滤器、条件格式化属性和样式。
计算值
创建 JavaScript 片段以处理数据属性。可使用这些片段来合并数据属性、修剪空格以及将数字值变换为文字描述。可以从当前上下文处理任何数据属性,当前上下文包含元素的查询属性以及元素的所有父查询的属性。
条件
使用基于数据属性或模板变量的表达式来定义何时呈现元素的条件。条件是求值为布尔值的 JavaScript 表达式。
过滤器与条件
虽然过滤器与条件看起来相似,但它们是两种用途不同的机制:
- 从数据源抽取数据时可以评估过滤器。
- 只能在从数据源抽取数据之后才能评估条件。
一个条件只能对一个元素评估一次,即使该元素是查询亦如此。因此,不能将当前查询用作条件的上下文。
虽然有时可以使用条件取代过滤器,但使用过滤器可以获得更好的性能,因为只需处理一个数据子集。
条件格式
可以使用表达式根据数据属性值来定义格式化属性。条件格式化类似于元素属性,例外是返回值取决于属性类型。
可变的元素
可以编辑下列各项的内容:文本、样式化文本、图像、包含文件、书签和超链接。双击元素以编辑其内容。
Microsoft Word 文档中的目录、图和表
要在输出中添加目录,请在模板或样式表中定义目录。如果在模板中定义目录,那么目录只有在您更新文档字段之后才会显示在 Microsoft Word 文档中。要更新字段,请使用 Microsoft Word 中的“更新字段”或“更新表”功能,或者使用 rpe.dot 样式表中包含的宏。可以在 Rational® Publishing Engine 安装中找到 rpe.dot 样式表:%RPE_HOME%\utils\word\rpe.dot。同一个过程适用于图目录和表目录。
Microsoft Word 文档中的文字说明
不会自动更新图文字说明和表文字说明。要更新字段,请使用 Microsoft Word 中的“更新字段”功能,或者使用 rpe.dot 样式表中包含的宏。可以在 Rational Publishing Engine 安装中找到 rpe.dot 样式表:%RPE_HOME%\utils\word\rpe.dot。
页眉样式
要使用 Microsoft Word 的预定义页眉样式(标题 1、标题 2 ... 标题 9)和 HTML 的预定义页眉样式(H1、H2 ... H9),请使用样式名称 1、2...9。PDF 和 XSL-FO 输出格式没有标题样式;但是,Rational Publishing Engine 使用内部定义的标题样式。
格式化属性与样式
定义样式,而不是更改模板元素的各个格式化属性。
Rational Publishing Engine 样式与外部样式
如果主输出是 Microsoft Word 或 HTML,请尽可能使用在样式表中定义的外部样式。此方法可让您快速更改输出文档的外观,并在公司实施一致的外观。
Microsoft Word 的编号标题
将样式表与编号标题一起使用,以获取编号为分层列表的标题。
输出中的 Unicode 数据
如果使用的字体支持 Unicode,那么会呈现所有 Unicode 数据。
- 对于 PDF 输出,必须进行附加配置。有关详细信息,请参阅 PDF 输出设置。如果使用了非 Unicode 字体,请使用 TrueType Unicode 字体重新生成文档并设置适当的输出属性。
- 对于 Microsoft Word 输出,如果使用了非 Unicode 字体,请在生成文档之后在输出文档中更改字体。
- 对于 HTML 输出,如果使用了非 Unicode 字体,请在生成文档之后在样式表中更改字体系列。