診斷工具

如果要針對問題進行疑難排解,您可以使用 Rational® Publishing Engine 中的診斷工具,例如:範本驗證工具、「主控台」視圖、「問題」視圖和日誌檔。

範本驗證工具

當您執行範本驗證工具時,系統會提供您如下的問題清單:
  • 資料來源:如果在不同的「資料來源配置」元素中使用相同的資料來源,可能會發生衝突。
  • 「資料來源配置」元素:必須配置這些元素。
  • 重複的元素:若為表格目錄、內容目錄和圖例目錄之類的元素,一個範本中只能各使用一個。
  • Script 表示式:會檢查主要頁面和樣式名稱內容,以驗證在 Script 中使用的名稱已套用至內容。
  • 大小寫:會檢查變數、主要頁面、資料來源和樣式名稱,以驗證符合大小寫。
  • 區域名稱:檢查以驗證每一個都是唯一的。

請參閱檢查範本錯誤以取得使用範本驗證工具的相關資訊。

資料預覽

如果您在範本或文件規格中指定資料來源,您可以查看在產生文件時所併入之資料的預覽。 通過預覽資料,您可以判斷輸出的問題是來自資料提供者,或來自範本結構。

請參閱從「資料來源綱目」視圖預覽資料從「文件規格」視圖預覽資料,以取得詳細資訊。

「主控台」視圖

「主控台」視圖提供了 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 代表處理的指令數。 指令是由來自範本元件的三個部分與來自資料來源的資料所組成。:一個開始處理元素的指令、一個用於元素內容的指令以及一個結束處理元素的指令。 所以指令數一律為範本中之元素數的 3 倍。

在文件產生期間,輸入元素和發佈指令的數目會有所升降,因為 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

意見