內部變數

您可以使用 Rational® Publishing Engine 隨附的內部變數,在輸出中顯示自動產生的範本或文件規格相關資訊。
表 1. Rational Publishing Engine 內部變數
變數 說明
_cell_number 現行列中的資料格號碼。如果元素不是資料格,則值是 0。您可以從「資料表示式」或「Script 表示式」標籤來使用 _cell_number
_element_id 範本內的元素號碼。保留在範本內部並用於除錯。您可以從「資料表示式」或「Script 表示式」標籤來使用 _element_id
_element_level 元素的遞迴層次。如果在「資料」標籤的「遞迴層次」內容中沒有為元素設定一值,則值是 1。 您可以從「資料表示式」或「Script 表示式」標籤來使用 _element_level
_row_number 現行表格中的列號。如果列元素沒有包含這個元素,則值是 0。您可以從「資料表示式」或「Script 表示式」標籤來使用 _row_number
_sessionInfo 來自範本或文件規格的執行時期內容資訊。請在「Script 表示式」標籤中,選取 _sessionInfo 變數,並輸入 Script。如果要在輸出中產生內容的預設值,請使用其中沒有值的空引號。Script 範例:

_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,您可以使用現有的文件規格內容或建立自訂 meta 資料內容。

_sessionLogger 基於除錯目的,您可以將自訂資訊、錯誤、警告或除錯訊息顯示在 %TEMP%\rpe\rpe.log 檔、「主控台」視圖或「問題」視圖中。訊息會顯示於定義在 log4j.properties 檔中的位置中。

預設值是將參考訊息顯示在「主控台」視圖中,而不是顯示在 rpe.log 檔中。

請在「Script 表示式」標籤中,選取 _sessionLogger 變數,並輸入 Script。您可以使用下列其中一種方法,來產生日誌項目:
  1. _sessionLogger.debug(message)
  2. _sessionLogger.info(message)
  3. _sessionLogger.error(message)
  4. _sessionLogger.warn(message)

當您在 Script 中決定要輸入成 message 的文字時,請考量使用視覺化標註,例如:您姓名的首字母或使用者名稱,以及使用您範本中的變數,來建立有意義的訊息。

_sessionUtils 在 Script 表示式標籤中,您可以使用這個變數,對稱為 tidyXHTML 的 Script 執行功能。當您注意到不當 XHTML 編碼造成輸出中出現間距區塊時,這個變數就可派上用場。使用 _sessionUtils 變數時,會處理字串引數並清除 XHTML,這樣輸出中就不會顯示額外的間距。

範例:_sessionUtils.tidyXHTML(text);

當您使用 _sessionUtils 變數時,也請在「Script 表示式」標籤中選取 XHTML 輸入XHTML 輸出選項。
註: 含有這個變數的範本可以載入至舊版 Rational Publishing Engine 中,但是無法正確評估 Script。

意見