The Internationalization (aka I18n) page allows Covata Platform administrators to:
Change the System Default language, which is the language for text used:
on the Covata Sign-in page,
throughout the interfaces of the Safe Share web application* and Covata Administration
and
Covata notification email messages.
Allows a built in or custom language bundle to be exported, translated and then uploaded (as a custom/external language bundle) to the Covata Platform, thereby providing a Covata Platform instance with greater i18n support for more languages.
* Modifying the System Default text language affects only the default language setting for the Safe Share web application. A Covata user can override this setting by choosing their own language preference through the My Account feature of the Safe Share web application.
Available Bundles on the Internationalization page (above) is an important column that indicates:
Built In - for languages which are pre-packaged into a Covata Platform instance.
Custom - for any supported language which has an uploaded custom/external language bundle. This can include either Built In and non-Built In languages.
Currently, the Covata Platform only provides support for the languages listed on the Internationalization page. However, these languages only become available for selection by Covata users if:
The languages are Built In to the Covata Platform, which could be overridden by an uploaded custom/external language bundle,
or
For a non-Built In languages, a Custom bundle (i.e. a custom/external language bundle) has been uploaded.
Changing the 'System Default' language
The System Default language is the language used throughout the Covata Administration interface (amongst other areas) and is indicated on the Internationalization page by the Enabled label in the System Default column.
Click the Internationalization option on the left of the Covata Administration interface to open the Internationalization page.
Click the Enable link of the language to become the new System Default language. Notes:
The Enable link is not available for languages which are not Built In or have an uploadedCustom language bundle available.
The System Default language is the default language which new Covata users observe upon signing in to Covata for the first time.
Exporting a language bundle
Exporting an existing Built In or Custom language bundle allows that language bundle to be translated into another language supported by the Covata Platform (i.e. a language listed on the Internationalization page) and then uploaded, which then provides the Safe Share web application and Covata Administration with support for that other language.
Click the Internationalization option on the left of the Covata Administration interface to open the Internationalization page.
Click the Export link of an Available Bundle (listed under this column with either the Built In or Custom labels) for the language from which the translation will be made. The language bundle is downloaded immediately in JSON-format. Notes:
When translating the exported JSON-formatted language bundle file, bear the following in mind:
Change the value of the i18nCode member to the appropriate I18n Code (shown on the Internationalization page) for its target language. The target language is the language that the file's content will be translated into.
Within the bundle member:
Do not modify the property names to the left of each colon. These property names must remain unedited and untranslated.
The property values to the right of each colon is the content to be translated. However, be aware that some of this content contains HTML elements and/or variables, the latter of which should not be modified in their own right. (Variables appear within curly braces.) Nevertheless, the placement of variables within sentences can be altered to suit the target language.
After translating the contents of an exported language bundle file into its target language (supported by the Covata Platform), this translated file can then be uploaded to the appropriate supported language as a custom/external language bundle.
Uploading a custom/external language bundle
Once an exported language bundle has been translated to its target language supported by the Covata Platform, it can uploaded using the following procedure.
Click the Internationalization option on the left of the Covata Administration interface to open the Internationalization page.
Click the Upload link of the target language whose custom/eternal language bundle is to be uploaded.
In the Upload Language Bundle dialog box, click the Choose a file button.
Navigate to and select your translated JSON-formatted language bundle to upload to the Covata Platform. Notes:
The Covata Platform now supports the target language, which:
A Covata Platform administrator can be set as the System Default language.
Becomes available as a Default Language option from the My Account feature of the Safe Share web application, which a Covata user can then choose to override the System Default language setting.
If the target language was Built In, then the translations in the uploaded custom/external language bundle override those in the Built In language bundle.
Regardless of whether the target language is either Built In or not Built In to the Covata Platform, the label in the Available Bundles column now displays Custom to indicate that the custom/external language bundle is now being used (for that target language).
Deleting or resetting a language bundle
Once a custom/external language bundle has been uploaded, it can then be either:
Deleted from a non-Built In language, or
Reset to a Built In language (i.e. the language's default translations).
Any Covata users who had selected this language as their Default Language preference (through the Safe Share web application's My Account feature) will automatically be switched over to the System Default language.
Reset link to delete the overriding custom/external language bundle and reset this language back to its Built In default translations. Note: Although this action does not remove this language as a selectable Default Language option from the My Account feature of the Safe Share web application, any Covata users who had selected this language as their Default Language preference will automatically be switched over to this language's Built In default translations.
Note: It is not possible to delete or reset a language which is currently set as the System Default language.
