적응형 양식의 현지화는 다음 두 가지 로케일 사전 유형을 사용합니다.
양식별 사전적응형 양식에 사용되는 문자열을 포함합니다. 예를 들어 레이블, 필드 이름, 오류 메시지, 도움말 설명 등이 있습니다. 이 파일은 각 로케일에 대한 XLIFF 파일 세트로 관리되며 https://<host>
:<port>
/libs/cq/i18n/translator.html에서 액세스할 수 있습니다.
전역 사전: AEM 클라이언트 라이브러리에 JSON 개체로 관리되는 두 개의 글로벌 사전이 있습니다. 이러한 사전은 기본 오류 메시지, 월 이름, 통화 기호, 날짜 및 시간 패턴 등을 포함합니다. 이러한 사전은 CRXDe Lite에서 /libs/fd/xfaforms/clientlibs/I18N에 있습니다. 이러한 위치에는 각 로케일에 대한 별도의 폴더가 포함되어 있습니다. 글로벌 사전은 일반적으로 자주 업데이트되지 않으므로 각 로케일에 대해 별도의 JavaScript 파일을 유지하면 브라우저에서 이를 캐싱하고 동일한 서버에서 다른 적응형 양식에 액세스할 때 네트워크 대역폭 사용을 줄일 수 있습니다.
적응형 양식을 렌더링하면 지정된 순서로 다음 매개 변수를 보고 요청된 로케일을 식별합니다.
요청 매개 변수 afAcceptLang
사용자의 브라우저 로케일을 재정의하려면 afAcceptLang
요청 매개 변수를 전달하여 로케일을 강제 적용할 수 있습니다. 예를 들어 다음 URL은 일본어 로케일로 양식을 렌더링합니다.
https://[*server*]:[*port*]/<*contextPath*>/<*formFolder*>/<*formName*>.html?wcmmode=disabled&afAcceptLang=ja
사용자에 대해 설정된 브라우저 로케일( Accept-Language
헤더 를 사용하여 요청에 지정됩니다.)
AEM에 지정된 사용자의 언어 설정입니다.
로케일이 식별되면 적응형 양식이 양식 특정 사전을 선택합니다. 요청된 로케일에 대한 양식 특정 사전을 찾을 수 없으면 영어(en) 사전이 사용됩니다.
요청된 로캘에 대한 클라이언트 라이브러리가 없는 경우 클라이언트 라이브러리에서 로케일에 있는 언어 코드를 확인합니다. 예를 들어 요청된 로케일이 en_ZA
(남아프리카 영어)이고 en_ZA
에 대한 클라이언트 라이브러리가 없는 경우 적응형 양식에서는 en
(영어) 언어에 대해 클라이언트 라이브러리를 사용합니다. 그러나 이들 중 어느 것도 없는 경우 적응형 양식은 en
로케일에 사전을 사용합니다.
AEM Forms은 현재 영어(en), 스페인어(es), 프랑스어(fr), 이탈리아어(it), 독일어(de), 일본어(ja), 포르투갈어(pt-BR, 중국어(zh-CN), 중국어(zh-TW) 및 한국어(ko-KR) 로케일로 적응형 양식 컨텐츠의 지역화를 지원합니다.
적응형 양식 런타임 시 새 로케일에 대한 지원을 추가하려면 다음을 수행합니다.
https://[server]:[port]/system/console/configMgr
.etc/<folderHierarchy>
아래에 cq:ClientLibraryFolder
유형의 노드를 xfaforms.I18N.<locale>
범주와 함께 만들고 다음 파일을 클라이언트 라이브러리에 추가합니다.
I18N. jsdefining xfalib.locale.Strings
for <locale>
the defining /etc/clientlibs/fd/xfaforms/I18N/ja/I18N
.
js. txtxt에는 다음이 포함되어 있습니다.
/libs/fd/xfaforms/clientlibs/I18N/Namespace.js
I18N.js
/etc/clientlibs/fd/xfaforms/I18N/LogMessages.js
etc/<folderHierarchy>
아래에 cq:ClientLibraryFolder
유형의 노드를 만들고, 카테고리는 guides.I18N.<locale>
, xfaforms.3rdparty
, xfaforms.I18N.<locale>
및 guide.common
로 종속성을 만듭니다. "
클라이언트 라이브러리에 다음 파일을 추가합니다.
i18n. jsdefining guidelib.i18n
에서, datePatterns
로케일 세트 사양 timePatterns
에 설명된 XFA 사양에 따라 dateTimeSymbols
에 대해 "calendarSymbol", numberPatterns
, numberSymbols
, currencySymbols
, typefaces
, <locale>
🔗의 패턴을 갖습니다. 또한 /etc/clientlibs/fd/af/I18N/fr/javascript/i18n.js
에서 지원되는 다른 로케일에 대해 정의된 방법을 확인할 수 있습니다.
에 정의되어 있는 대로 guidelib.i18n.strings
및 guidelib.i18n.LogMessages
에 <locale>
대한 LogMessages.jsdefining /etc/clientlibs/fd/af/I18N/fr/javascript/LogMessages.js
.
js. txtxt에는 다음이 포함되어 있습니다.
i18n.js
LogMessages.js
추가하는 <locale>
이 en
, de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
중에 없는 경우에만 이 단계를 수행하십시오.
아직 없는 경우 etc
아래에 nt:unstructured
노드 languages
를 만드십시오.
아직 없는 경우 여러 값을 갖는 문자열 속성 languages
을 노드에 추가합니다.
아직 없는 경우 <locale>
기본 로케일 값 de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
를 추가합니다.
/etc/languages
의 languages
속성 값에 <locale>
을 추가합니다.
<locale>
이 https://[server]:[port]/libs/cq/i18n/translator.html
에 나타납니다.
추가된 로케일을 적용하려면 AEM 서버를 다시 시작합니다.
스페인어 지원을 추가하기 위한 샘플 클라이언트 라이브러리