Gérer les libellés
Les libellés du portail peuvent être modifiés à tout moment afin de traduire l'interface dans une autre langue ou de modifier certains des termes employés en standard. Les procédures suivantes sont réalisées sur un serveur Windows mais sont également valables sur un serveur Linux.
La modification des libellés se fait en deux étapes :
- Paramétrer l'application pour externaliser les libellés dans un dossier extérieur à celui de l'application et ainsi conserver les fichiers modifiés à chaque mise à jour.
- Modifier les fichiers de libellés.
Important
Si vous modifiez les libellés directement dans les fichiers de l'application sans les externaliser, les libellés seront écrasés lors de la prochaine mise à jour de version.

1 | Depuis le répertoire d'installation du serveur Akuiteo, allez dans webapps > akuiteo.collabs > WEB-INF > classes. |
Les fichiers de libellés sont nommés messages_xx_YY.properties, où xx représente la langue et YY la variante régionale.
2 | Copiez les fichiers .properties dans les langues souhaitées et collez-les dans un répertoire spécifique. Ce répertoire permet d'externaliser les libellés. |
3 | Depuis le répertoire d'installation du serveur Akuiteo, allez dans conf. |
4 | Ouvrez le fichier de configuration avec un éditeur de texte. En fonction de votre configuration, il peut s'agir des fichiers context.xml ou server.xml. |
5 | Ajoutez la propriété suivante, où le paramètre value représente le lien vers le répertoire contenant les fichiers .properties : |
<Environment
name="t9gest#t9gest.translationDirectory"
value="C:\libelles"
type="java.lang.String"
override="false"
/>
6 | Enregistrez le fichier xml. |
Les fichiers sont externalisés et les libellés peuvent désormais être traduits sans perdre les traductions lors de la prochaine mise à jour.
Exemple
Dans l'écran de connexion du portail, je souhaite remplacer le libellé Connexion par Me connecter.
Dans le répertoire d'installation, je récupère le fichier messages_fr.properties que je déplace dans le répertoire C:\libelles.
Dans le fichier de configuration, j'ajoute la propriété t9gest#t9gest.translationDirectory
avec value="C:\libelles" pour indiquer le répertoire contenant le fichier messages_fr.properties. J'enregistre le fichier.

1 | Ouvrez les fichiers .properties avec un éditeur de texte et modifiez les libellés souhaités. Chaque ligne se présente sous la forme clé=libellé, le séparateur étant le retour chariot. |
Important
La clé ne doit pas être modifiée, sous peine de casser le lien et de ne plus afficher correctement le libellé dans le portail.
Il doit obligatoirement y avoir un couple clé=libellé par ligne, séparé par un retour chariot.
2 | Une fois les modifications effectuées, enregistrez les fichiers .properties puis redémarrez le serveur Akuiteo. |
Les libellés modifiés dans les fichiers .properties sont pris en compte dans le portail.
Exemple
Dans le fichier messages_fr.properties, je modifie la ligne correspondante : login.connexion=Connexion devient login.connexion=Me connecter. J'enregistre ensuite le fichier puis redémarre le serveur Akuiteo.
Lorsque j'accède au portail depuis un navigateur web, c'est désormais le libellé Me connecter qui est affiché dans l'écran de connexion.