Translations > Translating Web UI Literals > Implementing a Translation Throughout the Web UI
  
Implementing a Translation Throughout the Web UI
The System literals tab lets you implement translation changes across all pages of the Web UI. This tab displays a list of system literals, along with corresponding system translations.
By default, the Literal and System Translation columns appear in the header row at the top of the list. You can configure the columns that appear. To do this, click the arrow in any field in the header row, click Columns, and select the fields you want to display.

System Literals Tab Columns
If the list of system literals extends beyond one page, you can scroll through the list by clicking the left and right arrows at the bottom of the window. It is possible to search on different criteria using the drop-down search menu. This capability allows you to search through all literals or system translations. You can view a list of the literals that have no system translations by choosing No System Translation from the drop-down search menu.
There are a number of buttons above the list of system literals, which allow you to carry out different functions.

System Literal Buttons
 
Button
Function
Create system literal. If you see some text on the page that does not have a corresponding system literal, you can add it to the list of system literals by clicking this button.
Edit system literal. This option allows you to update an existing literal.
Delete system literal. You can delete system literals that are no longer needed.
Create/Edit system literal translation. Select a literal from the system literals table and click this button to enter a new translation in the System Translation field. The new translation appears on the screen immediately, with no need to explicitly update the screen.
Delete system literal translation. You can delete system translations that are no longer necessary.
Upload Java system literals from file. This option allows you to upload system literals from a file rather than creating them one by one using the Translations Web UI interface. The format of this file is as follows:
• Each literal has its own line.
• There can be no leading or trailing spaces.
• The # character is used for commenting.
• The substitution token format {0} is used.
Upload system translation literals from CSV file. (During the upload ‘&comma ;’ is replaced with ‘,’). You can upload system translations from a CSV file rather than adding them one by one using the Translations Web UI interface. Each line in this CSV file has the following format: SYSTEM LITERAL, translated literal.
Export untranslated literals to file. This option allows you to export all untranslated literals to an Excel file. You can then add translations to the Excel file and upload them to the system.
Generate All JavaScript Translation Files. This updates the JavaScript files for the UI, so that all users can see the latest translations.
Upload JavaScript page literals from all files.
PRECISION keeps track of the literals that need to be translated for a specific web page. This button uploads this information into the system and displays the data as page literals. Where a corresponding system literal doesn't exist for a page literal, it will be created as part of the upload. The system values in the category TRANSLATION that have a key that starts with JSFILE_ identify the file that is to be uploaded for the various Web UI pages or options.
Show translation system information. This option identifies the primary language that the user language is based on. It also provides useful information for debugging purposes.
Select system literals. This option allows you to select all the literals in the list. You may want to select the literals before performing some action, such as saving a list of literals to a file for future translation. You can select a group of literals using the Shift or Control keys.
Deselect system literals. This option allows you to clear any selections that you have made in the list.
Translating a Literal Throughout the Web UI
To translate a literal for display throughout the Web UI:
1 In the System literals tab, select the literal that you want to translate; for example, barcode.
2 Click the Translate button and enter the new translation in the System Translate field, as displayed in Translating a Literal Using the System Literals Tab.
3 Click Save.

Translating a Literal Using the System Literals Tab
4 To preview the changes, use F5 to refresh the page. This option allows you to review your changes without having to restart the server, thus speeding up the translation validation process.
5 As a translation administrator, the literal translations that you see on the screen are taken from the database. For all other users, literal translations are taken from resource files.

Location of Resource Files
To update the translations in the resource files to match the updated database, click the Generate All JavaScript Translation Files icon .
6 The Javascript resource files are cached by the browser. To clear this cache and make the most up-to-date translations visible in the Web UI, access the web browser history and clear the browser cache. In addition, access the ADMIN option and click Clear Translation Literals File.
Alternatively, modify the context path within the exploded WAR folder and update the precision.properties file attribute precision.translation.url.context to point to this new context. In addition, access the ADMIN option and click Clear Translation Literals File.