コンテンツフラグメントの操作 working-with-content-fragments

作成されるフラグメントの構造を事前定義するコンテンツフラグメントモデルに基づいています。

構造の範囲は次のとおりです。

• 基本

  • 例えば、1 つの複数行テキストフィールドなどです。
  • ページオーサリングで使用する単純なコンテンツを用意するのに使用します。

• 複合

  • テキスト、数値、ブーリアン、日時などの様々なデータ型のフィールドを多数組み合わせたもの。
  • ページオーサリング用のより構造化されたコンテンツを用意するためや、アプリケーションに配信するために使用します。

• ネスト

  • 使用可能な参照データタイプを使用して、コンテンツをネストできます。
  • アプリケーションへの配信に使用される傾向があります。

Assets として格納されます。

• コンテンツフラグメント（とバリエーション）は、Assets コンソールで作成および管理できます。
• コンテンツフラグメントエディターでオーサリングおよび編集されます。

コンテンツフラグメントコンポーネント（参照コンポーネント）のページエディター内で使用されます。

• コンテンツフラグメント ​コンポーネントを使用できるのはページの作成者です。作成者は、コンテンツフラグメントコンポーネントを使用して、必要なコンテンツフラグメントを HTML または JSON 形式で参照し、配信できます。

AEM GraphQL API を使用してアクセスできます。

フラグメントに​ アセットを挿入（混在メディアフラグメント）

• フラグメントの一部になります（コンテンツフラグメントの構成要素を参照）。
• アセットの位置を定義します。
• 詳しくは、フラグメントエディターでのフラグメントへのアセットの挿入を参照してください。

関連コンテンツ

• フラグメントに接続されます。ただし、フラグメントの固定構成要素ではありません（コンテンツフラグメントの構成要素を参照してください）。
• 位置決めには、ある程度の柔軟性があります。
• ページでフラグメントを使用する場合に、（中間コンテンツのように）手軽に利用できます。
• 詳細については、関連コンテンツを参照してください。

ページエディターの Assets ブラウザー ​で利用できるアセット

• アセットの選択には、完全な柔軟性があります。
• 位置決めには、ある程度の柔軟性があります。
• 特定のフラグメント向けに承認されるという概念は提供しません。

フラグメントの要素

• 要素は、コンテンツを含むデータフィールドと相関関係にあります。
• コンテンツモデルを使用して、コンテンツフラグメントを作成します。モデルで指定された要素（フィールド）は、フラグメントの構造を定義します。このような要素（フィールド）には様々なデータタイプがあります。

フラグメントの段落

• 個々のエンティティとして区切られた、テキストのブロック（多くの場合複数行）。

• リッチテキストモードと Markdownモードでは、段落をヘッダーとして書式設定することができます。その場合、ヘッダーとその後の段落が 1 つのユニットになります。

• ページ作成中にコンテンツを制御できます。

フラグメントに挿入したアセット（混在メディアフラグメント）

• アセット（画像）が実際のフラグメントに挿入され、フラグメントの内部コンテンツとして使用されます。

• フラグメントの段落システムに埋め込まれます。

• フラグメントをページ上で使用または参照するときに書式設定できます。

• フラグメントへの追加、フラグメントからの削除、フラグメント内での移動は、フラグメントエディターのみで行えます。これらのアクションは、ページエディターでは行えません。

• フラグメントへの追加、フラグメントからの削除、フラグメント内での移動は、フラグメントエディターのリッチテキスト形式を使用してのみ行うことができます。

• 複数行テキスト要素（任意のフラグメントタイプ）にのみ追加できます。

• 前のテキスト（段落）に添付されます。

  note caution
  CAUTION
  プレーンテキスト形式に切り替えると、アセットが（誤って）フラグメントから削除されるおそれがあります。

  note note
  NOTE
  ページでフラグメントを使用する場合は、アセットを追加の（中間）コンテンツとして追加することもできます。その場合は、関連コンテンツ、または Assets ブラウザー内のアセットを使用します。

関連コンテンツ

• これはフラグメント外部のコンテンツですが、編集に関連します。通常は、画像、ビデオ、または他のフラグメントです。

• コレクション内の個々のアセットは、ページエディターでページにフラグメントを追加するときに、フラグメントと共に使用できます。つまり、コレクション内の個々のアセットは任意であり、特定のチャネルの要件に応じて使用します。

• アセットは、コレクションを介してフラグメントに関連付けます。関連付けられたコレクションを使用することで、作成者は、ページ作成時に使用するアセットを決定できます。

  • コレクションはフラグメントにデフォルトコンテンツとして関連付けることができます。または、フラグメントの作成時に作成者が関連付けることができます。
  • アセット（DAM）コレクションは、フラグメントの関連コンテンツの基礎です。

• オプションで、トラッキングしやすいように、コレクションにフラグメント自体を追加することもできます。

フラグメントのメタデータ

• アセットメタデータスキーマを使用します。

• タグは、次のことを行うときに作成できます。

  • フラグメントを作成してオーサリングするとき。

  • または、その後、次の方法でも作成できます。

    • コンソールでフラグメントの​ プロパティ ​を表示または編集することによって。
    • フラグメントエディターで​ メタデータ ​を編集することによって。

マスター

• フラグメントの一部

  • どのコンテンツフラグメントにもマスターインスタンスが 1 つあります。
  • マスターは削除できません。

• マスターには、フラグメントエディターの「バリエーション」の下でアクセスできます。

• マスター自体はバリエーションではありませんが、すべてのバリエーションの基礎となります。

バリエーション

• 編集目的に合わせたフラグメントテキストのレンディション。チャネルに関連付けることができますが必須ではありません。アドホックなローカル変更にも使用できます。
• マスター ​のコピーとして作成しますが、その後、必要に応じて編集できます。バリエーション同士にはコンテンツの重複があります。
• フラグメントのオーサリング中に定義できます。
• コンテンツコピーの分散を避けるために、フラグメントに格納されます。
• マスター側のコンテンツが更新されている場合は、バリエーションをマスターと同期できます。
• 要約することで、あらかじめ定義した長さにテキストをすばやく切り詰めることができます。
• フラグメントエディターの「バリエーション」タブにあります。

コンテンツモデル

• ](https://experienceleague.adobe.com/docs/experience-manager-65/content/assets/content-fragments/content-fragments-configuration-browser.html?lang=ja)設定ブラウザーを使用して有効化[されます。
• ツールを使用して作成されます。
• フラグメントを作成するために必要です。
• フラグメントの構造（タイトル、コンテンツ要素、タグ定義）を定義します。
• コンテンツモデル定義にはタイトルと 1 つのデータ要素が必要です。その他すべてはオプションです。
• モデルでは、デフォルトコンテンツを定義できます（該当する場合）。
• 作成者は、フラグメントコンテンツのオーサリング時に、定義された構造を変更することはできません。
• 依存コンテンツフラグメントの作成後にモデルに対して行った変更は、これらのコンテンツフラグメントに影響を与える可能性があります。

コンテンツフラグメントコンポーネント

• フラグメントを HTML 形式や JSON 形式で配信するのに役立ちます。
• ページ上でフラグメントを参照するために必要です。
• フラグメントのレイアウトと配信（チャネル）を行います。
• フラグメントは、レイアウトを定義し、一部またはすべての要素／バリエーションと関連するコンテンツを配信するために、1 つ以上の専用コンポーネントを必要とします。
• 作成時にフラグメントをページにドラッグすると、必須コンポーネントが自動的に関連付けられます。