第 5 章 - コンテンツサービスページのオーサリング

AEM ヘッドレスチュートリアルの第 5 章では、第 4 章で定義したテンプレートからページを作成する方法について説明します。この章で作成するページは、モバイルアプリの JSON HTTP エンドポイントとして機能します。

NOTE
/content/wknd-mobile/en/api のページコンテンツアーキテクチャは事前に定義されています。enapi のベースページは、アーキテクチャと組織に関する目的に役立ちますが、厳密には必須ではありません。API コンテンツをローカライズする場合、API ページはその他の AEM Sites ページと同様にローカライズできるため、通常の言語コピーや Multi-site Manager ページ組織のベストプラクティスに従うことが推奨されています。

Event API ページの作成

  1. AEM/Sites/WKND Mobile/English/API ​に移動します。

  2. API ページのラベルをタップ ​し、上部のアクションバーにある「作成」ボタンをタップして、API ページの下に新規 Events API ページを作成します。

    1. 上部のアクションバーで「作成」 をタップします
    2. Events API テンプレートを選択します
    3. 名前」フィールドに「events」と入力します
    4. タイトル」フィールドに「Events API」と入力します
    5. 上部のアクションバーで「作成」をクリックしてページを作成します
    6. 完了」をクリックして、AEM Sites 管理者に戻ります

Events API ページのオーサリング

NOTE
このプロジェクトでは、オーサーエクスペリエンスに基本的なスタイルをいくつか適用するために CSS を提供しています。
  1. AEM/Sites/WKND Mobile/英語/API に移動し、「Events API」ページを選択し、上部のアクションバーで「編集」をクリックして、「Events API」ページを編集します。

  2. ロゴ画像 ​をアセットファインダーから画像コンポーネントプレースホルダーにドラッグ&ドロップして、アプリに表示する画像を追加します。

    • /content/dam/wknd-mobile/images/wknd-logo.png にある指定されたロゴを使用します。
  3. タグ行 ​を追加して、イベントの上に表示します。

    1. テキスト ​コンポーネントを編集します
    2. 次のテキストを入力します
      • The WKND is here.
  4. 表示する​ イベント ​を選択します

    1. プロパティ」タブで次の設定を行います

      • モデル:イベント
      • 親パス:/content/dam/wknd-mobile/ja/events
      • タグ:<Leave blank>
    2. 要素」タブで次の設定を行います

      • リストに表示されている要素をすべて削除して、イベントコンテンツフラグメントのすべての要素が公開されるようにします。

API ページの JSON 出力の確認

JSON 出力とその形式は、.model.json セレクターを使用してページを要求することで確認できます。

この API の利用者は、この JSON 構造(またはスキーマ)をよく理解しておく必要があります。API をご利用のお客様は、構造のどの側面が固定されているかを把握することが非常に重要です(流動的な Event API のロゴ(画像)とタグライブ(テキスト)(つまり、コンテンツフラグメントリストコンポーネントの下にリスト表示されるイベント)。

公開済み API でこの契約を解除すると、使用中のアプリで誤った動作が発生する可能性があります。

  1. 新規ブラウザータブで、.model.json セレクターを使用してイベント API ページをリクエストします。これにより、AEM Content Services の JSON エクスポーターが呼び出され、ページとコンポーネントを正規化済みの適切に定義された JSON 構造にシリアル化します。

    これらのページで生成される JSON 構造は、アプリケーションを使用する構造に合わせる必要があります。

  2. Events API ページを JSON としてリクエストします。

    結果は次のようになります。

AEM Content Services JSON 出力

NOTE
この JSON は、.tidy セレクターを使用して、人間が読みやすいように​ 整えられた(フォーマットされた)形で出力できます。

次の手順

必要に応じて、com.adobe.aem.guides.wknd-mobile.content.chapter-5.zip コンテンツパッケージを AEM のパッケージマネージャーを通じて AEM オーサーにインストールします。このパッケージには、チュートリアルのこの章および前の章で概要を説明する設定とコンテンツが含まれています。

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4