设计模板的 Microsoft Word 输出参考

复审此信息以了解有关使用 Rational® Publishing Engine 来生成 Microsoft Word 文档的更多信息。

用途

将模板输出为下列文档:
扩展名 所生成文档的格式
.doc Microsoft Word 二进制文档 1997-2003、2007、2010 或 2013
.docx Microsoft Word 2007、2010 或 2013 无法运行宏
.docm Microsoft Word 2007、2010 或 2013 可以运行宏

受支持的内容查看器

要获取查看此输出类型时支持的产品的列表,请执行下列操作:
  1. 打开Rational Publishing Engine的系统要求
  2. 按类型部分中,单击软件
  3. 滚动到内容查看器部分。 系统会列示查看 Rational Publishing Engine 输出时支持的产品名称和版本。

模板元素

表 1. 可用于 Microsoft Word 输出格式的模板元素
元素 描述 可以包含其他元素 可以包含内容值和表达式

“段”图标

用来对元素部分进行分组。在输出中其子元素周围添加一个回车符。

“容器”图标 容器

用来对元素部分进行分组。无法设置样式,因此不会影响输出的格式。

在其他元素内部使用时,可用于容器的子元素可能受限。例如:
  • 在行内部,容器只能主管单元格
  • 在列表内部,容器只能主管列表细节元素

“文本”图标 文本

内容以相同的指定格式进行呈现。

“具有样式的文本”图标 具有样式的文本

文本块中的个别单词可以具有独特的格式。对元素中的所选单词使用粗体、斜体、下划线、删除线或颜色格式。文本是静态的。

“超链接”图标 超链接

在输出中创建超链接。超链接可以指向文档内部的位置,也可以指向外部位置。

“图像”图标 图像

在输出中显示 .gif.png.jpgemfwmf 图像。图像路径可以由报告设计者在模板中指定,也可以由报告生成者在运行时指定。

“表”图标

在输出中创建表。表可以包含行元素或容器元素。

“行”图标

在当前表中创建行。

“单元格”图标 单元格

在当前表的当前行中创建单元格。

“列表”图标 列表

在输出中创建项目符号列表或数字列表。

“列表项”图标 列表详细信息

在输出的当前列表中创建列表项目。

“数据源配置”图标 数据源配置

请参阅添加数据源配置元素

“包括文件”图标 包括文件

将输出中的指定文件包括为 INCLUDETEXT 字段。

  • 包括的文件可以具有 .doc.docx.txt.rtf 扩展名。
  • 对于 Microsoft Word 输出,必须更新包含宏的所有字段,才能看到包括的文件。
  • 对于旧 PDF、HTML 和 XSL-FO 输出,包括的文件是文档的超链接。

“脚注”图标 脚注

在当前输出页面中创建脚注。脚注的文本是脚注元素的内容。只有 Microsoft Word 输出才支持。

“区域”图标 区域

区域是静态元素,使您可以通过重定向其他元素或元素组的内容来变更输出流。如果使用区域元素的名称给元素指定了目标区域属性,那么该属性的内容会在指定区域中呈现,而不是在文档中该属性所在的位置呈现。

“书签”图标 书签

在文档中定义书签。所生成的书签的名称是书签的内容。生成文档时,Rational Publishing Engine 会为每个书签生成唯一名称。该名称基于设计时提供的名称,并且是运行时生成的唯一标识。

“注释”图标 注释

在输出中添加注释。输出注释的形式和形状特定于输出格式。

Microsoft Word 和 PDF 会支持。

“分页符”图标 分页符

在输出中添加分页符。

“分节符”图标 分节符

在输出中添加分节符。

“目录”图标 目录

在输出中添加目录。

“表目录”图标 表目录

在输出中添加表目录。必须在文档模板中添加表文字说明,才能在输出中生成表目录。

只有 Microsoft Word 输出才支持。

必须更新 Microsoft Word 文档中的所有字段,才能查看和更新字段的值。

“表目录”图标 表目录

在输出中添加表目录。必须在文档模板中添加表文字说明,才能在输出中生成表目录。

只有 Microsoft Word 输出才支持。

必须更新 Microsoft Word 文档中的所有字段,才能查看和更新字段的值。

“字段”图标 字段

添加通用 Microsoft Word 字段元素。可以在字段代码属性中输入任何有效的 Microsoft Word 代码。

只有 Microsoft Word 输出才支持。

必须更新 Microsoft Word 文档中的所有字段,才能查看和更新字段的值。

“页码”图标 页码

在输出中添加页码。仅 Microsoft Word 和 PDF 输出会支持。

“总页数”图标 总页数

在输出中添加总页数。只有 Microsoft Word 和 PDF 输出才支持。

“表文字说明”图标 表文字说明

添加表文字说明。虽然不能在表文字说明中指定动态内容,但任何后续文本元素都会并置到表文字说明。

Microsoft Word 和 PDF 输出会支持。

必须更新 Microsoft Word 文档中的所有字段,才能查看和更新字段的值。

“图文字说明”图标 图文字说明

添加图文字说明。虽然不能在图文字说明中指定动态内容,但任何后续文本元素都会并置到图文字说明。

Microsoft Word 和 PDF 输出会支持。

必须更新 Microsoft Word 文档中的所有字段,才能查看和更新字段的值。

元素属性

复审这些注释以了解有关在专门为生成 Microsoft Word 文档而设计的模板中指定元素属性的更多信息。
表 2. 单元格属性
单元格属性 注释
边框宽度 必须指定一个介于 130 个像素之间的边框宽度值,才能在输出中创建边框。
单元格对齐 此属性指定文本在单元格中的位置。此输出格式不支持 justify 值。
单元格宽度 输入一个值(以点或像素计)。如果输入以像素计的值,那么会将该值换算成磅数并假设显示为 96 dpi。如果输入百分比值,那么将忽略该值。合并表时,必须设置单元格宽度属性以确保列大小相同。
表 3. 注释属性
注释属性 注释
内容 如果将超链接包括在注释元素的内容属性中,那么这些超链接在 Microsoft Word 输出中不可单击。
表 4. 图文字说明属性
图文字说明属性 注释
边框宽度 请不要用于此输出格式。
字段代码 阿拉伯数字或罗马数字会在每个文字说明上按顺序显示。
表 5. 脚注属性
脚注属性 注释
样式名称 如果将样式应用于内嵌的元素(例如脚注、文本、具有样式的文本或表),那么会将该样式应用于所有内嵌的元素,直到下一个块元素(例如段)。例如,如果将样式添加至脚注元素并且在它前面存在一个具有样式的文本元素,那么该样式也会应用于该具有样式的文本元素。
表 6. 图像属性
图像属性 注释
边框宽度 请不要用于此输出格式。
内容 受支持的图像格式:.bmp.emf.gif.jpg.png.wmf

.svg 图像受 Rational Publishing Engine 支持,但是不受 Microsoft Word 支持。为了将文档正确生成为 Microsoft Word 输出,会将 .svg 图像转换为 .png 图像。该转换过程可使图像在输出中的显示失真。

表 7. 列表详细信息属性
列表详细信息属性 注释
边框宽度 请不要用于此输出格式。
表 8. 页码属性
页码属性 注释
边框宽度 请不要用于此输出格式。
表 9. 段属性
段属性 注释
边框宽度 必须指定一个介于 130 个像素之间的边框宽度值,才能在输出中创建边框。
段落对齐 使用特定对齐方式给页面上的文本添加间隔。

Leftrightcenter 对齐会创建不规则的段边缘,让段容纳尽可能多的字。Justify 会通过在所有行(最后一行除外)上的字之间插入额外间隔来创建规则段边缘。 Distributed 类似于 justify,但不同之处在于,也会在段的最后一行上的两个字之间插入该间隔。

未排足行/孤立字控制 如果设为 true,那么会调整行间距以防止下列格式结果:
  • 作为段尾的单字会换行
  • 作为段尾的单行会换页

如果设为 false,那么不会调整间距。

表 10. 行属性
行属性 注释
分页换行 如果设为 true,那么会根据需要分割页尾的行内容。该页面无法装入的内容会换到下一页并另起一行。

如果设为 false,那么不会分割页尾的行内容。一整行都会换到下一页。

表 11. 具有样式的文本属性
具有样式的文本属性 注释
样式名称 如果将样式应用于内嵌的元素(例如脚注、文本、具有样式的文本或表),那么会将该样式应用于所有内嵌的元素,直到下一个块元素(例如段)。例如,如果将样式添加至脚注元素并且在它前面存在一个具有样式的文本元素,那么该样式也会应用于该具有样式的文本元素。
表 12. 表属性
表属性 注释
自动适合内容 调整表的大小以适合每个单元格包含的内容。使用此属性时,也请将根据内容调整大小属性设为 true
边框宽度 必须指定一个介于 130 个像素之间的边框宽度值,才能在输出中创建边框。
边框样式 请使用值 single 而不是 thickhairlineinsetoutset。相同格式设置会对所有这些值进行应用,并且最类似于针对 single 时您将期望看到的内容。
列中的固定单元格宽度 指定值(以像素计)以确保列中的所有单元格都具有相同的宽度。
根据内容调整大小 如果设为 true,那么不会换行,除非存在空格。如果没有空格,那么不会换行,并且会将列宽增大为文本的宽度。如果设置自动适合内容,那么必须将根据内容调整大小设为 true

如果设为 false,那么会固定列宽并且换行,而不管使用的空格或文本长度。此外,会忽略表自动调整属性。

样式名称 如果将样式应用于内嵌的元素(例如脚注、文本、具有样式的文本或表),那么会将该样式应用于所有内嵌的元素,直到下一个块元素(例如段)。例如,如果将样式添加至脚注元素并且在它前面存在一个具有样式的文本元素,那么该样式也会应用于该具有样式的文本元素。
表自动调整 如果设为 true,那么会调整表的大小以适合页面的宽度。如果根据内容调整大小也设为 true,那么会忽略单元格宽度并调整表格的大小以与内容匹配。

不能输入 fixed column width 作为值。请改用 fixed cell width 属性。

宽度 必须指定值。
表 13. 表文字说明属性
表文字说明属性 注释
边框宽度 请不要用于此输出格式。
字段代码 阿拉伯数字或罗马数字会在每个文字说明上按顺序显示。
表 14. 文本属性
文本属性 注释
边框宽度 必须指定一个介于 130 个像素之间的边框宽度值,才能在输出中创建边框。
样式名称 如果将样式应用于内嵌的元素(例如脚注、文本、具有样式的文本或表),那么会将该样式应用于所有内嵌的元素,直到下一个块元素(例如段)。例如,如果将样式添加至脚注元素并且在它前面存在一个具有样式的文本元素,那么该样式也会应用于该具有样式的文本元素。
表 15. 总页数属性
总页数属性 注释
边框宽度 请不要用于此输出格式。

表长度

在设计要生成为 Microsoft Word 文档的模板时,表长度可能是一个要考虑的因素。

长表可能需要占用一页以上。当产生此要求时,请在表的“属性”视图中选择“行”元素,将 row break across page 属性设置为 true。设置该属性之后,您的表可以跨多页显示。

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 输出,在文档生成期间,Rational Publishing Engine 会自动更新 Microsoft Word 字段。如果生成了 INCLUDE TEXT 字段,那么宏尚未运行,并且导入文件的任务已委派给 Microsoft Word。只有在更新所有字段之后,输出文档中的包含文件才可视。要更新字段,请使用 Microsoft Word 中的“更新字段”功能,或者使用 RPE_HOME\utils\word\rpe.dot 样式表中包含的宏。
提示: 链接至其他文件的 Microsoft Word 文档不是自包含文档。将文档移至其他计算机会造成所链接文档的内容无法可视化。如果需要可视化,请使用 Microsoft Word 中的“断开链接”功能以包含所链接文件的内容。

标题样式

要使用 Microsoft Word 的预定义标题样式(标题 1、标题 2 ... 标题 9),请使用样式名称 1、2 至 9。

Rational Publishing Engine 样式与外部样式

请尽可能使用在样式表中定义的外部样式。此方法可让您快速更改输出文档的外观,并在公司实施一致的外观。

Microsoft Word 的编号标题

将样式表与编号标题一起使用,以获取编号为分层列表的标题。

输出中的 Unicode 数据

如果使用的字体支持 Unicode,那么会呈现所有 Unicode 数据。对于 Microsoft Word 输出,如果使用了非 Unicode 字体,请在生成文档之后在输出文档中更改字体。

OLE 对象

可从数据源中的属性抽取嵌入式对象,例如对象链接与嵌入(OLE 对象)。对于 Microsoft Word 输出,必须在文档规范的元数据部分中设置 OLE(作为静态图像)属性。
ref 文件夹包含 OLE 对象的 .rtf 文件。对于导出的每个 OLE 对象,Microsoft Word 输出都包括一个字段,该字段指向一个 .rtf 文件。因为 IBM® Rational Publishing Engine 无法更新 Microsoft Word 字段,所以在打开 Microsoft Word 文档时看不到包括的字段。要使这些字段可视,请执行下列其中一个操作:
表 16. 操作
操作 结果
选择文档的所有内容,并使用 Microsoft Word 中的更新字段功能。 文档中会显示 OLE 对象。文档不是自包含的。
使用 Rational Publishing Engine 提供的 updateFields 宏。 文档中会显示 OLE 对象。文档不是自包含的。
使用 Rational Publishing Engine 提供的 insertOLEs 宏。 文档中会显示 OLE 对象。文档是自包含的。
使用 Rational Publishing Engine 提供的 rpeinsertOLEs 宏。 文档中会显示 OLE 对象。文档是自包含的。
注: 如果将非自包含的文档移到其他计算机,那么无法编辑 OLE 对象。要防止发生此问题,请运行 insertOLEs 宏。

反馈