AEMがEDS コンテンツソースである場合のユニバーサルエディターのアクセスと設定の問題の解決
Edge Delivery Services（EDS）がAEMをコンテンツソースとして使用する場合、作成者はユニバーサルエディター内で、期待されるメタデータフィールド、ブロック設定値、テンプレートのバリエーション、JSON データを確認できません。 原因は、ほとんどの場合、アーキテクチャまたは設定の不一致です。EDS プロジェクトでは、1つのプライマリコンテンツソースのみをサポートし、BYOM （Bring Your Own Model）モデルはメタデータをユニバーサルエディターに明示的に公開する必要があり、動的フィールドの母集団にはカスタムユニバーサルエディター拡張機能が必要であり、JSONまたは設定データはEDS リポジトリ、構造化コンテンツ、またはDAM マッピングを通じて意図的に公開する必要があります。 オーサリングモードを確認し、シングルソースルールを適用し、必要なメタデータとデータを公開すると、欠落しているエディターフィールドが復元されます。
説明 description
問題：AEMがEDS コンテンツソースの場合、ユニバーサルエディターでメタデータ、ブロックフィールド、JSON データが表示されない
説明
Edge Delivery Services（EDS）とユニバーサルエディター（UE）を使用する場合、作成者はエディター内で期待されるメタデータフィールド、ブロック設定値、テンプレートのバリエーション、JSON データを確認できません。 UEでページが正しく読み込まれないか、作成者がページレベルのメタデータ、動的フィールド、ブロックオプションを設定できない。 また、単一のEDS プロジェクト内でユニバーサルエディターとドキュメントベースのオーサリングを混在させる、同じfstab.yaml内で複数のコンテンツソースを設定するなど、サポートされていないアーキテクチャパターンが試される場合もあります。 このような設定の誤りにより、レンダリングに一貫性がなくなったり、メタデータが欠落したり、特定のオーサリングインターフェイスを使用できなくなったり、AEMからの必要な入力を消費しないブロックが発生したりします。
環境：
- Adobe Experience Manager as a Cloud Service （AEMaaCS）
- AEM Managed Services
- AEM as a Cloud Service — Sites
- Edge Delivery Services（EDS）
- ユニバーサルエディター
問題/症状：
- ユニバーサルエディターは読み込まれますが、メタデータフィールドやブロック設定フィールドは表示されず、エラーは表示されません。
- BYOMからページレベルまたはブロックレベルのメタデータが欠落しているため、ブロックのレンダリングに失敗します。
- 作成者は、1つのEDS プロジェクトでドキュメントベースとUE オーサリングの両方を期待していますが、認識されるのは1つのソースのみです。
- カスタム JSONまたは設定データは、ファイルがDAMまたはGitHubに存在するにもかかわらず、ユニバーサルエディター内では使用できません。
- ブロックの動的ダイアログ/ドロップダウンオプションがUEに入力されることはありません。
根本原因：
EDSとユニバーサルエディターは、厳格なアーキテクチャモデルに従います。 単一のEDS プロジェクトには、プライマリコンテンツソースが1つしかありません。BYOM モデルは、メタデータをユニバーサルエディターに明示的に公開する必要があります。動的フィールドの母集団には、カスタムユニバーサルエディター拡張機能が必要であり、JSONまたはその他の設定データは、EDS リポジトリ、構造化コンテンツ、またはDAM マッピングを通じて意図的に公開する必要があります。 これらの領域の設定が正しくないと、メタデータが欠落したり、設定データにアクセスできないか、サポートされていないハイブリッド設定になります。
確認方法
- プロジェクトで使用するオーサリングモード（ユニバーサルエディター、ドキュメントベース、またはその両方）を確認して、ユニバーサルエディターが有効になっているかどうか、および問題のページで機能することが期待されているかどうかを確認します。 不明な場合は、UEで開かれている正確なURLを取得します。
fstab.yamlまたはプロジェクト要件を確認して、EDS プロジェクトが1つのプライマリコンテンツソースのみを使用し、設定が1つのプロジェクトにAEMとドキュメントベースのソースを混在させるかどうかを確認します。- UE オーサリングに必要なページレベルのメタデータが、ベース
page-metadataモデルやテンプレート固有のモデルなど、BYOMを介して公開されているかどうかを確認します。 テンプレートが必要な場合は、template= page-typeがページメタデータに保存されていることを確認します。
解決策 resolution
-
シングルコンテンツソースルールを適用します。 EDSは、プロジェクトごとに1つのプライマリコンテンツソースをサポートします。 プロジェクトがAEMやドキュメントベースのオーサリングなどのソースを組み合わせる場合は、2つの別々のEDS サイトを作成し、CDN ルーティングを使用してそれらのサイト間のトラフィックを誘導します。 ネイティブのハイブリッド UEと、単一リポジトリ内のドキュメントベースのオーサリングはサポートされていません。
-
BYOMを通じてUE オーサリングに必要なメタデータを公開します。 基本
page-metadataモデルが存在することを確認し、必要に応じてテンプレート固有のメタデータモデルを定義します。 AEM ページのプロパティで、ブロックが期待するtemplateメタデータ値が公開されていることを確認します。 -
オーサー編集可能か静的かにもとづいて、カスタム JSONまたは設定データを公開します。
- データがオーサーで編集可能な場合は、EDS構造化コンテンツを使用してスキーマを定義します。
- データが静的な場合は、JSONをEDS リポジトリに保存するか、明示的なマッピングを使用してAEM DAMに保存します。
UEとブロックがデータを取得できるように、結果のエンドポイント URLが到達可能であることを確認します。
4. 動的なドロップダウンやフィールドの設定を正しく処理する。 EDSはGranite UI データソースをサポートしていないため、動的ドロップダウンオプションはそうやって読み込むことはできません。 代わりに、カスタムフィールドとクライアントサイドのAPI呼び出しでユニバーサルエディターの拡張性を使用します。これには、UE拡張機能を実装する必要があります。
5. 複数のページテンプレートが必要なサイトのテンプレートとブロックの動作を確認します。 関連するAEM ページに「 テンプレートとして使用」というマークを付け、テンプレートのメタデータ（CSS クラス）をスタイル設定します。 テンプレートからページを作成し、正しい初期コンテンツとメタデータを含むことを確認します。
検証
- ユニバーサルエディターでページを開き、予想されるすべてのメタデータフィールドとブロック設定フィールドが表示されていることを確認します。
.pageドメインでページを読み込み、動的メタデータまたはJSON データのレンダリングをページヘッドに確認します。- JSON エンドポイントへの
fetch()呼び出しが、想定されるコンテンツを返すことを確認します。 - 再公開後に動的設定レンダリングを使用してブロックを正しく確認します。