コンテンツフラグメントの操作

Adobe Experience Manager（AEM）コンテンツフラグメントを使用すると、ページに依存しないコンテンツの設計、作成、キュレーション、公開が可能になります。複数の場所、複数のチャネル上で使用可能なコンテンツを用意できるようになります。

コンテンツフラグメントは、AEM コアコンポーネントの Sling Model（JSON）書き出し機能を使用して、JSON 形式で配信することもできます。この形式の配信では次のことが可能です。

• コンポーネントを使用して、配信するフラグメントの要素を管理できます。
• API 配信に使用されるページで複数のコンテンツフラグメントコアコンポーネントを追加して、一括配信できます。

以降のページでは、次のような、コンテンツフラグメントを作成、構成、管理するためのタスクについて説明します。

• コンテンツフラグメントの管理 - コンテンツフラグメントを作成し、編集、公開、参照します。
• コンテンツフラグメントモデル - モデルを有効化、作成および定義します。
• バリエーション - フラグメントコンテンツのオーサリング - フラグメントコンテンツをオーサリングし、マスターのバリエーションを作成します。
• Markdown - フラグメントに Markdown 構文を使用します。
• 関連コンテンツの使用 - 関連コンテンツを追加します。
• メタデータ - フラグメントのプロパティ - フラグメントのプロパティを表示および編集します。

通信チャネルの数は年々増加しています。通常、チャネルとは配信メカニズムのことであり、次のどちらも指します。

• 物理チャネル（デスクトップ、モバイルなど）
• 物理チャネルでの配信方法（デスクトップ用の「製品詳細ページ」や「製品カテゴリページ」、モバイル用の「モバイル Web」や「モバイルアプリ」など）

しかしながら、すべてのチャネルでのまったく同じコンテンツの使用はお勧めしません。特定のチャネルに合わせてコンテンツを最適化する必要があります。

コンテンツフラグメントを使用すると、次のことが可能になります。

• 複数のチャネルでいかにターゲットオーディエンスに効率よく伝えるかを考慮する。
• チャネルに依存しない編集コンテンツを作成、管理する
• 多様なチャネル向けのコンテンツプールを構築する。
• 特定のチャネル向けにコンテンツのバリエーションをデザインする。
• アセットを挿入することでテキストに画像を追加する（混在メディアフラグメント）

さらにこうしたコンテンツフラグメントを集めて組み立てることで、多様なチャネルにエクスペリエンスを提供できます。

コンテンツフラグメントとコンテンツサービス

AEM コンテンツサービスは、Web ページだけに焦点を置かずに AEM のコンテンツの記述と配信を一般化するように設計されています。

AEM コンテンツサービスにより、あらゆるクライアントで使用できる標準化された方法で、従来の AEM Web ページとは異なるチャネルにコンテンツを配信できます。そうしたチャネルの例を次に示します。

• 単一ページアプリケーション
• ネイティブモバイルアプリケーション
• AEM の外部の他のチャネルおよびタッチポイント

配信は JSON 形式でおこなわれます。

AEM コンテンツフラグメントを使用して構造化コンテンツを記述し、管理できます。構造化コンテンツは、テキスト、数値データ、ブール値、日付と時刻など、様々なコンテンツタイプを含めることができるモデルを使用して定義します。

AEM コアコンポーネントの JSON 書き出し機能と共にこの構造化コンテンツを使用して、AEM コンテンツを AEM ページ以外のチャネルに配信できます。

コンテンツフラグメントのタイプ

コンテンツフラグメントは次のどちらかになります。

• 単純なフラグメント。
  事前定義済みの構造がありません。テキストと画像のみが含まれています。これらは単純なフラグメントテンプレートに基づいています。

• 構造化コンテンツが含まれるフラグメント。
  作成されるフラグメントの構造を事前定義するコンテンツフラグメントモデルに基づいています。JSON エクスポーターを使用したコンテンツサービスの実現にも使用できます。

コンテンツタイプ

コンテンツフラグメントとは、次のようなものです。

• Assets として格納されます。

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

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

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

コンテンツフラグメントは、次のようなコンテンツ構造です。

• レイアウトやデザインを伴いません（リッチテキストモードでは多少のテキストの書式設定が可能です）。

• 1 つ以上の構成要素を含みます。

• 画像を含めたり、関連付けたりすることができます。

• ページで参照される場合、中間コンテンツを使用できます。

• 配信メカニズム（ページやチャネル）に依存しません。

ビジュアルアセットを含むフラグメント

作成者がより柔軟にコンテンツをコントロールできるように、画像をコンテンツフラグメントに追加したり、コンテンツフラグメントと統合したりできます。

アセットとコンテンツフラグメントの組み合わせには、様々な使用法があります。どの方法にもそれぞれの利点があります。

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

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

  コンテンツフラグメント自体に挿入したビジュアルアセットは、前の段落に添付されます。このコンテンツフラグメントをページに追加した場合、ビジュアルアセットは、中間コンテンツが追加されたタイミングで前の段落との関連で移動します。

• 関連コンテンツ

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

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

  • アセットの選択には、完全な柔軟性があります。
  • 位置決めには、ある程度の柔軟性があります。
  • 特定のフラグメント向けに承認されるという概念は提供しません。
  • 詳細については、Assets ブラウザーを参照してください。

コンテンツフラグメントの構成要素

コンテンツフラグメントアセットは、（直接的または間接的に）次の構成要素からなります。

• フラグメントの要素

  • 要素は、コンテンツを含むデータフィールドと相関関係にあります。

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

  • 単純なフラグメントの場合：

    • コンテンツは、1 つ以上の複数行テキストフィールドまたは要素に含まれます。
    • 要素はフラグメントテンプレートで定義されます（フラグメントのオーサリング時には定義できません。コンテンツフラグメントテンプレートを参照してください）。

• フラグメントの段落

  • 次のようなテキストブロックです。

    • 縦方向のスペース（キャリッジリターン）で区切られます。
    • 複数行テキスト要素内にあります。単純なフラグメントまたは構造化フラグメント内にあります。

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

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

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

  • アセット（画像）が実際のフラグメントに挿入され、フラグメントの内部コンテンツとして使用されます。
  • フラグメントの段落システムに埋め込まれます。
  • フラグメントをページ上で使用または参照するときに書式設定できます。
  • フラグメントへの追加、フラグメントからの削除、フラグメント内での移動は、フラグメントエディターのみでおこなえます。これらのアクションは、ページエディターではおこなえません。
  • フラグメントへの追加、フラグメントからの削除、フラグメント内での移動は、フラグメントエディターのみで、リッチテキストフォーマットを使用しておこなえます。
  • 複数行テキスト要素（任意のフラグメントタイプ）にのみ追加できます。
  • 前のテキスト（段落）に添付されます。
  注意

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

  メモ

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

• 関連コンテンツ

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

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

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

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

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

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

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

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

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

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

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

  メタデータ処理プロファイルは、コンテンツフラグメントには適用されません。

• マスター

  • フラグメントの不可欠な構成要素。

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

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

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

• バリエーション

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

コンテンツフラグメントを使用したページのオーサリング時の中間コンテンツ

中間コンテンツの特徴は次のとおりです。

• コンテンツフラグメントを操作するときにページエディターで使用できます。
• ページ上で使用または参照されたことのあるフラグメントのフローの中に追加する、追加のコンテンツです。
• 中間コンテンツは、1 つの要素のみが表示される任意のフラグメントに追加できます。
• 該当するブラウザーで使用できるアセットやコンポーネントと同様に、関連コンテンツを使用できます。

フラグメントを利用するための要件

コンテンツフラグメントを作成、編集、使用するためには、次のものが必要です。

• コンテンツモデル

  • 有効化されてから、ツールを使用して作成されます。
  • 構造化フラグメントを作成するために必要です。
  • フラグメントの構造（タイトル、コンテンツ要素、タグ定義）を定義します。
  • コンテンツモデル定義にはタイトルと 1 つのデータ要素が必要です。その他すべてはオプションです。モデルによって、フラグメントおよびデフォルトコンテンツ（該当する場合）の最小範囲が定義されます。作成者は、フラグメントコンテンツのオーサリング時に、定義された構造を変更することはできません。

• フラグメントのテンプレート

  • 単純なフラグメントを作成するために必要です。
  • 通常、プロジェクトの実装時に開発されます。オーサリング時には作成できません。
  • 単純なフラグメントの基本プロパティ（タイトル、テキスト要素の数、タグ定義）を定義します。
  • テンプレート定義にはタイトルと 1 つのテキスト要素が必要です。その他すべてはオプションです。テンプレートによって、フラグメントおよびデフォルトコンテンツ（該当する場合）の最小範囲が定義されます。作成者は後から、テンプレートに定義されている内容を超えてフラグメントを拡張できます。

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

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

使用例

フラグメントと、その要素およびバリエーションを一緒に使用して、複数のチャネルに対応する明解なコンテンツを作成できます。フラグメントを設計するときは、何をどこで使用するかを考慮する必要があります。

We.Retail サンプル

フラグメントのサンプルを次の場所で確認できます。

https://localhost:4502/assets.html/content/dam/we-retail/en/experiences/arctic-surfing-in-lofoten