Start
Please read the information in de developer guide first: https://wiki.servoy.com:8443/display/DOCS/Internationalization+(i18n)
General
I18n can be used throughout your whole solution
Labels, Buttons, Tabpannels, Fieldtitels:
For this items you can set the i18n in the text property.
<<make screenshot in servoy 6>>
On the text property select the browse button, this will open a dialog. The first tab is to enter text but in the second tab you can select a i18nkey. When you select a key it will replace your text with i18n: + the keyname.
<<make screenshot in servoy 6>>
I18n chooser:
Filter: In here you can enter your filter criteria, this will filter on the i18n key, but also on the i18n value.
Language/country: Select the language you want to see in the locale column of the table.
Dialogs, Calculations, Methods:
To use i18n in your code, you can use the function:
i18n.getMessage("i18n-key")
The i18n key has to be provided as a string.
For example:
var message = i18n.getMessage("servoy.general.clickOk");
This will return the value of your language, if your language has no entry it will return the default value/reference text : "Click OK to continue".
It is also possible to use dynamic values. You can provide an array with the values you want to replace. To use dynamic values the i18n value should contain tags like {0}, {1}, ... , {n}. The tags will be replaced by the values you provide in the same order.
var company_name = "Servoy";
var amount = 15
var type = "developers";
var message = i18n.getMessage("servoy.license.registered",[company_name,amount, type]);
For example if the key servoy.license.registered has the value 'Registerd to {0} with {1} {2}' the outcome will be 'Registered to Servoy with 15 developers'
You might be wondering how to know when using i18n in a dialog with button the user has clicked because depending on the language of the user the Yes button can be Si, Ja , Oui, Hai, ect.
To solve this you can get the translation in a variable and use that to check wich button is clicked.
For example:
function question() {
var yes = i18n.getI18NMessage("servoy.lbl.yes");
var no = i18n.getI18NMessage("servoy.lbl.no");
var cancel = i18n.getI18NMessage("servoy.lbl.cancel");
var answer = plugins.dialogs.showQuestionDialog("i18n:servoy.lbl.title", "i18n:servoy.lbl.message", yes, no, cancel);
if(answer == yes) {
application.output("yes is pressed");
//execute your code.
}
}
Note that in dialogs you don't need to use the function i18n. getI18Nmessage() but you can just use "i18n:key".
I18n.seti18nMessagesFilter()
It is also possible to have multiple values for one key, and create a extra column in the database to filter on.
For example you a working with a SaaS solution and you want some custom labels for one of the clients. You can then add a extra column to your i18n table called Message Owner.
In the onOpen method you can then add this code to filter on the message_owner column:
The result on the form will be this, the labels that have a own defined value are replaced but if there is no filter value servoy will fall back on the normal i18n values.
If you want your users to be able to make their own labels you can do this by making a form on the i18n table. A good idea is to never let a user edit a records but always make a duplicate of the record they want to edit and then enter the message_owner column with the logged in owner. This way the key will turn up for this owner but not for the others.
I18n Key names
You are free to make your own i18n key names, keep in mind that you will use this a lot. It is a good idea to have a naming convention for this in your company. In general you have two types of i18n keys, short texts which you could call labels and long texts for example for dialogs so you could call them dialogs.
Sample navingconvention:
Labels : lbl.ok
Dialogs: dlg.ok
Or you could prefix your company name:
Labels: servoy.lbl.ok
Dialogs: servoy.dlg.ok
When
The ideal time to start with i18n is when you start building your solutions so you can enter the i18n keys when you are building forms and methods. It is also possible to enter your i18n after you finish your solution servoy has a build in function for this in the developer called externalize, this will find all the text you used and make i18n labels for it, for more information see LINK NAAR i18n externalize.
Date Format
For a date format can be used for example: 'dd-MM-yyyy'. This would be a nice formatted date in the Netherlands but it might not in other countries. That's why it is a good idea to use i18n instead of a hard coded format. Instead of setting the string in the format you will have to set a i18n key in the format. For example:' i18n:servoy.lbl.date'. In that i18n value you can set for Dutch 'dd-MM-yyyy' and for English (US) 'MM/dd/yyyy'.
Overwriting i18n
If you want, you can overwrite a i18n message with the function i18n.seti18nMessage(). For example if you use i18n keys for you date formats you can let the user enter in your system how he prefers his date separator. Then when the user starts the system you can use the i18n.seti18nMessage() to replace the default separator with the user defined separator. For example in the i18n message you have used a '/' as date separator and the user wants a '-' to separate the date. In the onOpen method you can now use the code:
i18n.seti18nMessage({color:#2a00ff}'servoy.lbl.date'{color}, {color:#00c800}utils{color}.stringReplace(i18n.getI18NMessage({color:#2a00ff}'servoy.lbl.date'{color}),{color:#2a00ff}'/'{color},{color:#2a00ff}'-'{color}))
Seperators
Formatting defaults need to be specified in the English(US) format the dot (".") as decimal separator (and comma as 1000 separator). Decimal values withing code need to be specified in English format as well. This will automatically translated to the end users format when he runs the code.
For example in Dutch the separator for decimals is a ','. In the format on a field you will have to enter the English format for a number for example '#.00'. When a user with the locale 'Nederlands(Nederland)' will use the solution and enters '23' into the field. The field will display '23,00'
Overview
Content Tools
Activity