Managing labels
The portal's labels can be modified at any time so the interface can be translated into another language or some standard terms can be modified. The following processes are carried out on a Windows server but are the same for a Linux server.
There are two steps to modify the labels:
- Setting up the application to externalize the labels in a folder outside of the application and therefore keep the modified files at each update.
- Modifying label files.
Important
If you modify the labels directly in the application's files without externalizing them, the modified labels will be replaced at the next version update.

1 | From the Akuiteo server's installation directory, go to webapps > akuiteo.collabs > WEB-INF > classes. |
The label files are named messages_xx_YY.properties, where xx is the language and YY is the regional variation.
2 | Copy the .properties files in the desired languages then paste them in a specific directory. This directory is used to externalize labels. |
3 | From the Akuiteo server's installation directory, go to conf. |
4 | Open the configuration file with a text editor. Depending on your setup, it can either be the context.xml or the server.xml file. |
5 | Add the following property, where the value parameter is the path to the directory where the .properties files were added: |
<Environment
name="t9gest#t9gest.translationDirectory"
value="C:\labels"
type="java.lang.String"
override="false"
/>
6 | Save the xml file. |
The files are externalized and the labels can be translated without risking to lose the translations at the next update.
Example
In the portal's login screen, I want to replace the Log in label by Connect.
In the installation directory, I copy the messages_en.properties file and I paste it in the C:\labels directory.
In the configuration file, I add the t9gest#t9gest.translationDirectory
property with value="C:\labels" to indicate in which directory the messages_en.properties file is located. I save the file.

1 | Open the .properties files in a text editor and modify the desired labels. Each line is structured as key=label, the separator being the carriage return. |
Important
The key must never be modified because it would break the link and the label would not be displayed correctly in the portal.
There must be a key=label pair on each line, separated by a carriage return.
2 | Once the changes are made, save the .properties files then restart the Akuiteo server. |
The labels modified in the .properties files are displayed in the portal.
Example
In the messages_en.properties file, I modify the following line: login.connexion=Log in becomes login.connexion=Connect. Then, I save the file and restart the Akuiteo server.
When I open the portal from a web browser, the Connect label is now displayed in the login screen.