文档AEM 6.4Forms 指南

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Admin
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

关于区域设置字典 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

呈现自适应表单后，它会通过按指定顺序查看以下参数来标识所请求的区域设置：

  • 请求参数 afAcceptLang

    要覆盖用户的浏览器区域设置，您可以通过 afAcceptLang 请求参数强制设置区域。 例如，以下URL将强制在日语区域设置中渲染表单：

    https://[*server*]:[*port*]/<*contextPath*>/<*formFolder*>/<*formName*>.html?wcmmode=disabled&afAcceptLang=ja

  • 为用户设置的浏览器区域设置，该区域设置在请求中使用 Accept-Language 标题。

  • 在AEM中指定的用户的语言设置。

识别区域设置后，自适应表单会选取特定于表单的词典。 如果找不到所请求区域设置的特定于表单的词典，则使用英语(en)词典。

如果所请求区域设置的客户端库不存在，则它会检查客户端库是否存在区域设置中存在的语言代码。 例如，如果请求的区域设置为 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. 向GuideLocalizationService服务添加区域设置

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

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

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

  5. 重新启动服务器

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

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

指南本地化服务

为区域设置添加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> 根据 区域设置规范. 您还可以在 /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

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

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

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

获取文件

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da