TIBCO EBX® donne la possibilité de gérer les libellés et l'internationalisation des modèles de données.
Dans EBX®, les préférences de langue peuvent êtres définies sur deux périmètres distincts :
La session : chaque utilisateur peut sélectionner une locale par défaut à partir du panneau utilisateur.
Le fichier principal de configuration d'EBX®, intitulé ebx.properties par défaut. Voir Extension de l'internationalisation de TIBCO EBX® pour plus d'informations.
Dans EBX®, la plupart des entités de données de référence ont un libellé et une description, ou sont liées à un message utilisateur. Par exemple :
Les espaces de données, les images et les jeux de données peuvent avoir leurs propres libellés et descriptions. Le libellé est indépendant du nom unique, ce qui permet la traduction ainsi que la modification ;
N'importe quel noeud du modèle de données peut avoir un libellé et une description statiques ;
Les valeurs énumérées peuvent avoir un libellé statique ;
Les messages de validation peuvent être personnalisés, et les restrictions de permission peuvent fournir un texte expliquant le motif ;
Chaque enregistrement est affiché dynamiquement en fonction de son contenu, ainsi que le contexte dans lequel il est affiché (dans une hiérarchie, en tant que clé étrangère, etc.) ;
Toutes ces informations textuelles peuvent être traduites dans les locales déclarées dans ebx.properties.
Lorsqu'une valeur est affichée pour l'utilisateur, elle est formatée conformément à son type et à la règle de formatage de la locale actuelle. Par exemple, une date sera affichée dans certaines locales "jj/MM/aaaa" et "MM/jj/aaaa" dans d'autres.
Une règle de formatage est utilisée pour définir la manière dont sont affichées les valeurs des types simples.
Pour chaque locale déclarée dans ebx.properties, sa règle de formatage est configurée dans un fichier : /WEB-INF/ebx/{locale}/frontEndFormattingPolicy.xml. Par exemple, pour définir la règle de formatage destinée au grec (el), le système recherche le chemin suivant dans le module :
/WEB-INF/ebx/el/frontEndFormattingPolicy.xml |
Si le fichier correspondant n'existe pas, la règle de formatage est recherchée dans le class-path de EBX®. Si la règle de formatage spécifique à la locale n'est pas trouvée, la règle de formatage en_US sera appliquée.
Le contenu du fichier frontEndFormattingPolicy.xml est le suivant :
<?xml version="1.0" encoding="UTF-8"?><formattingPolicy xmlns="urn:ebx-schemas:formattingPolicy_1.0" xsi:schemaLocation="urn:ebx-schemas:formattingPolicy_1.0 ../schema/ebx-reserved/formattingPolicy_1.0.xsd"> <date pattern="dd/MM" /> <time pattern="HH:mm:ss" /> <dateTime pattern="dd/MM/yyyy HH:mm" /> <decimal pattern="00,00,00.000" groupingSeparator="|" decimalSeparator="^"/> <int pattern="000,000" groupingSeparator=" "/></formattingPolicy> |
Les éléments date, dateTime et time sont obligatoires.
Les séparateurs de groupes et de décimaux qui apparaissent lors du formatage des nombres peuvent être modifiés en définissant les attributs groupingSeparator et decimalSeparator pour les éléments decimal et int.
Il y a deux manières d'exprimer une locale :
La recommandation XML suit la recommandation IETF BCP 47, qui utilise le trait d'union "-" comme séparateur.
La spécification Java utilise le tiret bas "_" au lieu du trait d'union.
Dans n'importe quel fichier XML (XSD, fichier de règle de formatage, etc.) lu par EBX®, les deux syntaxes sont autorisées.
Pour un chemin web, à savoir un chemin contenu dans l'application web, seule la syntaxe Java est autorisée. Ainsi, les fichiers de règles de formatage doivent se trouver dans des répertoires dont le nom de locale respecte la syntaxe Java.