|
| |
| Sun Java™ System Notes de version de Identity Installation Pack 2005Q4M3 | |
6
Catalogues de messages personnalisés
Dans les versions précédentes, les déployeurs étaient invités à éditer le fichier WPMessages.properties pour ajouter des entrées de catalogue de messages ou modifier des entrées fournies avec le système. Nous recommandons maintenant de créer un catalogue de messages personnalisé. Les catalogues personnalisés offrent les avantages suivants :
- Une maintenance réduite dans un environnement clusterisé. Maintenir un catalogue de messages distinct veut dire éviter de devoir éditer plusieurs copies du fichier WPMessages.properties.
- Un contrôle des versions simplifié. Il est plus facile de suivre les changements et de sauvegarder les révisions si les messages personnalisés se trouvent dans un unique emplacement.
- Les mises à niveau apportées au catalogue de messages du produit n'entreront pas en conflit avec les changements apportés aux entrées personnalisées.
Identity Manager récupère les entrées des catalogues de messages dans l'ordre suivant :
Format du catalogue de messages
Dans le fichier WPMessages.properties, les entrées sont définies dans le format NomClé=TexteMessage. Dans un catalogue de message personnalisé, chaque entrée est spécifiée dans un élément Msg distinct. Le NomClé est spécifié dans l'attribut id tandis que TexteMessage est le texte. L'exemple suivant illustre une entrée de catalogue de messages :
<Msg id='UI_REMEMBER_PASSWORD'>Pensez à définir votre mot de passe.</Msg>
Le texte du message peut contenir des balises HTML pour contrôler le rendu du texte, mais cela n'est pas recommandé. Si vous devez utiliser des balises HTML, utilisez des codes tels que < et > au lieu de symboles comme < et >.
Le texte du message peut aussi contenir des variables correspondant à des données qui seront insérées dans la chaîne quand elle s'affichera. L'exemple suivant est le message par défaut pour la clé AR_CORRELATED_USER :
Correlated account with user {0}.
La version rendue pourrait ressembler à ce qui suit
Correlated account with user jdoe.
Création d'un catalogue de messages personnalisé
La procédure suivante explique la création d'un catalogue de messages défini par l'utilisateur.
- Si vous remplacez des entrées du catalogue de messages par défaut, localisez les clés des messages d'erreur appropriés dans le fichier WPMessages.properties. Ces clés doivent être spécifiées dans le catalogue de messages personnalisé.
Si vous créez de nouveaux messages, assurez-vous que les clés ne figurent pas dans le fichier WPMessages.properties
- Créez un fichier ou un bloc XML de la structure suivante :
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>
<Configuration name='NomCatalogue'>
<Extension>
<CustomCatalog id='NomCatalogue' enabled='true'>
<MessageSet language='en' country='US'>
<Msg id='NomClé'>TexteMessage</Msg>
<Msg id='NomClé'>TexteMessage</Msg>
...
</MessageSet>
</CustomCatalog>
</Extension>
</Configuration>
Où :
NomCatalogue est le nom du catalogue de messages. Cette valeur sera aussi utilisée pour définir le catalogue dans l'objet SystemConfiguration.
NomClé est le nom de la clé du message.
TexteMessage est une chaîne qui s'affichera dans l'interface graphique. Ce texte peut contenir des balises HTML et des variables.
Si vous prenez en charge un environnement linguistique autre qu'en_US, changez les attributs language et country. Si vous prenez en charge plusieurs environnements linguistiques, créez un élément MessageSet distinct pour chacun.
Vous trouverez un exemple qui fonctionne dans la section Exemple.
- Importez le fichier ou le bloc dans Identity Manager.
- Chargez l'objet System Configuration et ajoutez la ligne suivante au sein de l'élément <Configuration><Extension><Object> :
<Attribute name='customMessageCatalog' value='NomCatalogue'/>
- Enregistrez les changements apportés à l'objet System Configuration.
- Redémarrez le serveur d'applications. Les entrées du nouveau catalogue de messages sont maintenant disponibles pour le système.
Exemple
L'exemple suivant crée un catalogue de messages personnalisé nommé monCataloguePerso. Il remplace l'étiquette et le texte d'aide du sous-onglet Importer fichier d’échange.
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>
<Configuration name='monCataloguePerso'>
<Extension>
<CustomCatalog id='monCataloguePerso' 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>