自定义消息目录

在先前的发行版本中，我们鼓励部署者编辑 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 是消息目录的名称。此值也用于定义系统配置对象中的目录。

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