设计模板时,可能必须计算值或者使数据属性可以在它们通常不可用的上下文中使用。对于这些情况,可以定义变量并给变量赋值。值可以为静态数据,也可以是当前上下文中的可用数据。
关于此任务
变量可以用作运行时计算的数据的占位符(变量赋值),也可以在文档规范中提供。与数据属性不同,您还可以在母版页中使用变量。
变量有两种类型:
- 用户定义的变量:用户定义的变量由模板设计者所定义。用户定义的变量可以是内部的,也可以是外部的。
- 用户定义的内部变量:将变量指定为内部变量以执行计算或临时存储信息,例如用来将数据带入母版页的变量。内部变量不会显示在文档规范中;因此,您无法向这些变量提供值。
- 用户定义的外部变量:当您向变量提供值时,将变量指定为外部变量。外部变量会显示在文档规范中。请参阅创建文档规范。
- Rational® Publishing Engine 变量:Rational Publishing Engine 变量是可用在文档模板中的内部变量。
表 1. 内部变量变量 |
描述 |
_element_id |
保留在模板内部,用于调试。 |
_element_level |
元素的递归级别。 |
_row_number |
当前表中的行号。如果元素不是行,那么值为 0。 |
_cell_number |
当前行中的单元格号。如果元素不是单元格,那么值为 0。 |
过程
- 在大纲视图中,单击。此时,会打开“新建变量”窗口。
- 在下列字段中输入变量详细信息:
- 名称:输入变量的名称。 由于会在脚本中使用有效 Java™ 或
JavaScript 标识,因此变量名称必须使用这些标识。
- 描述:输入变量的描述。
- 缺省值:输入变量的值。
- 访问:从列表中选择变量是内部变量还是外部变量。
- 内部变量不会显示在文档规范中,因此您无法向这些变量提供值。
- 外部变量会显示在文档规范中,因此您可以向这些变量提供值。
- 要将变量分配给元素,请执行下列操作:
提示: 尽可能将变量分配给容器元素。该变量会应用到容器元素中的元素。例如,您可能想要在表中使用变量,以便为每个变量新建一行。如果将变量分配给表元素,那么可为每个变量创建一个表。有时这些连续表会合并,但有时它们会显示为单独的表。如果在表中添加一个容器元素并将行拖入容器元素中,然后将变量分配给容器元素,那么将使用每个变量的行来创建单个表。
- 右键单击元素,然后单击。 此时,会打开“分配编辑器”窗口。
- 单击添加。 此时,会打开“选择变量”窗口。
- 输入变量的名称,然后单击确定。
- 单击“分配编辑器”窗口中的确定。
结果
所选变量已定义且分配给当前元素。
当您将变量分配给元素时,元素会在模板内容编辑器中显示一个
图标。
下一步做什么
提示: 要搜索元素中所使用的变量分配列表,您可以右键单击变量所分配给的元素,并选择。此时,会打开“搜索”视图并显示一个变量分配列表。可以双击结果中的变量分配以进行编辑。
要搜索元素中所使用的变量分配、属性和查询的列表,请右键单击元素,并选择。此时,会打开“搜索”视图并显示一个列表。可以双击结果中的项目以进行编辑。