Language
CALS Platz의 언어 적용은 시스템 적용 언어와 Meta(Screen, Component, Control 등 object와 연관되는 Symbolic, Common code) 기반의 Configuration 언어로 구분된다.
시스템 적용 언어는 시스템에서 기본으로 제공되는 Application 설정 관련 화면(사용자, 권한, Notification, weblog 등)과 시스템 메시지(Confirm message, Save, Warning, Error Alert 등)이며, 그 외 Studio에서 UI Control을 등록하여 개발하는 화면은 모두 Configuration 언어로 적용된다.
Configuration 언어 설정 방법
Application Setting(Tenant Setting) 메뉴 내 Locale 화면에서 언어추가 및 순서 변경이 가능하다. 
[그림1. Locale 화면의 Language 등록 및 순서 변경 화면]
언어 추가 방법
- Locale을 지정하면 지정된 Locale에 적합한 언어가 Language 목록에 추가된다.
- [Add] 버튼으로 추가할 언어를 직접 지정한다.
Default 언어 변경 방법
- Default 언어란 Web Application에서 설정되는 초기 언어로 첫 번째 언어가 Default 언어로 지정된다.
- Drag&Drop으로 순서를 변경하거나 삭제, 추가 버튼으로 변경한다.
Symbolic, Common Code 등록
Locale에 등록 후 Symbolic의 Language와 Common Code에서 언어 별 등록이 가능하다.
Symbolic의 Language
Utility > Symbolic String 메뉴의 Manual 등록 때 Language 등록 화면과 Excel Upload의 언어 Validation 체크 규칙에 Locale의 Language 코드의 값이 사용된다.
- Locale에 등록된 Language 가 표시된다.
- 각 환경 내의 Locale에 등록된 언어 종류가 표시된다. Tenant 환경에서 Locale 편집이 가능하므로 App환경과 Tenant환경에서의 Language List가 다를 수 있다.
Common Code Language
Utility > Common Code 메뉴의 Manual 등록 때 Language 등록 화면과 Excel Upload의 언어 Validation 체크 규칙에 Locale의 Language 코드의 값이 사용된다.
- Locale에 등록된 Language 가 표시된다.
- 각 환경 내의 Locale에 등록된 언어 종류가 표시된다. Tenant 환경에서 Locale 편집이 가능하므로 App환경과 Tenant환경에서의 Language List가 다를 수 있다.
GNB Language 설정
Cals Platz 0.0.190 버전 이전에는 GNB - Language에서 적용언어를 선택하는 기능은 Locale 메뉴 내 기능으로 이전되었고 GNB – Language의 버튼은 Web Application GNB 영역의 언어 Icon의 on-off 기능으로만 사용된다.
[그림4. Studio내 변경된 GNB Language 설정화면]
- Locale에 등록된 Language 가 표시된다.
- 각 환경 내의 Locale에 등록된 언어 종류가 표시된다. Tenant 환경에서 Locale 편집이 가능하므로 App환경과 Tenant환경에서의 Language List가 다를 수 있다.
[그림5. GNB Language가 체크된 경우 Web Application의 GNB 화면]
[그림6. GNB Language가 체크되지 않은 경우 Web Application의 GNB 화면]
Provisioning 및 Tenant Setting 규칙
Locale 메뉴의 데이터는 Provisioning되는 데이터로 App 환경에서 등록한 언어코드 정보가 Tenant 정보로 이관된다. Provisioning 후 Language의 순서 변경(Default 언어 변경) 및 삭제가 가능하다.
DANGER
Tenant에서 수정한 Language의 정보는 유지되나 만약, App환경에서 Provisioning 한 후 언어 코드를 삭제 한 뒤 다시 Add한 뒤 Provisioning을 한 경우 Tenant에서 추가한 언어가 적용된다.
Configuration 언어 적용 연관 기능
| 유형 | 연관 기능 | 기능 상세 |
|---|---|---|
| Symbolic | Attribute | Menu Title |
| Screen Title | ||
| Component Title | ||
| Control Label 명 | ||
| Data | Tree의 값 표시(Data에 Symbolic Key값 등록 후 변환 기능) | |
| Control Property | Label – Tooltip: Control의 마우스 오버시 나타나는 tooltip | |
| Enabled N/A: Select Control에 공백(전체) 명칭 | ||
| Placeholder | ||
| DataPicker에서 선택 가능한 날짜 범위를 지정할 때 날짜 범위의 명칭을 Symbolic을 이용하여 지정 기능 | ||
| Action | Message Box의 메시지 | |
| Alert의 메시지 | ||
| Common Code | Select Control | Form Component의 조회 및 편집 기능 |
| TableColumn – 조회 | Table 형태 데이터 조회 | |
| TableColumn – Inline | Table 형태의 편집 | |
| GridColumn – 조회 | Grid 형태의 조회 | |
| Kanban Attribute | Kanban |
INFO
공통코드의 경우 Default 언어로 적용한 코드가 등록이 필수이다. 만약 Default로 설정한 언어의 코드 값이 등록되지 않고, 다른 언어를 선택하는 경우 다른 언어의 코드 값이 등록되어 있어도 동작하지 않을 수 있다.
시스템 연관 언어 적용
한국어를 제외한 언어의 경우 모두 영어로 표기된다. 따라서 만약 Locale > Language에 베트남어 등 한국어, 영어를 제외한 언어를 등록하여 사용하는 경우 아래 솔루션 기본 화면 및 시스템 메시지는 영어로 표시된다.
시스템 Seed 화면 List
구분 메뉴명 설명 GNB Notification 알림 목록, 알림보내기, 상세조회 화면 Language 언어명 사용자 Profile 사용자 프로필 변경 및 비밀번호 변경 Utility Excel upload 엑셀 업로드 화면 Excel Download history 엑셀 다운로드 화면 Web Log 웹 로그 화면 System Admin 권한 권한 등록 및 조회화면 사용자 사용자 등록 및 권한 매핑 화면 비밀번호 정책 비밀번호 등록 규칙 및 정책 화면 IP 그룹 IP 그룹 등록 및 편집 화면 인증 거부 이력 IP 체크 후 로그인 하지 못한 이력 로그인 인증 유지 방식 Session 유지 방식 설정 화면 시스템 메시지 : 시스템 Alert(ex. 데이터 저장 알림, 시스템 에러 메시지 등)
Message Popup 화면 등
모바일 적용 주의사항
Locale의 Language는 모바일(IOS, AOS)에서 일부 기능이 적용되지 않는다.
- 모바일 미적용 기능
- Language Default 설정
[그림7. 모바일 언어 선택 화면: Defulat로 베트남어를 지정해도 적용되지 않음]
모바일 환경에서 초기 언어는 모바일 OS에 설정된 언어 기준으로 지정된다. 이 때 한국어, 영어를 제외한 다른 언어의 기본값은 영어이다.
[그림8. 모바일에서 언어선택을 베트남어로 지정했을 때 모습]