Create Custom Language Packages
Language packages enable users to interact with the Wyn Enterprise application in different languages. By changing the language package, text in the application gets translated into the selected local language. Wyn Enterprise offers four official language packages including English (en), Polish (pl), Chinese Simplified (zh), and Chinese Traditional (zh-TW), and lets you create Custom Language Packages to deliver a high-quality experience to your users.
In Wyn Enterprise, you can view and manage the language packages through the System Languages tab of the UI Settings page of the Admin Portal. For more information, please see System Languages help topic.
Note: The trial license includes the custom language package feature. However, in case of subscription license, you need to purchase the feature separately. For more information, please contact GrapeCity Sales.
Typically, a language package is a zip file with the following structure:
The gcef-identity-service folder contains the login page, reset password page, and serial number registration-related pages.
The gces-analysis folder contains the data model-related pages.
The gces-common folder contains pages related to data sources, datasets, users, organizations, roles, and generate tokens.
The gces-dashboard folder contains the dashboard-related pages.
The gces-forguncy folder contains the input form pages.
The gces-reporting folder contains the report-related pages.
The gces-server folder contains the portal pages, background management pages, document details pages, and others.
The manifest file is a declaration file that contains the edition, language code, name, author, publish time, created time, created by, modified time, modified by, version number, Wyn Enterprise version, and reference language for the Custom Language Package.
You can create your own Custom Language Package using the Official Language Packages available under the System Languages tab. For example, you can create a German language package based on the official Polish package. This article explains how to create a Custom Language Package in Wyn Enterprise.
Step 1: Download The Official Language Package
A Custom Language Package is based on an Official Language Package. Navigate to the System Languages tab of the UI Settings page, and download an Official Language Package of your choice. The downloaded package is saved as a zip file on your system.
Note: Download the Language Package with the same Product Version number as that of the Wyn Enterprise application.
Unzip the file to view its content.
Step 2: Modify Content of The Language Package
Change the Language Code in the manifest.txt file and make sure it follows the RFC4646 specifications. The Language Code is typically used to identify the Language Package when used in the query URL. Have a look at the below image,
Caution: In the manifest.txt file, information related to the edition, Wyn Enterprise version, and reference language should not be modified.
Then, translate all the items in the zip file except for the language-resources.json files. The language-resources.json files describe the structure of the Language Package.
When modifying the contents of a Language Resource Package, ensure the following;
The language code in the manifest.txt file must be unique.
The Wynversion and edition in the manifest.txt file should be the same as that of the installer.
The file structure of the Language Package should match the contents of the language-resources.json file.
Step 3: Compress and Upload to Wyn Enterprise
After modifying the Language Package to suit your requirements, compress the folder. Then, upload the zip file on the System Languages tab of the UI Settings page using the Upload button with a unique name. The name of the Language Package name cannot start with a number, and must not contain the following special characters:
"/", "?", "#", "[", "]", "@", "!", "$", "&", "'", "(", ")", "*", "+", ",", ";", and "=".
Note: Make sure that the language package version corresponds to the Wyn Enterprise version. Else, the language package will not work properly.
The uploaded Language Package appears in the Custom Language Package section. You can now use the Custom Language Package as the preferred language for Wyn Enterprise by modifying the user profile settings or using the lng parameter in the URL. The lng parameter equals to the Language Code specified in the Language Package.
For instructions on how to modify user profile settings, please see Set Language Preference help article.
For instructions on how to use a parameter in the query URL, please see Using Integration URLs help article.
Limitations
The file structure of the Language Package should match the contents of the language-resources.json file.
If the Language Package corresponds to a different product version other than the current product version, the product UI is not properly internationalized. It is because the localization items that are different among the two versions are shown in EN.