自訂訊息目錄

在之前的發行版本中，鼓勵部署者編輯 WPMessages.properties 檔案來增加訊息目錄項目或修改隨系統提供的項目。現在建議您建立自訂訊息目錄。自訂訊息目錄具有以下優勢︰

減少叢集環境中的維護。維護獨立的訊息目錄意味著您無需編輯 WPMessages.properties 檔案的多個副本。

簡化版本控制。如果自訂訊息位於一個位置，則可更為輕鬆地追蹤變更和備份修訂。

對產品訊息目錄的升級將不會與對自訂項目做出的任何變更相衝突。

使用者定義的訊息目錄 (僅允許一個使用者定義的訊息目錄。)

系統定義的 defaultCustomCatalog 訊息目錄

config/WPMessages.properties 檔案

idmcommon.jar 檔案中的 WPMessages.properties 檔案。

訊息目錄格式

在 WPMessages.properties 檔案中，以 KeyName=MessageText 格式定義項目。在自訂訊息目錄中，每個項目均在獨立的 Msg 元素中指定。KeyName 在 id 屬性中指定，而 MessageText 為二者之間的文字。以下範例說明訊息目錄項目︰

訊息文字可以包含 HTML 標籤以控制如何描繪文字 (儘管不建議使用)。如果您需要使用 HTML 標籤，請使用例如 < 和 > 程式碼，而請勿使用例如 < 和 > 符號。

訊息文字還可以包含將在訊息顯示時插入字串的資料變數。以下範例為 AR_CORRELATED_USER 訊息鍵的預設訊息︰

建立自訂訊息目錄

如果要置換預設訊息目錄項目，請在 WPMessages.properties 檔案中找到相應的錯誤訊息鍵。必須在自訂訊息目錄中指定這些鍵。

如果要建立新訊息，請確定鍵不會出現在 WPMessages.properties 檔案中。

使用以下結構建立 XML 檔案或區塊︰

<?xml version='1.0' encoding='UTF-8'?>

<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>

<Msg id='KeyName'>MessageText</Msg>

...

</MessageSet>

</CustomCatalog>

</Extension>

</Configuration>

其中︰

CatalogName 為訊息目錄的名稱。此值也將用於定義 SystemConfiguration 物件中的目錄。

KeyName 為訊息鍵名稱。

MessageText 為將顯示在圖形化使用者介面上的字串。此文字可以包含 HTML 標籤和變數。

如果您支援一種語言環境且非 en_US，請變更 language 和 country 屬性。如果您支援多種語言環境，請為每種語言環境建立獨立 MessageSet 元素。

請參閱「範例」小節以取得工作範例。

將檔案或區塊匯入 Identity Manager。

載入系統配置物件，並將以下行加入 <Configuration><Extension><Object> 元素中︰

儲存此系統配置物件變更。

重新啟動應用程式伺服器。新的訊息目錄項目現在可用於系統。

範例

以下範例將建立名為 myCustomCatalog 的自訂訊息目錄。它會取代 [匯入交換檔案] 子標籤的標籤和說明文字。

<Msg id='UI_SUBNAV_CONFIGURE_IMPORT_EXCHANGE_HELP'>Loads the specified XML file.</Msg>

上一個目錄下一個
Sun Java System Identity Installation Pack 2005Q4M3 版本說明

6