创建样式标题的脚本表达式

可以在模板元素上创建标题样式,这对应于含有特定格式化属性的数据属性或变量的值。

关于此任务

在 Microsoft Word、PDF 和 HTML 输出中,可以创建章节标题并对这些标题指定标题样式,从而在文档中创建一个参考层次结构。Rational® Publishing Engine 需要这些标题的数字分配,数字分配起始于 1 以与标题样式数字对齐。可能想要将标题样式指定给的某些数据并不是起始于 1,或者使用的是字符串值,而不是数字值。每种输出格式对这些标题样式使用不同的名称,这使在所有输出格式之间标准化这些样式的过程很复杂。例如,在 Microsoft Word 中,最大的标题样式名为标题 1。在 HTML 中,相同的标题样式名为 H1

可以使用 parseInt(attribute_or_variable_name) JavaScript 表达式,使属性或变量值与起始于 1 的数字值对齐。然后,要对子数据创建子标题,请在表达式中添加一个:parseInt(attribute_or_variable_name) + 1。此脚本表达式可让值以递增方式对应于所有 Microsoft Word、PDF 和 HTML 输出中的标题样式。

过程

  1. “文本”图标 文本元素拖到模板内容编辑器。
  2. 选择文本元素。
  3. 在“属性”视图中,选择常规选项卡。
  4. 样式名称字段中,单击 “配置”图标 配置图标。
  5. 选择脚本表达式选项卡。
  6. 选择变量或属性。
  7. 输入 JavaScript 表达式:parseInt(attribute_or_variable_name) + 1
  8. 单击确定

示例

此示例使用 RequisitePro.xsd 通用 XML 模式,这会在 PRRequirement 查询中包含级别属性。

本示例中模板所创建的最终输出文档:
  • FullTag 值显示为章节标题。
  • 显示需求的可视层次结构:
    • 需求是最大标题,使用标题 1 样式。
    • 子需求是子标题,使用标题 2 样式。
  • 根据级别属性的值创建层次结构。
要使用应用到 FullTag 的标题样式来创建报告,请执行下列操作:
  1. 在 Launcher 中,创建文档规范并配置数据源。
  2. 在 Document Studio 中,打开新模板。
  3. 添加样本数据源模式:
    1. 数据源模式视图中,单击添加数据源模式图标。此时,会打开“数据源模式”向导,您可以单击下一步
    2. 在“模式类型”字段中,选择通用 XML
    3. 单击浏览,然后选择随产品安装的 RequisitePro.xsd 样本数据文件。缺省位置:%RPE_HOME%\source\XML\examples\RequisitePro.xsd。单击打开
    4. 输入数据源标识的定制名称。
    5. 单击下一步。复审所作的选择并单击完成
  4. 将元素添加至模板。
    1. 添加 “容器”图标 容器元素。
    2. “段”图标 元素插入容器元素。
    3. “文本”图标 文本元素插入段元素。
      含有元素的模板示例
  5. 将查询添加至元素。
    1. 数据源模式视图中,展开项目和需求。
    2. PRRequirement 拖到容器元素。
    3. FullTag(字符串)拖到文本元素。
    4. 在“选择上下文”窗口中,选择用作值
    5. 选择 PRRequirement 容器,然后单击确定
      元素中含有查询的模板示例
  6. 为段元素创建样式脚本表达式。
    1. 选择段元素。
    2. 在“属性”视图中,选择常规选项卡。
    3. 样式名称字段中,单击 “配置”图标 配置图标。
    4. 在“设置样式名称值”窗口中,选择脚本表达式选项卡。
    5. 展开属性和数据源。
    6. 选择级别
    7. 输入 parseInt(Level) + 1
  7. 单击发布 > 生成文档以生成输出。

    级别值增加 1,标题样式也会增加 1。在级别值为 0 的需求的 FullTag 值上,设置标题 1 样式。在级别值为 1 的需求的 FullTag 值上,设置标题 2 样式。

下一步做什么

标题样式是使用脚本表达式来应用的最常用样式。但是,您可能还必须尝试将脚本表达式应用到字体大小、边框大小或页边距大小。

反馈