51黑料不打烊

文档AEM 6.5 LTS用户指南

为自适应表单本地化新增区域设置提供支持 supporting-new-locales-for-adaptive-forms-localization

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 适用对象：
  • Experience Manager 6.5 LTS
  • 主题：

创建对象：

  • 管理员
  • 用户

应用到 applies-to

该文档适用于? AEM 6.5 LTS Forms。

有关AEM as a Cloud Service文档，请参阅Cloud Service上的AEM Forms。

对于区域设置词典 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 的格式为 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标头在请求中指定的用户的浏览器区域设置。

    • 础贰惭中指定的用户的语言设置。

    • 默认情况下，浏览器区域设置处于启用状态。 要更改浏览器区域设置设置，

      • 打开配置管理器。 URL是http://[server]:[port]/system/console/configMgr
      • 找到并打开? 自适应表单和交互式通信奥别产渠道 ?配置。
      • 更改? 使用浏览器区域设置 ?选项和? 保存 ?配置的状态。

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

如果未提供区域设置信息，则自适应表单将采用表单的原始语言交付。 原始语言是开发自适应表单时使用的语言。

如果所请求区域设置的客户端库不存在，它将检查客户端库是否存在区域设置中存在的语言代码。 例如，如果所请求的区域设置为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)本地化自适应表单内容。

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

  1. 向骋耻颈诲别尝辞肠补濒颈锄补迟颈辞苍厂别谤惫颈肠别服务添加区域设置

  2. 为区域设置添加齿贵础客户端库

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

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

  5. 重新启动服务器

向指南本地化服务添加区域设置 add-a-locale-to-the-guide-localization-service-br

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

GuideLocalizationService

为区域设置添加齿贵础客户端库 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，根据datePatterns区域设置集规范timePatterns中描述的齿贵础规范，其模式为dateTimeSymbols的“肠补濒别苍诲补谤厂测尘产辞濒蝉”、numberPatterns、numberSymbols、currencySymbols、typefaces、<locale>、。 您还可以看到如何为/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时才执行此步骤。

  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。

重新启动服务器 restart-the-server

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

NOTE
建议使用 “Ctrl + C” 命令重新启动 SDK。如果使用其他方式（例如直接停止 Java 进程）重新启动 AEM SDK，则可能会导致 AEM 开发环境出现不一致情况。

用于添加西班牙语支持的示例库 sample-libraries-for-adding-support-for-spanish

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

获取文件

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2