Language

There are two categories of language in CALS Platz: the system application language and the configuration language based on Meta (Symbolic or Common code related to objects like Screen, Component, Control, etc.)

The system application language includes application setting screens provided by default in the system (User Settings, Authorization, Notification, WebLog, etc.) and system messages (Confirmation message, Save, Warning, and Error Alert, etc.). All other screens developed in the Studio by registering UI controls use the configuration language.

Configuration Language Setup

You can add languages and change their order on the Locale screen within the Application Setting (Tenant Setting) menu.
[Image 1. Locale screen for registering and reordering languages]

1. Adding Languages:

   • When you specify a Locale, the corresponding language is added to the Language list.
   • Use the [Add] button to directly specify the language to add.

2. Changing the Default language:

   • The Default language is the initial language set in the Web Application. The first language is designated as the Default language.
   • Change the order by drag & drop, or use the delete and add buttons.

Symbolic and Common Code Registration

After registering languages in Locale, you can register language-specific values for Symbolic and Common Code.

Symbolic Language

During manual registration in the Utility > Symbolic String menu, the language codes defined in Locale are used for the language registration screen and Excel upload language validation checks.

1. The languages registered in Locale are displayed.
   • The list shows the languages available in each environment. Since Locale can be edited in the Tenant environment, the language list may differ between the App and Tenant environments.

Common Code Language

During manual registration in the Utility > Common Code menu, the language codes defined in Locale are used for the language registration screen and Excel upload language validation checks.

1. The languages registered in Locale are displayed.
   • The list shows the languages available in each environment. Since Locale can be edited in the Tenant environment, the language list may differ between the App and Tenant environments.

GNB Language Settings

In versions prior to CALS Platz 0.0.190, the language selection feature in GNB - Language was part of the Locale menu. Now, the GNB – Language button in the Web Application's GNB area functions only as an on/off toggle for the language icon.

[Image 4. Updated GNB Language settings in Studio]

1. The languages registered in Locale are displayed.
   • The list shows the languages available in each environment. Since Locale can be edited in the tenant environment, the language list may differ between the App and Tenant environments.

[Image 5. GNB interface in Web Application when Language is checked]

[Image 6. GNB interface in Web Application when Language is unchecked]

Provisioning and Tenant Setting Rules

Locale menu data is provisioned from the App environment to the Tenant environment. After provisioning, you can change the order of Languages (change the Default language) or delete them.

DANGER

While the Language information modified in the Tenant environment is retained, if you delete a language code in the App environment after provisioning, then add it back and provision again, the language added in Tenant will be applied.

Configuration Language Application and Related Functions

Type	Related Function	Function Details
Symbolic	Attribute	Menu Title
		Screen Title
		Component Title
		Control Label Name
	Data	Display value in Tree(conversion using Symbolic key value registered in data)
	Control Property	Label – Tooltip: Tooltip displayed when hovering over a control
		Enabled N/A: Blank (all) label in a Select Control
		Placeholder
		Naming a date range using Symbolic values in a DatePicker
	Action	Message in Message Box
		Message in Alert
Common Code	Select Control	Form Component lookup and edit functions
	TableColumn – Lookup	Data lookup in table format
	TableColumn – Inline	Edit in table format
	GridColumn – Lookup	Lookup in grid format
	Kanban Attribute	Kanban

INFO

For Common Code, it is essential to register the code applied as the Default language. If the code value for the Default language is not registered, and another language is selected, the functionality may not work even if the code value for the other language is registered.

System-Related Language Application

For languages other than Korean, the system displays default screens and messages in English. Therefore, if you register a language other than Korean or English (for example, Vietnamese) in Locale > Language, the following default solution screens and system messages will appear in English:

• System Seed Screen List

  Category	Menu Name	Description
  GNB	Notification	Notification list, Send notification, Detailed view screen
  	Language	Language name
  	User Profile	User profile edit and password change
  Utility	Excel Upload	Excel upload screen
  	Excel Download history	Excel download screen
  	Web Log	Web log screen
  System Admin	Authorization	Authorization registration and lookup screen
  	User	User registration and authorization mapping screen
  	Password Policy	Password registration rules and policy screen
  	IP Group	IP group registration and editing screen
  	Login Denial History	History of failed logins due to IP check
  	Login Session Retention	Session retention method setting screen

• System Messages : System alerts (e.g., data save alerts, system error messages, etc.)

• Message Popup screens and other similar interfaces.

Mobile Application Considerations

Some Locale language settings are not applied in mobile environments (iOS, Android).

• Unsupported Mobile Features:
  • Default language settings

[Image 7. Mobile language selection screen: Setting Vietnamese as default does not apply.]

The initial language in the mobile environment is determined by the language set in the mobile OS. If a language other than Korean or English is set, the default will revert to English.

[Image 8. Mobile display when Vietnamese is selected as the language.]