支持自适应表单本地化的新区域设置

关于区域设置词典

自适应表单的本地化依赖于两种类型的区域设置词典：

特定于表单的词典 包含自适应表单中使用的字符串。 例如，标签、字段名称、错误消息、帮助描述等。 它作为每个区域设置的一组XLIFF文件进行管理，您可以在以下位置访问它： https://<host>:<port>/libs/cq/i18n/translator.html.

全局词典 AEM客户端库中有两个作为JSON对象管理的全局词典。 这些词典包含默认错误消息、月份名称、货币符号、日期和时间模式等。 您可以在CRXDe Lite的/libs/fd/xfaforms/clientlibs/I18N中找到这些词典。 这些位置包含每个区域设置的单独文件夹。 由于全局词典通常不经常更新，因此为每个区域设置保留单独的JavaScript文件使浏览器能够在访问同一服务器上的不同自适应表单时缓存这些文件并降低网络带宽使用量。

自适应表单本地化的工作原理

有两种方法可以识别自适应表单的区域设置。 呈现自适应表单时，它通过标识所请求的区域设置：

  • 查看 [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渠道 配置。
      • 更改状态 使用浏览器区域设置 期权及 保存 配置。

标识区域设置后，自适应表单会选取特定于表单的词典。 如果找不到所请求区域设置的表单特定词典，则会使用自适应表单创作语言的词典。

如果区域设置信息不存在，则自适应表单将以表单的原始语言交付。 原始语言是开发自适应表单时使用的语言。

如果所请求区域设置的客户端库不存在，它将检查客户端库是否存在区域设置中存在的语言代码。 例如，如果请求的区域设置为 en_ZA （南非英语）和客户库 en_ZA 不存在，自适应表单将使用客户端库用于 en （英语）语言（如果存在）。 但是，如果这些字典都不存在，则自适应表单会将该字典用于 en 区域设置。

为不受支持的区域设置添加本地化支持

AEM Forms当前支持英语(en)、西班牙语(es)、法语(fr)、意大利语(it)、德语(de)、日语(ja)、葡萄牙语 — 巴西语(pt-BR)、中文(zh-CN)、中文 — 台湾(zh-TW)和韩语(ko-KR)语言环境的自适应表单内容本地化。

要在自适应表单运行时添加对新区域设置的支持，请执行以下操作：

  1. 向GuideLocalizationService服务添加区域设置

  2. 为区域设置添加XFA客户端库

  3. 为区域设置添加自适应表单客户端库

  4. 为字典添加区域设置支持

  5. 重新启动服务器

在指南本地化服务中添加区域设置

  1. 转到 https://'[server]:[port]'/system/console/configMgr.
  2. 单击以编辑 指南本地化服务 组件。
  3. 将要添加的区域设置添加到支持的区域设置列表中。

指南本地化服务

为区域设置添加XFA客户端库

创建节点类型 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

为区域设置添加自适应表单客户端库

创建节点类型 cq:ClientLibraryFolder 下 etc/<folderHierarchy>，类别为 guides.I18N.<locale> 和依赖关系 xfaforms.3rdparty， xfaforms.I18N.<locale> 和 guide.common.”

将以下文件添加到客户端库：

  • i18n.js 定义 guidelib.i18n，具有“日历符号”模式， 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

为字典添加区域设置支持

仅当满足以下条件，才执行此步骤： <locale> 您添加的内容不属于 en， de， es， fr， it， pt-br， zh-cn， zh-tw， ja， ko-kr.

  1. 创建 nt:unstructured 节点 languages 下 etc，如果尚未存在。

  2. 添加多值字符串属性 languages 到节点（如果尚未出现）。

  3. 添加 <locale> 默认区域设置值 de， es， fr， it， pt-br， zh-cn， zh-tw， ja， ko-kr，如果尚未存在。

  4. 添加 <locale> 至的值 languages 属性 /etc/languages.

此 <locale> 将显示在 https://'[server]:[port]'/libs/cq/i18n/translator.html.

重新启动服务器

重新启动AEM服务器以使添加的区域设置生效。

用于添加对西班牙语支持的示例库

用于添加对西班牙语支持的示例客户端库

获取文件

在此页面上