|
| |
| Sun Java System Identity Installation Pack 2005Q4M3 Notas de la versión | |
6
Catálogos de mensajes personalizados
En versiones anteriores se aconsejaba editar el archivo WPMessages.properties durante la implementación para añadir entradas de catálogo de mensajes o modificar las entradas proporcionadas por el sistema. Ahora se recomienda crear un catálogo de mensajes personalizados. Los catálogos de mensajes personalizados ofrecen las siguientes ventajas:
- Mantenimiento reducido en un entorno de clúster. Si dispone de un catálogo de mensajes separado no necesita editar varias copias del archivo WPMessages.properties.
- Control de versión simplificado. Resulta más fácil realizar un seguimiento de los cambios y hacer copias de seguridad de las revisiones si los mensajes personalizados se encuentran en una sola ubicación.
- Las actualizaciones del catálogo de mensajes del producto no entran en conflicto con los cambios efectuados en las entradas personalizadas.
Identity Manager recupera las entradas del catálogo en el orden siguiente:
Formato del catálogo de mensajes
En el archivo WPMessages.properties, las entradas se definen en formato KeyName=MessageText. En los catálogos de mensajes personalizados, cada entrada se especifica en un elemento Msg separado. KeyName se especifica en el atributo id, mientras que MessageText es el texto. En el ejemplo siguiente se muestra una entrada del catálogo de mensajes:
<Msg id='UI_REMEMBER_PASSWORD'>Remember to set your password.</Msg>
El texto del mensaje puede contener etiquetas HTML para controlar la forma en que se representa, aunque no se recomienda. Si necesita utilizar etiquetas HTML, emplee códigos como < y > en lugar de símbolos como < y >.
El texto del mensaje también puede contener variables para los datos que se insertarán en la cadena cuando se muestre. A continuación se muestra el mensaje predeterminado que corresponde a la clave AR_CORRELATED_USER:
Correlated account with user {0}.
El mensaje podría representarse como sigue:
Correlated account with user jdoe.
Creación de un catálogo de mensajes personalizados
A continuación se describe el procedimiento para crear un catálogo de mensajes definido por el usuario.
- Si sustituye las entradas del catálogo predeterminado, sitúe las claves de los mensajes de error adecuadas en el archivo WPMessages.properties. Estas claves se deben especificar en el catálogo de mensajes personalizados.
Si crea mensajes nuevos, asegúrese de que las claves no aparezcan en el archivo WPMessages.properties.
- Cree un archivo o bloque XML con la estructura siguiente:
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>
<Configuration name='CatalogName'>
<Extension>
<CustomCatalog id='CatalogName' enabled='true'>
<MessageSet language='en' country='US'>
<Msg id='KeyName'>MessageText</Msg>
<Msg id='KeyName'>MessageText</Msg>
...
</MessageSet>
</CustomCatalog>
</Extension>
</Configuration>
donde:
CatalogName corresponde al nombre del catálogo de mensajes. Este valor también sirve para definir el catálogo en el objeto SystemConfiguration.
KeyName es el nombre de la clave de mensaje.
MessageText es una cadena que se muestra en la interfaz gráfica de usuario. Este texto puede contener etiquetas HTML y variables.
Si utiliza una configuración regional en lugar de en_US, cambie los atributos language y country. Cuando existan varias configuraciones regionales, cree un elemento MessageSet separado para cada una de ellas.
Consulte sección Ejemplo.
- Importe el archivo o bloque en Identity Manager.
- Cargue el objeto System Configuration object y añada la línea siguiente al elemento <Configuration><Extension><Object>:
<Attribute name='customMessageCatalog' value='CatalogName'/>
- Guarde los cambios efectuados en el objeto System Configuration.
- Reinicie el servidor de aplicación. Las entradas del nuevo catálogo de mensajes están disponibles en el sistema.
Ejemplo
En el ejemplo siguiente se crea un catálogo de mensajes personalizados denominado myCustomCatalog. En él se reemplaza la etiqueta y el texto de ayuda de la ficha secundaria Importar archivo de intercambio.
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>
<Configuration name='myCustomCatalog'>
<Extension>
<CustomCatalog id='myCustomCatalog' enabled='true'>
<MessageSet language='en' country='US'>
<Msg id='UI_SUBNAV_CONFIGURE_IMPORT_EXCHANGE'>Import XML File</Msg>
<Msg id='UI_SUBNAV_CONFIGURE_IMPORT_EXCHANGE_HELP'>Loads the specified XML file.</Msg>
</MessageSet>
</CustomCatalog>
</Extension>
</Configuration>