コンテンツフラグメントモデルを作成する

Last update: Wed Sep 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

適用対象：
Experience Manager as a Cloud Service

トピック：
コンテンツフラグメント

作成対象：

初心者
開発者

この章では、コンテンツフラグメントモデル を使用してコンテンツをモデル化し、スキーマを構築する方法と、コンテンツフラグメントモデルを定義する様々なデータタイプについて説明します。

このチュートリアルでは、チーム と人物という 2 つのシンプルなモデルを作成します。 チーム データモデルには、名前、短い名前、説明が付けられており、姓名、プロフィールの詳細、プロファイルの画像、職業のリストを含む人物データモデルを参照します。

目的

コンテンツフラグメントモデルを作成します。
モデルの構築に使用できるデータタイプと検証オプションについて説明します。
コンテンツフラグメントモデルが、コンテンツフラグメントのデータスキーマとオーサリングテンプレートの両方を定義する方法を理解します。

プロジェクト設定の作成

プロジェクト設定には、特定のプロジェクトに関連付けられたすべてのコンテンツフラグメントモデルが含まれており、モデルを整理する手段を提供します。コンテンツフラグメントモデルを作成する前プロジェクトを少なくとも 1 つ作成します。

AEM オーサー 環境にログインします（例：https://author-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.adobeaemcloud.com/）。
AEM 開始画面から、ツール／一般／設定ブラウザー に移動します。
上部のアクションバーで「作成」をクリックし、次の設定の詳細を入力します。
- タイトル：マイプロジェクト
- 名前：my-project
- コンテンツフラグメントモデル：オン
「作成」を選択して、プロジェクト設定を作成します。

コンテンツフラグメントモデルを作成する

次に、チーム および人物のコンテンツフラグメントモデルを作成します。これらは、チームおよびチームの一員を表すデータモデル（スキーマ）として機能し、作成者がこれらのモデルに基づいてコンテンツフラグメントを作成および編集するためのインターフェイスを定義します。

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

ユーザー 用のコンテンツフラグメントモデルを作成します。これは、チームの一員である個人を表すデータモデルまたはスキーマです。

AEM 開始画面から、ツール／一般／コンテンツフラグメントモデル に移動します。
マイプロジェクト フォルダーに移動します。
右上隅にある作成を選択して、モデルを作成 ウィザードを表示します。
次のプロパティを持つコンテンツフラグメントモデルを作成します。
- モデルタイトル：人物
- モデルを有効にする：オン
「作成」を選択します。表示されたダイアログで、「開く」を選択してモデルを作成します。
1 行のテキスト 要素をメインパネルにドラッグ＆ドロップします。「プロパティ」タブで次のプロパティを入力します。
- フィールドラベル：フルネーム
- プロパティ名：fullName
- 「必須」にチェックを入れます
プロパティ名 は、作成した値がAEMに保存されるプロパティの名前を定義します。 プロパティ名 では、データスキーマの一部としてこのプロパティのキー名前も定義され、AEM OpenAPI を使用してコンテンツフラグメントが配信される際に JSON 応答のキーとして使用されます。
「データタイプ」タブを選択し、「複数行テキスト」フィールドを「フルネーム」フィールドの下にドラッグ&ドロップします。次のプロパティを入力します。
- フィールドラベル：略歴
- プロパティ名：biographyText
- デフォルトのタイプ：リッチテキスト
「データタイプ」タブをクリックして、「コンテンツ参照」フィールドをドラッグ＆ドロップします。次のプロパティを入力します。
- フィールドラベル：プロファイル画像
- プロパティ名：profilePicture
- ルートパス：/content/dam
  
  ルートパス を設定する際に、フォルダー アイコンをクリックしてモーダルを表示し、パスを選択できます。これにより、作成者がパスへの入力に使用できるフォルダーが制限されます。 /content/dam は、すべての AEM Assets（画像、ビデオ、その他のコンテンツフラグメント）が保存されるルートです。
- 特定のコンテンツタイプのみを許可：画像
  
  画像参照 に検証を追加して、画像コンテンツタイプのみをフィールドの入力に使用できるようにします。
- サムネールを表示：オン
「データタイプ」タブをクリックし、列挙データタイプを「画像参照」フィールドの下にドラッグ＆ドロップします。次のプロパティを入力します。
- レンダリング形式：チェックボックス
- フィールドラベル：職業
- プロパティ名：occupation
- オプション :
  - アーティスト
  - インフルエンサー
  - フォトグラファー
  - 旅行者
  - Writer
  - YouTuber
オプションラベルと値の両方を同じ値に設定します。
最終的な人物モデルは次のようになります。
「保存」をクリックして、変更を保存します。

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

チーム 用のコンテンツフラグメントモデルを作成します。これは、人物のチームのデータモデルです。チームモデルは、チームのメンバーを表す Person コンテンツフラグメントを参照します。

マイプロジェクト フォルダーの右上隅にある作成を選択して、モデルを作成 ウィザードを表示します。
モデルタイトル フィールドに チーム と入力して作成を選択します。

表示されたダイアログで開くを選択して、新しく作成したモデルを開きます。
1 行のテキスト 要素をメインパネルにドラッグ＆ドロップします。「プロパティ」タブで次のプロパティを入力します。
- フィールドラベル：タイトル
- プロパティ名：title
- 「必須」にチェックを入れます
「データタイプ」タブを選択し、「複数行テキスト」フィールドを「短縮名」フィールドの下にドラッグ&ドロップします。次のプロパティを入力します。
- フィールドラベル：説明
- プロパティ名：description
- デフォルトのタイプ：リッチテキスト
「データタイプ」タブをタップし、「フラグメント参照」フィールドをドラッグ＆ドロップします。次のプロパティを入力します。
- レンダリング形式：複数フィールド
- 最小項目数：2
- フィールドラベル：チームメンバー
- プロパティ名：teamMembers
- 許可されているコンテンツフラグメントモデル：フォルダーアイコンを使用して、Person モデルを選択します。
最終 チーム モデルは次のようになります。
「保存」をクリックして、変更を保存します。
これで、2 つのモデルを使用できるようになります。