...
| Page Properties | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||
Resources & Remarks Modification History
@Antje : Peter hat mir zwei links gegeben, über die man in einem installierten System sowohl an die Custom Client Keys als auch die Framework Keys kommt: Der Cliet läuft in 'litedms' ... Wenn Du eine gute Idee hast, das als alternativen Zugang zu den Client-Keys unten einzubauen ... |
...
The terms and phrases displayed by a client application based on our libraries such as our yuuvis® Momentum client as reference implementation can be localized for translated into custom languages according to the corresponding needs. For this purpose, each individual technical term used in the background can be mapped to a user-friendly localized term or phrase that will be displayed in the client application wherever instead of the technical term would be present. The built with our libraries allows for the localization of control elements (e.g., buttons or error messages). In order to provide a custom language in the selection list from which the users can select their preferred language, it has to be added to the client's main configuration. Furthermore, labels used in forms can be localized easily during runtime.
...
The localization of control elements is realized directly during the building build process of the client. JSON files are used as configuration files for the translations. The languages to be offered to users are specified in the client's main configuration.
>> Framework Library Installation and ConfigurationOur yuuvis® client as reference implementation offers the possibility to manage those global configuration files via the client application.>> Manage Language Settings via Configuration Files
Localizing Form Labels ...
The labels displayed in forms (e.g., object metadata forms) are localized by means of JSON configuration files as well. A distinction is made between tenant-specific labels available only within in one tenant and global labels available in all tenants. The tenant-specific localization files are managed by users with the role access to the admin-controller endpoints of the Web-API Gateway (default: users with the YUUVIS_TENANT_ADMIN role). Their changes are applied only to their own tenant. Users with the role access to the system-controller endpoints (default: users with the YUUVIS_SYSTEM_INTEGRATOR role) are allowed to manage the global localization files available in all tenants.
Whenever a new tenant is created and provided with its own tenant-specific resources like, e.g., a tenant schema, also a tenant-specific localization file also needs to be created. Otherwise the technical terms defined in the technical resource files will be displayed in the forms.
...
The endpoints for the management of localization files provided by the Web-API Gateway (API-WEB) are available only for users with specific administrative roles. Furthermore, the endpoints require the specification of the language for which the localization file should be retrieved/updated. The language has to be specified in ISO norm (e.g., de, en, es, fr, ...) in the request header for GET endpoints and in the request URL for the POST endpoints:
| User RoleRequired Permission | Available Endpoints for Localization Management | Description | ISO Language Specification | Range of Application of managed Localization Files | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
access to admin-controller endpoints of the Web-API Gateway (default: YUUVIS_TENANT_ADMIN role) | GET /api-web/api/admin/resources/text |
| in the request header Accept-Language | Tenant-specific: available only within in the tenant the currently logged-in user belongs to. | ||||||||
| POST /api-web/api/admin/resources/text/{locale} |
| as path parameter | ||||||||||
access to system-controller endpoints of the Web-API Gateway (default: YUUVIS_SYSTEM_INTEGRATOR role) | GET /api-web/api/system/resources/text |
| in the request header Accept-Language | Global: available for all tenants. | ||||||||
| POST /api-web/api/system/resources/text/{locale} |
| as path parameter |
...
yuuvis® architect provides a support tool with a graphical user interface for client administrators. Based on the framework library, metadata forms of their client's graphical user interface can be modeled. Furthermore, users can be added or removed from the respective tenant and language settings can be customized.
The Localization tile is available on the dashboard for users with the YUUVIS_TENANT_ADMIN or YUUVIS_SYSTEM_INTEGRATOR roles.
>> >> Localization
Localizing Terms from Plug-ins
In case you need to extend translations with new keys, please specify translations within in the plug-in configuration for each language in your system.
>> Extending the Clients with Plug-ins
Language-specific Date, Time and Number Formats
Regardless of the availability of a localization file with language-specific terminology, a library-based client can support language-specific date, time and number formats according to the corresponding rules. The supported languages are listed below. Support for languages not listed below can be implemented by the yuuvis® Momentum development team upon request. As of 2022 Summer, it is not possible to implement the usage of special characters to replace AM and PM in a 12-hour system.
| Language | ISO code | Example date and time | Example number |
|---|---|---|---|
| Arabic | ar | 31 /01 /2022 20:08 | 11,111,111.00 |
| Bengalese | bn | 31/01/2022 08:08 PM | 1,11,11,111.00 |
| Chinese | zh | 2022/01/31 20:08 | 11,111,111.00 |
| Dutch (as of 2022 Summer) | nl | 31-01-2022 20:08 | 11.111.111,00 |
| English | en | 01/31/2022, 08:08 PM | 11,111,111.00 |
| Finnish (as of 2022 Summer) | fi | 31.01.2022 20.08 | 11 111 111,00 |
| French | fr | 31/01/2022 20:08 | 11 111 111,00 |
| German | de | 31.01.2022, 20:08 | 11.111.111,00 |
| German (Switzerland) (as of 2022 Summer) | de-CH | 31.01.2022, 20:08 | 11’111’111.00 |
| Hindi | hi | 31/03/2022, 08:08 pm | 1,11,11,111.00 |
| Italian | it | 31/01/2022, 20:08 | 11.111.111,00 |
| Japanese | ja | 2022/01/31 20:08 | 11,111,111.00 |
| Korean | ko | 2022. 01. 31. PM 08:08 | 11,111,111.00 |
| Latvian | lv | 31.01.2022 20:08 | 11 111 111,00 |
| Norwegian (as of 2022 Summer) | nb | 31.01.2022, 20:08 | 11 111 111,00 |
| Polish | pl | 31.01.2022, 20:08 | 11 111 111,00 |
| Portuguese | pt | 31/01/2022 20:08 | 11.111.111,00 |
| Russian | ru | 31.01.2022, 20:08 | 11 111 111,00 |
| Slovak | sk | 31.01. 2022 20:08 | 11 111 111,00 |
| Spanish | es | 31/01/2022 20:08 | 11.111.111,00 |
| Swedish (as of 2022 Summer) | sv | 2022-01-31 20:08 | 11 111 111,00 |
| Thai (as of 2022 Summer) | th | 31/01/2022 20:08 | 11,111,111.00 |
| Turkish (as of 2022 Summer) | tr | 31.01.2022 20:08 | 11.111.111,00 |
| Ukrainian | uk | 31.01.2022, 20:08 | 11 111 111,00 |
| Vietnamese (as of 2022 Summer) | vn | 20:08, 31/01/2022 | 11.111.111,00 |
To configure display languages for the client, please refer to this article: Customizing the Main Configuration.
Summary
In client applications built with our libraries, all displayed terms and phrases can be localized for a custom language. While labels for control elements are defined already during the client configuration, the localization of labels in forms is possible at runtime via Web-API Gateway or yuuvis® architect.
| Info | |||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||
Read on
|
...