Par défaut, l'interface utilisateur intégrée d'EBX® est fournie en anglais (en-US) et en français (fr-FR). La localisation est constituée des règles de formatage de données et d'un ensemble de fichiers de messages (fichier de ressources) :
Pour l'anglais, la localisation est fournie par une règle de formatage de données et un ensemble de fichiers de messages sans locale définie,
Pour le français, la localisation est fournie par une règle de formatage et un ensemble de fichiers de messages avec une locale définie à "fr".
EBX® offre la possibilité d'ajouter des locales pour étendre la localisation de l'interface utilisateur et d'internationaliser la documentation des modèles de données et services associés.
EBX® prend en charge la localisation de son interface utilisateur vers n'importe quelle langue ou région compatible.
Actuellement, seuls les caractères latins et cyrilliques sont acceptés. Les locales utilisant d'autres jeux de caractères sont utilisables, mais ne sont pas prises en charge.
Pour ajouter une nouvelle locale, suivre les étapes suivantes :
Déclarer la nouvelle locale dans le fichier principal de configuration d'EBX®. Par exemple :
ebx.locales.available=en-US, fr-FR, xx
La première locale est toujours considérée comme étant celle par défaut.
Les locales intégrées, en-US et fr-FR, peuvent être supprimées si besoin.
Déployer les fichiers suivants dans le class-path d'EBX® :
Un fichier de règles de formatage, nommé com.orchestranetworks.i18n.frontEndFormattingPolicy_xx.xml,
Un ensemble de fichiers de messages localisés (*_xx.mxml) dans un fichier de ressources.
Les fichiers doivent terminer par ".mxml".
Un ensemble complet de modèles de fichiers est disponible ici.
Depuis la version 5.7.0, les ressources localisées sont résolues sur la base de la proximité de locale, grâce au mécanisme de résolution suivant :
resourceName + "_" + langue + "_" + pays + "_" + variante + ".mxml"
resourceName + "_" + langue + "_" + pays + ".mxml"
resourceName + "_" + langue + ".mxml"
resourceName + ".mxml"
La résolution s'effectue au niveau du message localisé. Il est ainsi possible de définir un ou plusieurs fichiers pour une locale n'incluant que les messages dont la localisation spécifique est souhaitée.
La localisation des éléments suivants ne peut pas être étendue :
Documentation produit EBX®,
Visualiseur et éditeur HTML EBX®.