ドキュメント

AEM コンテンツフラグメントのカスタムロケールフォルダーで一意のフィールドの検証が失敗する

Last update: Thu Dec 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

AEMのカスタムロケールフォルダー名は、言語ルートとして認識されないので、一意のフィールド検証エラーが発生します。 この問題を修正するには、フォルダーの jcr:language プロパティを正しい ISO 言語コードに設定して、AEMが適切なロケールスコープを適用するようにします。

説明 description

環境

  • 製品： Adobe Experience Manager as a Cloud Service（AEMaaCS） - Sites
  • 制約： 標準の ISO 言語コードの代わりにカスタムロケールフォルダー名を使用すると、問題が発生します。

問題/症状

  • 異なるロケールフォルダー内で、非標準の言語コード名を使用する同じ値を持つコンテンツフラグメントを作成すると、一意のフィールドの検証が失敗します。
  • 例えば、mx のような ISO コードの代わりに es_MX を使用すると、AEMでフォルダーが同じスコープの一部として扱われ、予期しない一意性エラーが発生します。

解決策 resolution

この問題を解決するには、次の手順に従います。

  1. AEMのカスタムロケールフォルダー（/mx など）に移動します。
  2. このフォルダー内の jcr:content ノードにアクセスします。
  3. プロパティ jcr:language を適切な ISO 言語コード（例：es_MX）に設定します。
  4. AEMで変更内容を保存してコミットします。
  5. 異なるロケールフォルダー内で同一の一意のフィールド値を持つコンテンツフラグメントを作成または更新し、一意性検証エラーが発生していないことを確認します。

注意：jcr:language プロパティを設定すると、一意のフィールドと翻訳ワークフローで正しいロケールスコープを維持しながら、ビジネス固有のフォルダーの命名が可能になります。

関連資料

AEMaaCS ユーザーガイドの ​ コンテンツフラグメントモデルの定義 ​

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f