支援最適化表單本地化的新地區設定

關於地區字典

最適化表單的本地化需要兩種語言環境字典：

表單特定字典 包含最適化表單中使用的字串。例如，標籤、欄位名稱、錯誤訊息、說明說明等。 它作為一組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_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. 按一下以編輯​Guide Localization Service​元件。
  3. 將要添加的區域設定添加到支援的區域設定清單中。

指南本地化服務

為區域設定添加XFA客戶端庫

在etc/<folderHierarchy>下建立類型cq:ClientLibraryFolder的<a1/>節點（類別為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

為區域設定添加自適應表單客戶端庫

在etc/<folderHierarchy>下建立類型cq:ClientLibraryFolder的節點，類別為guides.I18N.<locale> ，從屬關係為xfaforms.3rdparty、xfaforms.I18N.<locale>和guide.common。"

將下列檔案新增至用戶端程式庫：

  • i18n. jsdefing guidelib.i18n，具有"CalendarSet"的模式， datePatterns, timePatterns, dateTimeSymbols numberPatterns，對XFA符號進行了說明，在XSet Specification Set Specification Specification Set Specification Set Specification中對 numberSymbols currencySymbols typefaces <locale> CaS的說明。您也可以查看如何為/etc/clientlibs/fd/af/I18N/fr/javascript/i18n.js中的其他受支援地區設定定義。

  • LogMessages. jsdefing guidelib.i18n.strings and guidelib.i18n.LogMessages for the <locale> as defined in /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. 在etc下建立nt:unstructured節點languages（如果尚未存在）。

  2. 將多值字串屬性languages新增至節點（如果尚未出現）。

  3. 新增<locale>預設地區設定值de、es、fr、it、pt-br、zh-cn、zh-tw、ja、ko-kr（如果尚未出現）。

  4. 將<locale>添加到/etc/languages的languages屬性的值中。

<locale>將顯示在https://[server]:[port]/libs/cq/i18n/translator.html。

重新啟動伺服器

重新啟動AEM伺服器，讓新增的地區設定生效。

新增西班牙文支援的范常式式庫

新增西班牙文支援的範例用戶端程式庫

取得檔案

本頁內容