第 4 章 — Content Services テンプレートの定義

AEMヘッドレスチュートリアルの第 4 章では、AEM Content Services のコンテキストでのAEM編集可能テンプレートの役割について説明します。 編集可能なテンプレートは、コンテンツサービスが有効なAEMコンポーネントの構成を通じて、AEM Content Services がクライアントに公開する JSON コンテンツ構造を定義するために使用されます。

AEM Content Services でのテンプレートの役割について

AEM編集可能テンプレートは、イベントコンテンツを JSON として公開するためにアクセスされる HTTP エンドポイントを定義するために使用されます。

従来のAEM編集可能テンプレートは、Web ページの定義に使用されていましたが、この使用は単なる慣例です。 編集可能なテンプレートを使用して、 任意 一連のコンテンツそのコンテンツへのアクセス方法:をブラウザーのHTMLとして使用する場合、JavaScript(AEM SPA Editor) やモバイルアプリは、そのページがリクエストされる方法の関数です。

AEM Content Services では、編集可能なテンプレートを使用して、JSON データの公開方法を定義します。

の WKND Mobile アプリ、単一の API エンドポイントを駆動するために使用される単一の編集可能なテンプレートを作成します。 この例ではAEMヘッドレスの概念を簡単に説明しますが、異なるコンテンツのセットをそれぞれ公開する複数のページ(またはエンドポイント)を作成して、より複雑で整理された API を作成できます。

API エンドポイントについて

アドビの API エンドポイントの作成方法と、アドビの API エンドポイントに公開するコンテンツを理解する WKND Mobile アプリ、デザインを再度見てみましょう。

イベント API ページの分解

このように、モバイルアプリに提供するコンテンツの論理セットは 3 つあります。

  1. この ロゴ
  2. この タグライン
  3. リスト イベント

これをおこなうには、必要なコンテンツを JSON として公開するために、これらの要件をAEMコンポーネント ( この場合はAEM WCM コアコンポーネント ) にマッピングします。

  1. この ロゴ は、 画像コンポーネント
  2. この タグラインテキストコンポーネント
  3. リスト イベントコンテンツフラグメントリストコンポーネント 次に、は一連のイベントコンテンツフラグメントを参照します。
メモ

AEM Content Service のページとコンポーネントの JSON 書き出しをサポートするには、ページとコンポーネントを使用する必要があります AEM WCM コアコンポーネントから派生.

AEM WCM コアコンポーネント には、書き出されたページとコンポーネントの正規化された JSON スキーマをサポートする組み込み機能があります。 このチュートリアルで使用される WKND Mobile コンポーネント(ページ、画像、テキスト、コンテンツフラグメントリスト)はすべて、AEM WCM コアコンポーネントから派生したものです。

イベント API テンプレートの定義

  1. に移動します。 ツール > 一般 > テンプレート >WKND Mobile.

  2. を作成します。 Events API テンプレート:

    1. タップ 作成 上部のアクションバー
    2. を選択します。 WKND Mobile - Empty Page テンプレート
    3. タップ 次へ 上部のアクションバー
    4. 入力 Events API 内 テンプレートタイトル フィールド
    5. タップ 作成 上部のアクションバー
    6. タップ 開く 編集用に新しいテンプレートを開く
  3. まず、識別された 3 つのAEMコンポーネントを許可し、 ポリシー ルートの レイアウトコンテナ. 次を確認します。 構造 モードがアクティブな場合は、 Layout Container [Root]​をクリックし、 ポリシー 」ボタンをクリックします。

  4. の下 プロパティ > 許可されたコンポーネント 検索 WKND Mobile. 次のコンポーネントを WKND Mobile コンポーネントグループを作成し、 Events API ページを参照してください。

    • WKND Mobile > Image

      • アプリのロゴ
    • WKND Mobile > Text

      • アプリの紹介テキスト
    • WKND Mobile > Content Fragment List

      • アプリで表示できるイベントカテゴリのリスト
  5. 次をタップします。 完了 完了したら、右上隅にチェックマークを付けます。

  6. 更新 新しく 許可されたコンポーネント リストを左側のパネルに表示します。

  7. 左側のパネルのコンポーネントファインダーから、次のAEMコンポーネントにドラッグします。

    1. Image ロゴ
    2. Text (タグ行)
    3. Content Fragment List イベントの
  8. 上記の各コンポーネント​をクリックし、 ロック解除 」ボタンをクリックします。

  9. ただし、 レイアウトコンテナロック済み 他のコンポーネントが追加されないようにするか、これらの 3 つのコンポーネントが削除されないようにする。

  10. タップ ページ情報 > 管理で表示 に戻る WKND Mobile テンプレートのリスト。 新しく作成した Events API テンプレートをタップします。 有効にする 」をクリックします。

メモ

コンテンツの表示に使用されるコンポーネントがテンプレート自体に追加され、ロックダウンされていることに注意してください。 これは、API 自体を変更すると JSON 構造の前提が崩れ、使用中のアプリが壊れる可能性があるので、作成者が事前定義済みのコンポーネントを編集できる一方で、コンポーネントの追加や削除は恣意的にはおこなえないようにするためです。 すべての API は安定している必要があります。

次の手順

オプションで、 com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip を介して AEM オーサー上のコンテンツパッケージ AEM Package Manager. このパッケージには、チュートリアルのこの章および前の章で概要を説明する設定とコンテンツが含まれています。

このページ