支持自适应表单本地化的新区域设置 supporting-new-locales-for-adaptive-forms-localization
关于区域设置词典 about-locale-dictionaries
自适应表单的本地化依赖于两种类型的区域设置词典:
表单特定词典 包含自适应表单中使用的字符串。 例如,标签、字段名称、错误消息、帮助描述等。 它作为每个区域设置的一组XLIFF文件进行管理,您可以在以下位置访问它: https://<host>:<port>/libs/cq/i18n/translator.html
.
全局词典 AEM客户端库中有两个作为JSON对象管理的全局词典。 这些词典包含默认错误消息、月份名称、货币符号、日期和时间模式等。 您可以在CRXDe Lite的/libs/fd/xfaforms/clientlibs/I18N中找到这些词典。 这些位置包含每个区域设置的单独文件夹。 由于全局字典通常不经常更新,因此为每个区域设置保留单独的JavaScript文件使浏览器能够在同一服务器上访问不同的自适应表单时缓存这些文件并降低网络带宽使用量。
自适应表单本地化的工作原理 how-localization-of-adaptive-form-works
可以使用两种方法识别自适应表单的区域设置。 呈现自适应表单时,它通过以下方式标识请求的区域设置:
-
查看
[local]
自适应表单URL中的选择器。 URL 的格式为http://host:port/content/forms/af/[afName].[locale].html?wcmmode=disabled
。使用[local]
选择器允许缓存自适应表单。 -
按指定顺序查看以下参数:
-
请求参数
afAcceptLang
要覆盖用户的浏览器区域设置,您可以传递afAcceptLang
请求参数强制区域设置。 例如,以下URL强制以日语区域设置呈现表单:https://'[server]:[port]'/<contextPath>/<formFolder>/<formName>.html?wcmmode=disabled&afAcceptLang=ja
-
用户的浏览器区域设置设置,该设置在使用请求的请求中指定
Accept-Language
标题。 -
AEM中指定的用户的语言设置。
-
默认情况下,浏览器区域设置处于启用状态。 要更改浏览器区域设置设置,
- 打开配置管理器。 URL为
http://[server]:[port]/system/console/configMgr
- 找到并打开 自适应表单和交互式通信Web渠道 配置。
- 更改状态 使用浏览器区域设置 期权及 保存 配置。
- 打开配置管理器。 URL为
-
标识区域设置后,自适应表单会选取特定于表单的词典。 如果未找到所请求区域设置的表单特定词典,则它会使用用于创作自适应表单的语言的词典。
如果未提供区域设置信息,则自适应表单将采用表单的原始语言交付。 原始语言是开发自适应表单时使用的语言。
如果所请求区域设置的客户端库不存在,它将检查客户端库是否存在区域设置中存在的语言代码。 例如,如果请求的区域设置为 en_ZA
(南非英语)和客户图书馆 en_ZA
不存在,自适应表单将使用客户端库 en
(英语)语言(如果存在)。 但是,如果这些规则都不存在,则自适应表单会将该词典用于 en
区域设置。
为不受支持的区域设置添加本地化支持 add-localization-support-for-non-supported-locales
AEM Forms当前支持英语(en)、西班牙语(es)、法语(fr)、意大利语(it)、德语(de)、日语(ja)、葡萄牙语 — 巴西语(pt-BR)、中文(zh-CN)、中文 — 台湾(zh-TW)和韩语(ko-KR)本地化自适应表单内容。
要在自适应表单运行时添加对新区域设置的支持,请执行以下操作:
向指南本地化服务添加区域设置 add-a-locale-to-the-guide-localization-service-br
- 转到
https://'[server]:[port]'/system/console/configMgr
. - 单击以编辑 指南本地化服务 组件。
- 将要添加的区域设置添加到支持的区域设置列表中。
为区域设置添加XFA客户端库 add-xfa-client-library-for-a-locale-br
创建节点类型 cq:ClientLibraryFolder
下 etc/<folderHierarchy>
,使用类别 xfaforms.I18N.<locale>
,并将以下文件添加到客户端库:
-
I18N.js 定义
xfalib.locale.Strings
对于<locale>
中的定义/etc/clientlibs/fd/xfaforms/I18N/ja/I18N
. -
js.txt 包含以下内容:
/libs/fd/xfaforms/clientlibs/I18N/Namespace.js
I18N.js
/etc/clientlibs/fd/xfaforms/I18N/LogMessages.js
为区域设置添加自适应表单客户端库 add-adaptive-form-client-library-for-a-locale-br
创建节点类型 cq:ClientLibraryFolder
下 etc/<folderHierarchy>
,类别为 guides.I18N.<locale>
和依赖关系 xfaforms.3rdparty
, xfaforms.I18N.<locale>
和 guide.common
."
将以下文件添加到客户端库:
- i18n.js 定义
guidelib.i18n
,具有“calendarSymbols”模式,datePatterns
,timePatterns
,dateTimeSymbols
,numberPatterns
,numberSymbols
,currencySymbols
,typefaces
对于<locale>
按照XFA规范,请参见 区域设置规范. 您还可以在中看到如何为其他支持的区域设置定义它/etc/clientlibs/fd/af/I18N/fr/javascript/i18n.js
. - logmessages.js 定义
guidelib.i18n.strings
和guidelib.i18n.LogMessages
对于<locale>
中的定义/etc/clientlibs/fd/af/I18N/fr/javascript/LogMessages.js
. - js.txt 包含以下内容:
i18n.js
LogMessages.js
为字典添加区域设置支持 add-locale-support-for-the-dictionary-br
仅当满足以下条件,才执行此步骤: <locale>
您添加的内容不属于 en
, de
, es
, fr
, it
, pt-br
, zh-cn
, zh-tw
, ja
, ko-kr
.
-
创建
nt:unstructured
节点languages
下etc
,如果尚未存在。 -
添加多值字符串属性
languages
到节点(如果尚不存在)。 -
添加
<locale>
默认区域设置值de
,es
,fr
,it
,pt-br
,zh-cn
,zh-tw
,ja
,ko-kr
,如果尚未存在。 -
添加
<locale>
至的值languages
属性/etc/languages
.
此 <locale>
将显示在 https://'[server]:[port]'/libs/cq/i18n/translator.html
.
重新启动服务器 restart-the-server
重新启动AEM服务器以使添加的区域设置生效。
用于添加西班牙语支持的示例库 sample-libraries-for-adding-support-for-spanish
用于添加西班牙语支持的客户端库示例