诊断工具

要对问题进行故障诊断,可使用 Rational® Publishing Engine 中提供的诊断工具,例如模板验证工具、“控制台”视图、“问题”视图和日志文件。

模板验证工具

运行模板验证工具时,系统会向您提供一个问题列表,例如:
  • 数据源:如果在不同的数据源配置元素上使用相同的数据源,那么可能会发生冲突。
  • 数据源配置元素:必须配置这些元素。
  • 重复元素:对于表目录、目录和图目录等元素,在一个模板中只能使用一次。
  • 脚本表达式:会检查母版页和样式名称属性,以验证脚本中使用的名称是否已应用到属性。
  • 大小写:会检查变量、母版页、数据源和样式名称,以验证大小写是否匹配。
  • 区域名称:会检查以验证每个区域名称是否都唯一。

有关如何使用模板验证工具的更多信息,请参阅检查模板错误

数据预览

如果在模板或文档规范中指定数据源,那么可查看生成文档时会包括的数据的预览。通过预览该数据,可确定输出存在的问题是来自数据提供程序还是来自模板结构。

请参阅从“数据源模式”视图中预览数据从“文档规范”视图中预览数据,以获取更多信息。

“控制台”视图

“控制台”视图会简要概括所出现的 Rational Publishing Engine 进程。例如,当启动 Rational Publishing Engine Document Studio 时,“控制台”视图可能会显示如下参考消息:

CRRPE0321I RPE License - The license is confirmed and is valid for 300 more days.
CRRPE0282I Document Studio has started.

生成文档时,从数据源处理模板元素和数据将发生在两个线程中。第一个线程是用来读取数据的输入线程,第二个线程是用来处理数据的输出线程。在“控制台”视图中穿插处理这些线程,因为这些输入和输出线程是并行处理的。
  • 已处理 x 输入元素:第一个线程为文档生成生成命令
  • x 已处理发布命令。x 将要处理发布命令:第二个线程发布由输入线程生成的命令
x 表示正在处理的命令编号。命令从数据源的模板元素和数据中包含三个部分:一个命令用来开始处理元素,一个命令用来处理元素的内容,一个命令用来结束处理元素。因此,命令的编号总是比模板中元素的编号大三。

输入元素和发布命令的编号会在文档处理期间增大或减小,这是因为 Rational Publishing Engine 旨在读取它一次可以处理的尽可能多的数据。输入线程生成命令比输出线程发布命令的速度更快。当第一个线程生成一定数量的命令时,将暂停输入线程直到输出线程继续发布命令为止。因此,即使您可能期望在文档生成过程中仅使编号减小,但数字的波动证明 Rational Publishing Engine 正一次完成多个过程。

要打开“控制台”视图,请单击窗口 > 显示视图 > 控制台

有关如何调整显示的字符数的信息,请参阅示例:更改“控制台”视图字符限制标志。有关定制(例如更改显示的消息的格式)的信息,请参阅定制控制台日志

“问题”视图

Rational Publishing Engine 错误出现时,“问题”视图会提供这些错误的列表。例如,当连接至“中央管理”组件时遇到问题时,“问题”视图可能会显示如下错误:

访问“中央管理”组件消息时发生太多错误。

要打开“问题”视图,请单击窗口 > 显示视图 > 问题

有关某个错误的更多信息,请右键单击该错误并选择属性。错误的属性会为您提供更多信息(例如该错误在哪个元素上发生)以帮助您进行故障诊断。

日志文件

Rational Publishing Engine 提供了两种方法来查看日志文件中的进程信息,这些信息可用来标识问题。第一种方法是通过用户界面日志文件。用户界面日志文件中列出了设计模板和文档规范时您遇到的问题。第二种方法是通过核心日志。核心日志文件中列出了从模板和文档规范生成文档时遇到的问题。IBM® 支持机构可使用核心日志文件和用户界面进程的日志文件来帮助您对问题进行故障诊断。
注: 必须定义系统变量 RPE_HOME,才能读取记录配置。

核心日志文件

从模板和文档规范生成文档时可能会发生与核心引擎相关的问题,而这些日志文件存储此类问题的历史记录。如果将调试方式首选项设置为,那么可以在核心日志文件中查看其他信息。请参阅设置引擎首选项

可在 Document Studio 和 Launcher 的缺省工作空间目录的临时文件中找到这些日志文件。例如,TEMP\RPE\rpe.log

有关定制(例如更改日志文件的位置)的信息,请参阅定制核心日志文件

用户界面日志文件

使用 Rational Publishing Engine Document Studio 和 Rational Publishing Engine Launcher 时可能会发生与用户界面相关的问题,而这些日志文件存储此类问题的历史记录。
可在 Document Studio 和 Launcher 的缺省工作空间目录的应用程序数据中找到这些日志文件。示例:
  • APPDATA\IBM\Rational\RPE_date\Launcher\workspace\.metadata\.log
  • APPDATA\IBM\Rational\RPE_date\Studio\workspace\.metadata\.log

反馈