内部变量

可使用 Rational® Publishing Engine 随附的内部变量来显示自动生成的有关输出中模板或文档规范的信息。
表 1. Rational Publishing Engine 内部变量
变量 描述
_cell_number 当前行中的单元格号。如果元素不是单元格,那么值为 0。可从“数据表达式”或“脚本表达式”选项卡使用 _cell_number
_element_id 模板内的元素号。保留在模板内部,用于调试。可从“数据表达式”或“脚本表达式”选项卡使用 _element_id
_element_level 元素的递归级别。如果没有为“数据”选项卡内的“递归级别”属性中的元素设置值,那么值为 1。可从“数据表达式”或“脚本表达式”选项卡使用 _element_level
_row_number 当前表中的行号。如果元素没有包含在行元素中,那么值为 0。 可从“数据表达式”或“脚本表达式”选项卡使用 _row_number
_sessionInfo 来自模板或文档规范的运行时属性信息。在“脚本表达式”选项卡中,选择 _sessionInfo 变量并输入脚本。使用其中不具有值的空引号以为输出中的属性生成缺省值。脚本示例:

_sessionInfo.getDocspecProperty(property, “”);
_sessionInfo.getTemplateProperty(property, “”);
_sessionInfo.getDatasourceProperty("data_source_name",property, “”);
_sessionInfo.getOutputProperty("output_type",property, “”);
_sessionInfo.docspecVersion
_sessionInfo.templateVersion
_sessionInfo.engineVersion
_sessionInfo.buildNumber

对于 getDocspecProperty,可使用现有的文档规范属性或创建定制元数据属性。

_sessionLogger 出于调试目的,可在 %TEMP%\rpe\rpe.log 文件、“控制台”视图或“问题”视图中显示定制信息、错误、警告或调试消息。这些消息显示在 log4j.properties 文件中定义的位置内。

缺省设置是在“控制台”视图中而不是在 rpe.log 文件中显示参考消息。

在“脚本表达式”选项卡中,选择 _sessionLogger 变量并输入脚本。可使用下列其中一种方法来生成日志条目:
  1. _sessionLogger.debug(message)
  2. _sessionLogger.info(message)
  3. _sessionLogger.error(message)
  4. _sessionLogger.warn(message)

当决定要在脚本输入作为 message 的内容时,请考虑使用可视调出(例如姓名的首字母或用户名)以及使用模板中的变量来生成有意义的消息。

_sessionUtils 在“脚本表达式”选项卡中,可使用此变量来对称为 tidyXHTML 的脚本运行函数。当通知块由不当 XHTML 编码创建的输出中存在空格时,此变量很有用。通过 _sessionUtils 变量,会处理字符串参数,并且会清除 XHTML,这样就不会在输出中显示额外的空格。

示例:_sessionUtils.tidyXHTML(text);

当使用 _sessionUtils 变量时,还可选择“脚本表达式”选项卡中的 XHTML 输入XHTML 输出选项。
注: 可将包括此变量的模板装入到较旧版本的 Rational Publishing Engine 中,但是无法正确评估脚本。

反馈