设计模板的 PDF 输出参考

复审此信息以了解有关如何使用 Rational® Publishing Engine PDF 驱动程序来生成 PDF 文档的更多信息。

用途

将模板输出为 .pdf 文档。

受支持的内容查看器

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

缺省 PDF 驱动程序会生成 V1.5 PDF 文件。不再支持旧的 PDF 驱动程序。如果文档规范指向旧的 PDF 驱动程序,请修改规范以引用缺省 PDF 驱动程序。

模板元素

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

“段”图标

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

“容器”图标 容器

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

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

“文本”图标 文本

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

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

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

“超链接”图标 超链接

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

“图像”图标 图像

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

“表”图标

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

“行”图标

在当前表中创建行。

“单元格”图标 单元格

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

“列表”图标 列表

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

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

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

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

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

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

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

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

“区域”图标 区域

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

“书签”图标 书签

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

“分页符”图标 分页符

在输出中添加分页符。

“分节符”图标 分节符

在输出中添加分节符。

“目录”图标 目录

在输出中添加目录。

“页码”图标 页码

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

“总页数”图标 总页数

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

如果生成 PDF 的速度变慢,请将 “分节符元素”图标 分节符元素添加至模板以提高性能。

元素属性

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

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

表 7. 列表属性
列表属性 注意
编号样式 可以使用下列样式:
  • 项目符号:无序列表
  • 阿拉伯文:编号列表
  • 大写罗马体:大写罗马数字
  • 小写罗马体:小写罗马数字
  • 大写字母:大写字母
  • 小写字母:小写字母
编号字符间距 请不要用于此输出格式。
表 8. 列表详细信息属性
列表详细信息属性 注意
边框宽度 请不要用于此输出格式。
表 9. 页码属性
页码属性 注意
边框宽度 请不要用于此输出格式。
表 10. 段属性
段属性 注意
边框宽度 必须指定一个介于 130 个像素之间的边框宽度值,才能在输出中创建边框。
段落对齐 使用特定对齐方式给页面上的文本添加间隔。

Leftrightcenter 对齐会创建不规则的段边缘,让段容纳尽可能多的字。Justify 会通过在所有行(最后一行除外)上的字之间插入额外间隔来创建规则段边缘。

请不要将 distributed 用于此输出格式。

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

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

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

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

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

如果值为 false,请清除表的宽度自动适合窗口属性。将使用缺省列大小(一英寸)来生成表。

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

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

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

包含文件元素

您可以选择链接该文件,也可以选择将该文件以物理方式嵌入输出文档。但是,处理包含文件元素的方式取决于输出格式以及您从中检索文件的位置。 对于 PDF 输出,会导入包含的文件且显示文档的完整内容。

标题样式

PDF 输出格式没有标题样式;但是,Rational Publishing Engine 使用内部定义的标题样式。

输出中的 Unicode 数据

如果使用的字体支持 Unicode,那么会呈现所有 Unicode 数据。对于 PDF 输出,必须进行其他配置。有关详细信息,请参阅 PDF 输出设置。如果使用了非 Unicode 字体,请使用 TrueType Unicode 字体重新生成文档并设置适当的输出属性。

OLE 对象

可从数据源中的属性抽取嵌入式对象,例如对象链接与嵌入(OLE 对象)。但是,OLE 对象总是呈现为 PDF 输出中的图像,因为该格式不支持 OLE 对象。