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

AEMのコンテンツフラグメントモデルは、コンテンツフラグメントの構造を定義します。は、ヘッドレスコンテンツの基盤となります。

コンテンツフラグメントモデルを使用するには、以下をおこないます。

1. インスタンスに対するコンテンツフラグメントモデル機能の有効化
2. コンテンツフラグメントモデルの作成と設定
3. コンテンツフラグメントの作成時に使用するコンテンツフラグメントモデルの有効化
4. ポリシー​の設定による必要なアセットフォルダーに対するコンテンツフラグメントモデルの許可

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

1. ツール／アセット​に移動し、コンテンツフラグメントモデル​を開きます。

2. 目的の設定に適したフォルダーに移動します。

3. 「作成」を使用してウィザードを開きます。

   注意

   コンテンツフラグメントモデルの使用が有効になっていない場合、「作成」オプションは使用できません。

4. 「モデルタイトル」を指定します。また、「タグ」、「説明」を追加し、必要に応じて「モデルを有効化」を選択してモデルを有効にします。

   

5. 「作成」を使用して空のモデルを保存します。操作の成功を示すメッセージが表示されます。「開く」を選択してモデルをすぐに編集するか、「完了」を選択してコンソールに戻ることができます。

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

コンテンツフラグメントモデルは、データタイプ​の選択を使用して、結果として得られるコンテンツフラグメントの構造を効果的に定義します。モデルエディターを使用して、データ型のインスタンスを追加し、それらを設定して必須フィールドを作成できます。

1. ツール／アセット​に移動し、コンテンツフラグメントモデル​を開きます。

2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

3. 必要なモデルを​編集​用に開きます。クイック操作を使用するか、モデルを選択してツールバーから操作を選択します。

   モデルを開くと、モデルエディターに次の情報が表示されます。

   • 左：既に定義されているフィールド
   • 右：フィールドの作成に使用できる​データタイプ（およびフィールドの作成後に使用する​プロパティ）
   メモ

   あるフィールドを​必須​として指定した場合、左側のウィンドウに表示される​ラベル​にアスタリスク（​*）が付きます。

1. フィールドを追加するには

   • 必要なデータタイプをフィールドの必要な場所にドラッグします。

     

   • フィールドがモデルに追加されると、その特定のデータタイプに対して定義できる​プロパティ​が右側のパネルに表示されます。ここで、そのフィールドに必要な項目を定義することができます。

     • 多くのプロパティは自明です。詳しくは「プロパティ」を参照してください。
     • 「フィールドラベル」を入力すると、「プロパティ名」が空欄の場合は自動入力され、後で手動で更新できます。

     次に例を示します。

     

2. フィールドを削除するには

   必要なフィールドを選択し、ごみ箱アイコンをクリックまたはタップします。この操作の確認が求められます。

   

3. すべての必須フィールドを追加し、必要に応じて関連するプロパティを定義します。次に例を示します。

   

4. 「保存」を選択して、定義を保持します。

データタイプ

モデルの定義には、次のデータタイプを選択できます。

• 1 行のテキスト
  • 1 行のテキストのフィールドを 1 つ以上追加（最大長は定義可能）
• 複数行テキスト
  • リッチテキスト、プレーンテキストまたはマークダウンのテキスト領域
• 数値
  • 1 つ以上の数値フィールドを追加
• ブール型
  • ブール型チェックボックスを追加
• 日時
  • 日付や時刻を追加
• 列挙
  • チェックボックス、ラジオボタン、ドロップダウンフィールドのセットを追加
• タグ
  • フラグメント作成者がタグの領域にアクセスして選択できるようにする
• コンテンツ参照
  • 任意の種類の他のコンテンツを参照し、ネストされたコンテンツの作成に使用可能
  • 画像が参照されている場合、サムネールの表示をオプトできます
• フラグメント参照
  • 他のコンテンツフラグメントの参照を、ネストされたコンテンツの作成に使用可能
  • フラグメント作成者が次の操作をおこなえるようにデータタイプを設定可能
    • 参照先フラグメントの直接編集
    • 適切なモデルに基づいた新しいコンテンツフラグメントの作成
• JSON オブジェクト
  • コンテンツフラグメントの作成者がフラグメントの対応する要素に JSON 構文を入力可能
    • 別のサービスからコピー＆ペーストした JSON を AEM に直接保存できるようにする。
    • JSON が渡され GraphQL で JSON として出力される。
    • コンテンツフラグメントエディターに JSON 構文のハイライト表示機能、オートコンプリート、エラーのハイライト表示が組み込まれている。
• タブプレースホルダー

  • コンテンツフラグメントコンテンツの編集時に使用するタブを導入できます。
    これは、コンテンツデータタイプのリストのセクションを区切る、モデルエディターの区切りとして表示されます。 各インスタンスは、新しいタブの開始を表します。
    フラグメントエディターでは、各インスタンスがタブとして表示されます。

    メモ

    このデータ型は純粋に形式設定に使用され、AEM GraphQLスキーマでは無視されます。

プロパティ

多くのプロパティは説明がなく、一部のプロパティの詳細を以下に示します。

• Render As
  フラグメント内のフィールドを実現／レンダリングするための様々なオプション。多くの場合、これにより、作成者にフィールドの 1 つのインスタンスが表示されるか、作成者が複数のインスタンスを作成できるかを定義できます。

• フィールドラベル
  フィールドラベル​は​プロパティ名​を自動生成します。プロパティ名は必要に応じて手動で更新できます。

• 検証​基本検証は、
  必須​プロパティなどのメカニズムで使用できます。一部のデータ型には、追加の検証フィールドがあります。詳しくは、「検証」を参照してください。

• データタイプが​複数行テキスト​の場合、「デフォルトの種類」を次のいずれかとして定義できます。

  • リッチテキスト
  • Markdown
  • プレーンテキスト

  指定しなかった場合は、デフォルト値の​リッチテキスト​がこのフィールドで使用されます。

  コンテンツフラグメントモデルで「デフォルトの種類」を変更した場合、その影響が既存の関連コンテンツフラグメントに及ぶのは、そのフラグメントがエディターで開かれて保存された後です。

• 一意：
  （特定のフィールドの）コンテンツは、現在のモデルから作成されたすべてのコンテンツフラグメントで一意である必要があります。

  これにより、同じモデルの別のフラグメントに既に追加されているコンテンツをコンテンツ作成者が繰り返し作成できないようになります。

  例えば、コンテンツフラグメントモデルの 1 行のテキスト​フィールド Country は、2 つの依存するコンテンツフラグメントで同じ Japan 値を持つことはできません。2 回目に入力しようとすると、警告が表示されます。

  メモ

  言語ルートごとに一意性が確保されます。

  メモ

  バリエーションは、同じフラグメントのバリエーションと同じ​一意の​値を持つことができますが、他のフラグメントのバリエーションで使用されている値とは異なります。

• 変換可能：
  CF モデルエディターでフィールドの「変換可能」チェックボックスをオンにすると、

  • フィールドのプロパティ名がまだ存在しない場合は、翻訳設定のコンテキスト /content/dam/<tenant> に確実に追加されます。
  • GraphQL の場合：「コンテンツフラグメント」フィールドの <translatable> プロパティを yes に設定して、変換可能なコンテンツのみを含む JSON を出力するための GraphQL クエリフィルターを許可します。

• 特定のデータ型とそのプロパティの詳細については、「コンテンツ参照」を参照してください。

• 特定のデータタイプとそのプロパティについて詳しくは、フラグメント参照（ネストされたフラグメント）​を参照してください。

検証

様々なデータ型に、結果のフラグメントにコンテンツが入力される際の検証要件を定義できるようになりました。

• 1 行のテキスト
  • 事前定義された正規表現と比較します。
• 数値
  • 特定の値を確認します。
• コンテンツ参照
  • 特定のタイプのコンテンツをテストします。
  • 指定したファイルサイズ以下のアセットのみを参照できます。
  • 定義済みの幅または高さ（ピクセル単位）の範囲に収まる画像のみを参照できます。
• フラグメント参照
  • 特定のコンテンツフラグメントモデルをテストします。

参照の使用によるネストされたコンテンツの作成

コンテンツフラグメントは、次のいずれかのデータタイプを使用して、ネストされたコンテンツを作成できます。

• コンテンツ参照

  • 他のコンテンツへの単純な参照（任意のタイプ）を提供します。
  • （結果のフラグメント内で）1 つまたは複数の参照に対して設定できます。

• フラグメント参照（ネストされたフラグメント）

  • 指定した特定のモデルに応じて、他のフラグメントを参照します。

  • 構造化データを包含／取得できます。

    メモ

    この方法は、GraphQL でコンテンツフラグメントを使用したヘッドレスコンテンツ配信との関連で特に重要になります。

  • （結果のフラグメント内で）1 つまたは複数の参照に対して設定できます。

• GraphQLのフラグメント参照
  相互に参照される複数のコンテンツフラグメントを返すディープクエリを作成する場合、最初の出現時にnullが返されます。

コンテンツ参照

コンテンツ参照を使用すると、別のソース（例：画像やコンテンツフラグメント）からコンテンツをレンダリングできます。

標準プロパティに加えて、次のものを指定できます。

• 参照されるコンテンツの​ルートパス
• 参照可能なコンテンツタイプ
• ファイルサイズの制限
• 画像が参照される場合：
  • サムネールを表示
  • 画像の高さと幅の制限

フラグメント参照（ネストされたフラグメント）

フラグメント参照は 1 つ以上のコンテンツフラグメントを参照します。複数のレイヤーを持つ構造化データを取得できるようになるので、アプリケーションで使用するコンテンツを取得する場合、この機能は特に重要になります。

次に例を示します。

• 従業員の詳細を定義するモデルです。以下が含まれます。
  • 事業主（会社）を定義するモデルへの参照

type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}

標準プロパティに加えて、次のものを定義できます。

• レンダリング時の名前:

  • multifield - フラグメント作成者は個別の参照を複数作成できます。

  • fragmentreference - フラグメント作成者はフラグメントへの 1 つの参照を選択できます。

• モデルタイプ：
  複数のモデルを選択できます。コンテンツフラグメントの作成時には、これらのモデルを使用して参照先のフラグメントが既に作成されている必要があります。

• ルートパス：
  任意の参照先フラグメントのルートパスを指定します。

• フラグメントの作成を許可

  これにより、適切なモデルに基づいてフラグメント作成者が新しいフラグメントを作成できるようになります。

  • fragmentreferencecomposite - フラグメント作成者が複数のフラグメントを選択して複合フラグメントを作成できるようになります。

  

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

コンテンツフラグメントモデルの使用を完全に制御するために、設定できるステータスがあります。

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

モデルを作成して有効にすると、次が可能になります。

• 新しいコンテンツフラグメントの作成時に選択する
• コンテンツフラグメントモデル内から参照する
• GraphQL で使用する（スキーマが生成される）

次のいずれかとしてフラグ付けされたモデルを有効にするには

• ドラフト：新規（無効）
• 無効：明示的に無効化されている

「​有効化」オプションは、次のいずれかから使用します。

• 上部のツールバー（必要なモデルが選択されている場合）
• 対応するクイックアクション（必要なモデルにマウスを移動）

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

モデルを無効にすると、以下のようになります。

• このモデルは、新しい​コンテンツフラグメントを作成する際の基盤としては使用できなくなります。
• ただし、
  • GraphQLスキーマは生成され続け、クエリーも可能です（JSON APIへの影響を回避するため）。
  • モデルに基づくコンテンツフラグメントは、引き続き GraphQL エンドポイントからクエリして返すことができます。
• モデルは参照できなくなりますが、既存の参照は変更されず、引き続き GraphQL エンドポイントからクエリして返すことができます。

「有効」としてフラグ付けされたモデルを無効にするには、次のいずれかの「無効化」オプションを使用します。

• 上部のツールバー（必要なモデルが選択されている場合）
• 対応するクイックアクション（必要なモデルにマウスを移動）

アセットフォルダーでのコンテンツフラグメントモデルの許可

コンテンツのガバナンスを実装するには、アセットフォルダーに​ポリシー​を設定して、そのフォルダーでのフラグメント作成に使用可能なコンテンツフラグメントモデルを管理します。

許可されているコンテンツフラグメントモデル​に​ポリシー​を設定するには：

1. 必要なアセットフォルダーの​プロパティ​を開きます。

2. 「ポリシー」タブを開き、以下を設定します。

   • 継承元<folder>

     ポリシーは、新しい子フォルダーの作成時に自動的に継承されます。サブフォルダーで親フォルダーとは異なるモデルを許可する必要がある場合は、ポリシーを再設定（継承を解除）できます。

   • 許可されているコンテンツフラグメントモデルパス (パス別)

     複数のモデルを許可できます。

   • 許可されているコンテンツフラグメントモデルタグ (タグ別)

     複数のモデルを許可できます。
     

3. 変更内容を​保存​します。

フォルダーに対して許可されるコンテンツフラグメントモデルは、次の順序で解決されます。

• 許可されているコンテンツフラグメントモデル​の​ポリシー。
• 空の場合は、継承ルールを使用してポリシーの決定を試みます。
• 継承チェーンを使用しても結果が得られない場合は、そのフォルダーの Cloud Services 設定を調べます（最初は直接、次に継承を使用して調べます）。
• 上記のいずれでも結果が得られない場合、そのフォルダーに許可されるモデルはありません。

コンテンツフラグメントモデルの削除

コンテンツフラグメントモデルを削除するには：

1. ツール／アセット​に移動し、コンテンツフラグメントモデル​を開きます。

2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

3. モデルを選択し、次にツールバーの「削除」を選択します。

   メモ

   モデルが参照されている場合は、警告が表示されます。適切に対処します。

コンテンツフラグメントモデルの公開

コンテンツフラグメントモデルは、依存するコンテンツフラグメントの公開時または公開前に公開する必要があります。

コンテンツフラグメントモデルを公開するには：

1. ツール／アセット​に移動し、コンテンツフラグメントモデル​を開きます。

2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

3. モデルを選択し、次にツールバーの「公開」を選択します。公開ステータスがコンソールに示されます。

   メモ

   まだ公開されていないモデルのコンテンツフラグメントを公開すると、選択リストにそのことが示され、モデルがフラグメントと共に公開されます。

コンテンツフラグメントモデルを非公開にする

コンテンツフラグメントモデルがフラグメントによって参照されていない場合は、そのモデルを非公開にできます。

コンテンツフラグメントモデルを非公開するには、いずれかをおこないます。

1. ツール／アセット​に移動し、コンテンツフラグメントモデル​を開きます。

2. コンテンツフラグメントモデルが含まれているフォルダーに移動します。

3. モデルを選択し、次にツールバーの「非公開」を選択します。公開ステータスがコンソールに示されます。

コンテンツフラグメントモデル — プロパティ

コンテンツフラグメントモデルの​プロパティ​を編集できます。

• 基本
  • モデルタイトル
  • タグ
  • 説明
  • 画像をアップロード