コアコンポーネントに基づくアダプティブフォームのロケールの追加 :headding-anchor:supporting-new-locales-for-adaptive-forms-localization

URL ロケールセレクター（[ロケール]）：

システムでは、[ロケール]セレクターを使用して URL 内で指定したロケールが優先されます。この形式を使用すると、キャッシュを使用してパフォーマンスを向上させることができます。

形式：URL は、http:/[AEM Forms Server URL]/content/forms/af/[afName].[locale].html?wcmmode=disabled の形式に従います。

例：https://[server]/content/forms/af/contact-us.hi.html では、フォームをヒンディー語でレンダリングします。

afAcceptLang リクエストパラメーター：

ユーザーのブラウザーロケールを上書きするには、URL で afAcceptLang パラメーターを使用します。

例：https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr では、フォームをカナダのフランス語で強制的にレンダリングします。

ユーザーのブラウザーロケール（使用可能言語ヘッダー）：

他のロケールを指定していない場合、AEM Forms では Accept-Language ヘッダーを使用して送信されたユーザーのブラウザーロケールを考慮します。

コマンドラインまたはターミナルウィンドウを開きます。

保存したいマシン上の目的の場所（例：/adaptive-forms-core-components）にリポジトリを移動します。

次のコマンドを実行して、リポジトリのクローンを作成します。

git clone https://github.com/adobe/aem-core-forms-components.git

このコマンドでリポジトリをダウンロードし、マシン上に aem-core-forms-components という名前のフォルダーを作成します。このガイドでは、このフォルダーを [Adaptive Forms Core Components repository] と呼びます。

コマンドラインを開き、AEM as a Cloud Service リポジトリを保存するディレクトリ（例：/cloud-service-repository/）を選択します。

次のコマンドを実行して、リポジトリのクローンを作成します。

git clone https://git.cloudmanager.adobe.com/<organization-name>/<program id>/

Git リポジトリのクローンを作成するには、次の情報が必要です。

• 組織名：Adobe Experience Manager as a Cloud Service（AEM as a Cloud Service）内のチームまたはプロジェクトが識別されます。

• プログラム ID：リポジトリに関連付けられたプログラムが指定されます。

• 資格情報：リポジトリに安全にアクセスするには、ユーザー名とパスワード（または個人アクセストークン）が必要です。

この情報はどこにありますか？

これらの詳細を見つける手順について詳しくは、Adobe Experience League の記事「Git へのアクセス」を参照してください。

プロジェクトの準備が整いました。

コマンドが正常に完了すると、ローカルディレクトリに新しいフォルダーが作成されます。このフォルダーには、プログラムにちなんだ名前（例：program-id）が付けられます。このフォルダーには、AEM as a Cloud Service Git リポジトリからダウンロードしたすべてのファイルとコードが含まれます。

このガイドでは、このフォルダーを [AEMaaCS project directory] と呼びます。

エディターでリポジトリフォルダーを開きます。

Guide Localization Service.cfg.json ファイルを見つけます。このファイルは、AEM Forms アプリケーションでサポートされているロケールを制御します。このファイルを編集すると、新しいロケールを追加できます。

• 既存のファイル：ファイルが既に存在する場合は、AEM Forms プロジェクトディレクトリ内で見つけます。標準の場所は次のとおりです。

  code language-shell
  [AEMaaCS project directory]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config`.

  <appid> をプロジェクト固有のアプリ ID に置き換えます。AEM プロジェクトの <appid> は archetype.properties ファイルにあります。

  

• 新規ファイル：ファイルが存在しない場合は、上記と同じ場所に作成する必要があります。このドキュメントからファイル名をコピー＆ペーストするのではなく、手動で名前を入力します。ファイル名 Guide Localization Service.cfg.json には、スペースが含まれます。これは意図的なもので、ドキュメント内の誤字ではありません。

  OOTB でサポートされているロケールのリストを含むサンプルファイルは次のとおりです。

  code language-none
  { "supportedLocales":[ "en", "fr", "de", "ja", "pt-br", "zh-cn", "zh-tw", "ko-kr", "it", "es" ] }

目的の言語のロケールコードをファイルに追加します。

1. ISO 639-1コードリストを使用して、目的の言語を表す 2 文字のコードを見つけます。

2. Guide Localization Service.cfg.json ファイルにロケールコードを含めます。以下に例を示します。

   • 左から右に記述する言語：

     • 英語（米国）：en-US
     • スペイン語（スペイン）：es-ES
     • フランス語（フランス）：fr-FR

   • 右から左に記述する言語：

     • アラビア語（アラブ首長国連邦）：ar-ae
     • ヘブライ語：he（または歴史的参照用の iw）
     • ペルシア語：fa

変更を行った後、Guide Localization Service.cfg.json ファイルが有効な JSON ファイルとして正しく書式設定されていることを確認します。JSON の書式設定にエラーがあると、正しく機能しない場合があります。ファイルを保存します。

サンプルクライアントライブラリを見つけます。

[アダプティブフォームコアコンポーネントリポジトリ]のローカルコピー内で、次のパスに移動します。

    /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs

次の手順に従って、ライブラリをコピー＆ペーストします。

1. clientlib-it-custom-locale フォルダーをコピーします。

   

2. [AEMaaCS プロジェクトディレクトリ]内の次のディレクトリに移動します。

   code language-none
   /ui.apps/src/main/content/jcr_root/apps/<app-id>/clientlib

   重要：<app-id> をアプリケーションの実際の ID に置き換えます。

3. コピーした clientlib-it-custom-locale フォルダーをこのディレクトリにペーストします。

   

ロケールディレクトリに移動します。

[AEMaaCS project directory] 内で、次のパスに移動します。

    /ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/

重要：<program-id> を実際のアプリケーション ID に置き換えます。

サンプルの英語ファイルを見つけます。

AEM Forms では、GitHub 上にサンプルの英語ロケールファイル（.json）が用意されています。

英語の言語ファイルには、参照用のデフォルトの文字列セットが含まれます。ロケール固有のファイルは、英語の言語ファイルの構造を模倣する必要があります。

アラビア語、ヘブライ語、ペルシア語などの言語では、テキストは英語のように左から右（LTR）ではなく、右から左（RTL）に読み取られます。これらの言語でフォームを正しく表示するには、サンプルロケールファイルをガイドとして使用することをお勧めします。これらのファイルは、RTL 言語のテキスト、日付およびその他の要素を書式設定する方法に関する参照を提供します。次のサンプルロケールファイルを確認できます。

• アラビア語
• ヘブライ語
• ペルシア語

これらのサンプルファイルを活用することで、RTL 言語で作業するユーザーにシームレスなエクスペリエンスをフォームで提供できます。

ロケールファイルを作成します。

1. i18n ディレクトリ内に新しい .json ファイルを作成します。
2. 目的の言語の適切なロケールコードを使用してファイルに名前を付けます（例：フランス語の場合は fr-FR.json、アラビア語の場合は ar-ae.json）。このファイルの構造は、英語ロケールファイルと同じである必要があります。

構造と翻訳：

1. 新しく作成したファイルをテキストエディターで開きます。

2. 英語の値を、ターゲット言語の対応する翻訳に置き換えます。

3. 文字列の翻訳が完了したら、ファイルを保存します。

設定フォルダーを見つけます。

[AEMaaCS プロジェクトディレクトリ]内の次のディレクトリに移動します。

/ui.content/src/main/content/jcr_root/etc

必要なフォルダーを作成します（ない場合）。

jcr_root フォルダー内に etc フォルダーが存在しない場合は作成します。etc 内に languages という名前の別のフォルダーがない場合は作成します。

ロケール設定ファイルを作成します。

languages フォルダー内に、.content.xml という名前の新しいファイルを作成します。このドキュメントからファイル名をコピー＆ペーストするのではなく、手動で名前を入力します。

という名前の新しいファイルを作成

このファイルを開き、次の内容をペーストします。[LOCALE_CODE] を実際のロケールコード（例：アラビア語の場合は ar-ae）に置き換えます。

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
      jcr:primaryType="nt:unstructured"
      languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi]"/>

警告：既存のリストを置き換えないでください。代わりに、次のように（例として ar-ae を使用）新しいロケールコードを角括弧で囲み、コンマで区切って追加します。

languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi,ar-ae]"

新しいフォルダーを filter.xml に含めます。

[AEMaaCS プロジェクトディレクトリ]内の /ui.content/src/main/content/meta-inf/vault/filter.xml ファイルに移動します。

ファイルを開き、最後に次の行を追加します。

<filter root="/etc/languages"/>

の下にある filter.xml に追加します。

ファイルを保存します。