诊断工具

要对问题进行故障诊断,可使用 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.

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

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

“问题”视图

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

反馈