AEM ヘッドレスチュートリアルの第 4 章では、AEM コンテンツサービスのコンテキストにおける AEM の編集可能テンプレートの役割について説明します。編集可能テンプレートは、コンテンツサービスを有効化した AEM コンポーネントの構成を通じて、AEM コンテンツサービスがクライアントに開示する JSON コンテンツの構造を定義するために使用されます。
AEM の編集可能テンプレートを使用して、イベントコンテンツを JSON として開示するためにアクセスされる HTTP エンドポイントを定義します。
従来、AEM の編集可能テンプレートは web ページを定義するために使用されていましたが、この使い方は単なる慣例に過ぎません。編集可能テンプレートを使用すると、任意の一連のコンテンツを作成できます。そのコンテンツがどのようにアクセスされるかは、ブラウザーで HTML として、JavaScript(AEM SPA エディター)またはモバイルアプリで消費される JSON としてなど、そのページがリクエストされる方法によって異なります。
AEM コンテンツサービスでは、編集可能テンプレートを使用して、JSON データの開示方法を定義します。
WKND Mobile アプリでは、単一の API エンドポイントを駆動するために使用される単一の編集可能テンプレートを作成します。この例では AEM ヘッドレスの概念を簡単に説明しますが、異なる一連のコンテンツを開示する複数のページ(またはエンドポイント)を作成すると、より複雑で整理された API を作成できます。
API エンドポイントの構成を理解し、どのコンテンツを WKND Mobile アプリに開示する必要があるかを理解するために、設計をもう一度見てみましょう。
このように、モバイルアプリに提供するコンテンツの論理セットは 3 つあります。
これを行うには、これらの要件を AEM コンポーネント(この場合は AEM WCM コアコンポーネント)にマッピングして、必要なコンテンツを JSON として開示します。
AEM コンテンツサービスでページとコンポーネントが JSON エクスポートに対応するには、ページとコンポーネントが AEM WCM コアコンポーネントから派生している必要があります。
AEM WCM コアコンポーネントには、書き出したページとコンポーネントの正規化された JSON スキーマをサポートする機能が組み込まれています。このチュートリアルで使用するすべての WKND Mobile コンポーネント(ページ、画像、テキスト、コンテンツフラグメントリスト)は、AEM WCM コアコンポーネントから派生したものです。
ツール/一般/テンプレート/WKND Mobile に移動します。
Events API テンプレートを作成します。
まず、ルートのレイアウトコンテナのポリシーを編集して、コンテンツをモデル化するために必要な 3 つの特定された AEM コンポーネントを許可します。構造モードがアクティブであることを確認し、Layout Container [Root] を選択して「ポリシー」ボタンをタップします。
プロパティ/許可されたコンポーネントで WKND Mobile を検索します。Events API ページで使用できるように、WKND Mobile コンポーネントグループから次のコンポーネントを許可します。
WKND Mobile > Image
WKND Mobile > Text
WKND Mobile > Content Fragment List
完了したら、右上隅にある「完了」チェックマークをタップします。
ブラウザーウィンドウを更新して、新しく許可されたコンポーネントのリストを左側のパネルに表示します。
左側のパネルのコンポーネントファインダーから、次の AEM コンポーネントにドラッグします。
上記の各コンポーネントについて、それらを選択して「ロック解除」ボタンを押します。
ただし、他のコンポーネントが追加されたり、これら 3 つのコンポーネントが削除されたりしないよう、レイアウトコンテナ が ロックされていることを確認してください。
ページ情報/管理画面で表示をタップして、WKND Mobile テンプレートリストに戻ります。新しく作成した Events API テンプレートを選択し、上部のアクションバーで「有効にする」をタップします。
コンテンツの表示に使用されるコンポーネントがテンプレート自体に追加され、ロックされていることに注意してください。 これは、作成者が事前定義されたコンポーネントを編集できるようにするためですが、API 自体を変更すると、JSON 構造に関する前提が崩れ、消費するアプリが壊れる可能性があるため、コンポーネントを任意に追加または削除することはできません。すべての API は安定している必要があります。
必要に応じて、com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip コンテンツパッケージを AEM のパッケージ マネージャー経由で AEM オーサーにインストールします。このパッケージには、チュートリアルのこの章および前の章で概要を説明する設定とコンテンツが含まれています。