第 2 章 - コンテンツフラグメントモデルの使用

AEM コンテンツフラグメントモデルは、AEM 作成者が Raw コンテンツの作成をテンプレート化するために使用できるコンテンツスキーマを定義します。このアプローチは、基礎モードやフォームベースのオーサリングに似ています。コンテンツフラグメントの重要な概念は、作成されたコンテンツがプレゼンテーションに依存しないことです。つまり、AEM、単一ページアプリケーション、モバイルアプリなど、消費側のアプリケーションがコンテンツの表示方法を制御できるマルチチャネルでの使用を意図していることです。

コンテンツフラグメントの一番の関心事は、次の点を確実にすることです。

  1. 正しいコンテンツが作成者から収集される。
  2. 構造化された理解しやすい形式でコンテンツを消費側アプリケーションに公開できる。

この章では、「イベント」のモデリングと作成のための正規化されたデータ構造とオーサリングインターフェイスの定義に使用するコンテンツフラグメントモデルの有効化と定義について説明します。

コンテンツフラグメントモデルの有効化

コンテンツフラグメントモデルは、AEM の設定ブラウザー ​で​ 有効にする必要があります

設定に対してコンテンツフラグメントモデルが​ 有効になっていない ​場合、関連する AEM 設定に対して​ 作成/コンテンツフラグメント ​ボタンは表示されません。

NOTE
AEM の設定は、/conf 下に保存された一連のコンテキスト対応のテナント設定を表します。通常、AEM の設定は、AEM Sitesで管理される特定の web サイトや、AEM のコンテンツのサブセット(アセットやページなど)を担当するビジネスユニットと関連があります。
設定がコンテンツ階層に影響を与えるためには、設定がそのコンテンツ階層の cq:conf プロパティを通じて参照される必要があります。これは、以下の​ 手順 5 の WKND Mobile 設定で実現されます。
global 設定を使用すると、設定はすべてのコンテンツに適用され、cq:conf を設定する必要はありません。
詳しくは、設定ブラウザーのドキュメントを参照してください。
  1. 適切な権限を持つユーザーとして AEM オーサーにログインして、関連する設定を変更します。

    • このチュートリアルでは、admin ユーザーを使用できます。
  2. ツール/一般/設定ブラウザー ​に移動します。

  3. WKND Mobile の横にある​ フォルダーアイコン ​をタップして選択したあと、左上の「編集」ボタンをタップします。

  4. コンテンツフラグメントモデル ​を選択し、右上の「保存して閉じる」をタップします。

    これにより、WKND Mobile 設定が適用されたコンテンツフラグメントモデルがアセットフォルダーコンテンツツリーで有効になります。

    note note
    NOTE
    この設定変更は、AEM 設定 web UI から元に戻すことはできません。この設定を元に戻すには、以下を実行します。
    code language-none
    1. [CRXDE Lite](http://localhost:4502/crx/de) を開きます。
    1. `/conf/wknd-mobile/settings/dam/cfm` に移動します。
    1. `models` ノードを削除します。
    
    この設定で作成された既存のコンテンツフラグメントモデルはすべて削除され、その定義は /conf/wknd-mobile/settings/dam/cfm/models に保存されます。
  5. WKND Mobileアセットフォルダー ​に WKND Mobile 設定を適用して、コンテンツフラグメントモデル内のコンテンツフラグメントをアセットフォルダー階層内に作成できるようにします。

    1. AEM/アセット/ファイル ​に移動します。
    2. WKND Mobile フォルダー ​を選択します。
    3. 上部のアクションバーにある「プロパティ」ボタンをタップしてフォルダーのプロパティを開きます。
    4. フォルダーのプロパティで「クラウドサービス」タブをタップします。
    5. クラウド設定」フィールドが /conf/wknd-mobile に設定されていることを確認します。
    6. 変更を保存するには、右上の「保存して閉じる」をタップします。
WARNING
コンテンツフラグメントモデル ​が、ツール/アセット ​から​__ツール/一般__​に移動しました。

作成するコンテンツフラグメントモデルについて

コンテンツフラグメントモデルを定義する前に、エクスペリエンスをレビューし、必要なデータポイントをすべて取り込んでいることを確認してください。そのために、モバイルアプリケーションのデザインをレビューし、デザイン要素を、収集するコンテンツにマッピングします。

イベントを定義するデータポイントを次のように分類できます。

コンテンツフラグメントモデルの作成

マッピングを使用することで、イベントデータを収集し最終的に公開するためのコンテンツフラグメントを定義できます。

コンテンツフラグメントモデルの作成

  1. ツール/一般/コンテンツフラグメントモデル ​に移動します。
  2. WKND Mobile フォルダーをタップして開きます。
  3. 作成 ​をタップして、コンテンツフラグメントモデル作成ウィザードを開きます。
  4. モデルタイトル(説明はオプション) ​として Event を入力し、「作成」をクリックして保存します。

コンテンツフラグメントモデルの構造の定義

  1. ツール/一般/コンテンツフラグメントモデルに移動しますWKND

  2. Event コンテンツフラグメントモデルを選択し、上部のアクションバーで「編集」をクリックします。

  3. 右側の「データタイプ」タブ ​から、「1 行のテキスト入力」を左側のドロップゾーンにドラッグして、Question フィールドを定義します。

  4. 新しい「1 行のテキスト入力」が左側で選択され、「プロパティ」タブ が右側で選択されていることを確認します。「プロパティ」フィールドに以下のように値を入力します。

    • レンダリング時の名前:textfield
    • フィールドラベル:Event Title
    • プロパティ名:eventTitle
    • 最大長:25
    • 必須:Yes

以下に定義する入力定義を使用してこれらの手順を繰り返し、残りのイベントコンテンツフラグメントモデルを作成します。

NOTE
Android アプリケーションが該当する名前をキーオフするようにプログラムされているため、「プロパティ名」フィールドは完全に一致させる必要があります。

イベントの説明

  • データタイプ:Multi-line text
  • フィールドラベル:Event Description
  • プロパティ名:eventDescription
  • デフォルトの種類:Rich text

イベントの日付と時間

  • データタイプ:Date and time
  • フィールドラベル:Event Date and Time
  • プロパティ名:eventDateAndTime
  • 必須:Yes

イベントタイプ

  • データタイプ:Enumeration
  • フィールドラベル:Event Type
  • プロパティ名:eventType
  • オプション:Art,Music,Performance,Photography

チケット価格

  • データタイプ:Number
  • レンダリング時の名前:numberfield
  • フィールドラベル:Ticket Price
  • プロパティ名:eventPrice
  • タイプ:Integer
  • 必須:Yes

イベント画像

  • データタイプ:Content Reference
  • レンダリング時の名前:contentreference
  • フィールドラベル:Event Image
  • プロパティ名:eventImage
  • ルートパス:/content/dam/wknd-mobile/images
  • 必須:Yes

会場名

  • データタイプ:Single-line text
  • レンダリング時の名前:textfield
  • フィールドラベル:Venue Name
  • プロパティ名:venueName
  • 最大長:20
  • 必須:Yes

会場都市

  • データタイプ:Enumeration
  • フィールドラベル:Venue City
  • プロパティ名:venueCity
  • オプション:Basel,London,Los Angeles,Paris,New York,Tokyo
NOTE
プロパティ名 ​は、この値が格納される JCR プロパティ名と JSON ファイル内のキーの​ 両方 ​を示します。これは、コンテンツフラグメントモデルの存続期間中は変更されないセマンティック名にする必要があります。

コンテンツフラグメントモデルの作成が完了すると、最終的に次のような定義になります。

イベントコンテンツフラグメントモデル

次の手順

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

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