現在表示中:

コンテンツフラグメントは、標準アセットを拡張します。

アーキテクチャ

コンテンツフラグメントの基本的な構成要素は次のとおりです。

  • コンテンツフラグメント
  • コンテンツフラグメントを構成する 1 つ以上のコンテンツ要素
  • (場合によっては)1 つ以上のコンテンツバリエーション

フラグメントのタイプによって、モデルまたはテンプレートも使用します。

警告:

コンテンツフラグメントモデルは、すべてのフラグメント作成で使用することが推奨されています。

コンテンツフラグメントモデルは、We.Retail のすべてのサンプルでも使用されています。

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

    • 構造化コンテンツを含むコンテンツフラグメントの定義に使用します。
    • コンテンツフラグメントモデルでは、コンテンツフラグメントの作成時にその構造を定義します。
    • フラグメントはモデルを参照するので、モデルに対する変更は、そのモデルに関連付けられているフラグメントにも影響します。
    • モデルはデータタイプで構成されています。
    • 新しいバリエーションを追加するときなどは、それに合わせてフラグメントを更新する必要があります。

    警告:

    既存のコンテンツフラグメントモデルに変更を加えると、そのモデルに関連付けられているフラグメントに影響が生じる場合があり、対象のフラグメントで孤立プロパティが生まれることもあります。

  • コンテンツフラグメントテンプレート:

    • シンプルなコンテンツフラグメントの定義に使用します。
    • テンプレートでは、コンテンツフラグメントの作成時にその構造(基本的なテキストのみ)を定義します。
    • テンプレートは作成時にフラグメントにコピーされるので、それ以降にテンプレートに変更を加えても、既存のフラグメントには反映されません。
    • 新しいバリエーションを追加するときなどは、それに合わせてフラグメントを更新する必要があります。
    • コンテンツフラグメントテンプレートは、AEM エコシステム内の他のテンプレートメカニズム(ページテンプレートなど)とは異なる方法で機能します。そのため、分けて考える必要があります。
    • テンプレートを基にした場合、コンテンツの MIME タイプは実際のコンテンツに基づいて管理されます。つまり、要素およびバリエーションごとに MIME タイプが異なる場合もあります。

AEM Assets との統合

コンテンツフラグメント管理(CFM)は、次の理由から AEM Assets の一部と考えられます。

  • コンテンツフラグメントはアセットである。
  • 既存の AEM Assets 機能を使用する。
  • AEM Assets に完全に統合されている(管理コンソールなど)。

構造化コンテンツフラグメントのアセットへのマッピング

fragment-to-assets-structured

コンテンツフラグメントモデルがベースの構造化コンテンツフラグメントは、単一のアセットにマッピングされます。

  • すべてのコンテンツはアセットの jcr:content/data ノードに格納されます。
    • 要素データは次のマスターサブノードに格納されます。
      jcr:content/data/master
    • バリエーションは、そのバリエーション名のサブノードに格納されます。
      例:jcr:content/data/myvariation
    • 各要素のデータは、その要素名のプロパティとしてそれぞれのサブノードに格納されます。
      例えば text 要素のコンテンツは、text プロパティとして jcr:content/data/master に格納されます。
  • メタデータと関連コンテンツは、jcr:content/metadata に格納されます。
    ただし、タイトルと説明は従来のメタデータと見なされないので、jcr:content に格納されます。

シンプルなコンテンツフラグメントのアセットへのマッピング

chlimage_1

テンプレートがベースのシンプルなコンテンツフラグメントは、メインアセットとサブアセット(オプション)の複合にマッピングされます。

  • フラグメントのコンテンツ以外の情報(タイトル、説明、メタデータ、構造など)はすべて、メインアセットでのみ管理されます。
  • フラグメントの最初の要素のコンテンツは、メインアセットのオリジナルレンディションにマッピングされます。
    • 最初の要素のバリエーション(存在する場合)は、メインアセットのその他のレンディションにマッピングされます。
  • 追加要素(存在する場合)は、メインアセットのサブアセットにマッピングされます。
    • これらの追加要素のメインコンテンツは、それぞれのサブアセットのオリジナルレンディションにマッピングされます。
    • すべての追加要素のその他のバリエーション(該当する場合)は、それぞれのサブアセットのその他のレンディションにマッピングされます。

アセットの場所

標準アセットの場合、コンテンツフラグメントは次の場所に保持されます。

/content/dam

機能の統合

  • コンテンツフラグメント管理(CFM)機能は、Assets のコアを基盤として構築されていますが、できる限り独立させる必要があります。
  • CFM は、カード/列/リスト表示の項目に独自の実装を提供します。つまり、それらの項目が、既存のアセットコンテンツのレンダリング実装に挿入されます。
  • コンテンツフラグメントに対応するために、いくつかのアセットコンポーネントが拡張されています。

ページでのコンテンツフラグメントの使用

警告:

コンテンツフラグメントコアコンポーネントが推奨されます。詳しくは、コアコンポーネントの開発を参照してください。

コンテンツフラグメントは、その他のアセットタイプと同様に、AEM ページから参照できます。AEM では、コンテンツフラグメントコアコンポーネントを利用できます。これは、コンテンツフラグメントをページ上に含めることができるコンポーネントです。このコンテンツフラグメントコアコンポーネントを拡張することもできます。

  • このコンポーネントは、fragmentPath プロパティを使用して、実際のコンテンツフラグメントを参照します。fragmentPath プロパティは、その他のアセットタイプの類似プロパティと同じ方法で処理されます。例えば、コンテンツフラグメントが別の場所に移動された場合などです。
  • このコンポーネントを使用して、表示するバリエーションを選択できます。
  • さらに、一定範囲の段落を選択して、出力を制限できます。例えば、複数列の出力に利用できます。
  • このコンポーネントは、中間コンテンツを許可します。
    • ここで、このコンポーネントを使用して、他のアセット(画像など)を参照されているフラグメントの段落の中間に配置できます。
    • 中間コンテンツの場合は、次のことを実行する必要があります。
      • 参照が不安定になる可能性に注意します。中間コンテンツ(ページのオーサリング時に追加)とその横にある段落の関係は、固定されていません。(コンテンツフラグメントエディター内で)中間コンテンツの位置の前に新しい段落を挿入すると、相対的な位置が失われることがあります。
      • 検索結果における偽陽性を回避するために、パラメーター(類似バリエーションや段落フィルターなど)の追加を検討します。

注意:

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

ページ上でコンテンツフラグメントモデルを基にしたコンテンツフラグメントを使用している場合は、そのモデルが参照されます。そのため、ページ公開時にモデルが公開されていない場合は、フラグが付けられ、リソースに追加されているモデルがページとともに公開されます。

コンテンツフラグメントテンプレート:

ページ上でコンテンツフラグメントテンプレートを基にしたコンテンツフラグメントを使用している場合は、フラグメントの作成時にテンプレートがコピーされるので、参照はおこなわれません。

OSGi コンソールを使用した設定

コンテンツフラグメントのバックエンド実装は、ページ上で使用されるフラグメントのインスタンスを検索可能にしたり、複合メディアコンテンツを管理したりする役割を担います。この実装では、フラグメントのレンダリングに使用されるコンポーネントと、レンダリングがパラメーター化される方法を把握する必要があります。

このパラメーターは、Web コンソールで設定できます(OSGi バンドルの DAM コンテンツフラグメント設定)。

  • Resource types
    sling:resourceTypes のリストを使用して、コンテンツフラグメントのレンダリングに使用するコンポーネントと、バックグラウンド処理を適用する場所を定義できます。
  • Reference Properties
    プロパティのリストを設定し、それぞれのコンポーネントに対応するフラグメントの参照を格納する場所を指定できます。

注意:

プロパティとコンポーネントタイプ間に直接的なマッピングはありません。

AEM では、段落内で最初に検出されたプロパティを利用します。そのため、プロパティは慎重に選択する必要があります。

osgi-config

次のガイドラインに沿って、コンポーネントがコンテンツフラグメントのバックグラウンド処理に対応できるようにする必要があります。

  • レンダリングされる要素を定義するプロパティの名前は、element または elementNames にする必要があります。
  • レンダリングされるバリエーションが定義するプロパティの名前は、variation または variationName にする必要があります。
  • elementNames を使用して複数の要素を指定することで、複数の要素の出力をサポートする場合は、実際の表示モードは、次のように displayMode プロパティによって定義されます。
    • 値が singleText で、設定されている要素が 1 つのみの場合は、要素はテキストとしてレンダリングされ、中間コンテンツやレイアウトがサポートされます。レンダリングされる要素が 1 つのみのフラグメントでは、これがデフォルトです。
    • それ以外の場合は、よりシンプルな「フォーム表示」と呼ばれる方法が使用されます。この方法では中間コンテンツがサポートされず、フラグメントコンテンツが「そのまま」表示されます。
  • displayModesingleText(暗黙的または明示的)でフラグメントがレンダリングされる場合は、次のプロパティも関与します。
    • paragraphScope では、すべての段落をレンダリングするか、特定の範囲の段落のみをレンダリングするかを定義します(値は all または  range)。
    • paragraphScoperange の場合は、paragraphRange プロパティによってレンダリングする段落の範囲を定義します。

その他のフレームワークとの統合

コンテンツフラグメントは、次のフレームワークと統合できます。

  • 翻訳

    コンテンツフラグメントは、AEM の翻訳ワークフローと完全に統合されています。つまり、アーキテクチャレベルでは以下を意味します。

    • コンテンツフラグメントの個々の翻訳は、実際には別々のフラグメントです。例えば、以下のようになります。
      • 翻訳は、次のように異なる言語のルートの下に配置されます。
            /content/dam/<path/en/<to>/<fragment>

            /content/dam/<path>/de/<to>/<fragment>
      • しかし、言語ルートの下では、次のようにまったく同じ相対パスを共有します。
            /content/dam/<path>/en/<to>/<fragment>

            /content/dam/<path>/de/<to>/<fragment>
    • ルールベースのパスを除き、コンテンツフラグメントの様々な言語バージョンの間にそれ以上のつながりはありません。UI には言語バリアント間を移動する手段が用意されていますが、それらは 2 つの別々のフラグメントとして扱われます。

    注意:

    AEM 翻訳ワークフローでは、/content が使用されます。

    • コンテンツフラグメントモデルは /conf 内に配置されるので、これらの翻訳には含まれません。UI 文字列を国際化できます。
    • テンプレートをコピーしてフラグメントを作成するので、これは暗黙的になります。

  • メタデータのスキーマ

    • コンテンツフラグメントは、メタデータのスキーマを(再)利用します。メタデータのスキーマは、標準アセットを使用して定義できます。
    • CFM は、次の固有スキーマを提供します。
      /libs/dam/content/schemaeditors/forms/contentfragment
      このスキーマは、必要に応じて拡張できます。
    • 各スキーマフォームは、フラグメントエディターと統合されています。

コンテンツフラグメント管理 API - サーバー側

サーバー側 API を使用して、コンテンツフラグメントにアクセスできます。以下を参照してください。

com.adobe.cq.dam.cfm

警告:

コンテンツ構造に直接アクセスする代わりに、サーバー側 API を使用することを強くお勧めします。

主要インターフェイス

次の 3 つのインターフェイスが、入口の役割を果たします。

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

    新しいフラグメントを作成する場合は、FragmentTemplate.createFragment() を使用します。

    Resource templateOrModelRsc = resourceResolver.getResource("...");
    FragmentTemplate tpl = templateOrModelRsc.adaptTo(FragmentTemplate.class);
    ContentFragment newFragment = tpl.createFragment(parentRsc, "A fragment name", "A fragment description.");
    

    このインターフェイスは次を表します。

    • コンテンツフラグメントの作成元がコンテンツフラグメントモデルなのか、コンテンツフラグメントテンプレートなのか。
    • (作成後の)そのフラグメントの構造に関する情報。

    この情報の例は次のとおりです。

    • 基本データ(タイトル、説明)にアクセスする
    • フラグメントの要素のテンプレート/モデルにアクセスする
      • 要素テンプレートを一覧表示する
      • 特定の要素の構造に関する情報を取得する
      • 要素テンプレートにアクセスする(ElementTemplate を参照)
    • フラグメントのバリエーションのテンプレートにアクセスする
      • バリエーションテンプレートを一覧表示する
      • 特定のバリエーションの構造に関する情報を取得する
      • バリエーションテンプレートにアクセスする(VariationTemplate を参照)
    • 初期関連コンテンツを取得する

    重要な情報を表すインターフェイスには、次のものがあります。

    • ElementTemplate
      • 基本データ(名前、タイトル)を取得する
      • 初期要素コンテンツを取得する
    • VariationTemplate
      • 基本データ(名前、タイトル、説明)を取得する
  • コンテンツフラグメントContentFragment

    このインターフェイスでは、コンテンツフラグメントを抽象化して使用できます。 

    警告:

    このインターフェイスを使用してフラグメントにアクセスすることを強く推奨します。コンテンツ構造を直接変更しないでください。

    このインターフェイスでは、次のことを実行できます。

    • 基本データを管理する(名前の取得、タイトルまたは説明の取得/設定など)
    • メタデータにアクセスする
    • 要素にアクセスする
      • 要素を一覧表示する
      • 要素を名前で取得する
      • 新しい要素を作成する(注意事項を参照)
      • 要素データにアクセスする(ContentElement を参照)
    • そのフラグメントに対して定義されているバリエーションを一覧表示する
    • 新しいバリエーションをグローバルに作成する
    • 関連コンテンツを管理する
      • コレクションを一覧表示する
      • コレクションを追加する
      • コレクションを削除する
    • フラグメントのモデルまたはテンプレートにアクセスする

    フラグメントの主要要素を表すインターフェイスには、次のものがあります。

    • コンテンツ要素ContentElement
      • 基本データ(名前、タイトル、説明)を取得する
      • コンテンツを取得/設定する
      • 要素のバリエーションにアクセスする
        • バリエーションを一覧表示する
        • バリエーションを名前で取得する
        • 新しいバリエーションを作成する(注意事項を参照)
        • バリエーションを削除する(注意事項を参照)
        • バリエーションデータにアクセスする(ContentVariation を参照)
      • バリエーションを解決するためのショートカット(要素に指定されたバリエーションを使用できない場合は実装固有の追加のフォールバックロジックを適用)
    • コンテンツバリエーションContentVariation
      • 基本データ(名前、タイトル、説明)を取得する
      • コンテンツを取得/設定する
      • 最後に変更された情報に基づくシンプルな同期

    3 つのインターフェイス(ContentFragmentContentElementContentVariation)すべてによって Versionable インターフェイスを拡張し、コンテンツフラグメントに必要な次のバージョン管理機能を追加します。

    • 要素の新しいバージョンを作成する
    • 要素のバージョンを一覧表示する
    • バージョン管理されている要素の特定のバージョンのコンテンツを取得する

適応 - adaptTo() の使用

次のものを適応させることができます。

  • ContentFragment は、次のものに適応させることができます。

    • Resource - 基になる Sling リソース。基になる Resource を直接更新するには、ContentFragment オブジェクトを再構築する必要があります。
    • Asset - コンテンツフラグメントを表す DAM アセットの抽象化。Asset を直接更新するには、ContentFragment オブジェクトを再構築する必要があります。
  • ContentElement は、次のものに適応させることができます。

    • ElementTemplate - 要素の構造に関する情報にアクセスするためのものです。
  • FragmentTemplate は、次のものに適応させることができます。

    • Resource - Resource は、参照されているモデルまたはコピーされた元のテンプレートを決定します。
      • Resource を使用した変更は、FragmentTemplate に自動的に反映されません。
  • Resource は、次のものに適応させることができます。

    • ContentFragment
    • FragmentTemplate

注意事項

次のことに注意してください。

  • API は、UI がサポートする機能を提供するために実装されています。
  • API 全体は、(API JavaDoc で特に記載がない限り)変更を自動では保持しないように設計されています。したがって、各リクエストのリソースリゾルバー(または実際に使用しているリゾルバー)を必ずコミットしなければなりません。
  • 次のタスクには、追加作業が必要な場合があります。
    • 新しい要素を作成または削除しても、フラグメントテンプレートに基づくシンプルなフラグメントのデータ構造は更新されません。
    • ContentElement から新しいバリエーションを作成してもデータ構造は更新されません(ただし、ContentFragment からグローバルに新しいバリエーションを作成すると更新されます)。
    • 既存のバリエーションを削除してもデータ構造は更新されません。

コンテンツフラグメント管理 API - クライアント側

警告:

AEM 6.4 では、クライアント側 API は内部用になります。

AEM 6.4 を下位互換モードで使用している場合は、AEM 6.3 のドキュメントを参照してください。

追加情報

次のファイルを参照してください。

  • filter.xml

    コンテンツフラグメント管理のための filter.xml は、アセットのコアコンテンツパッケージと重複しないように設定されています。

編集セッション

編集セッションは、ユーザーがエディターのいずれかのページでコンテンツフラグメントを開くと開始されます。 ユーザーが「保存」または「キャンセル」を選択してエディターから移動すると、編集セッションは終了します。

要件

編集セッションの制御には、次の要件があります。

  • 複数のビュー(= HTML ページ)にまたがる可能性があるコンテンツフラグメントを編集するときは、原子性を保証する必要があります。
  • さらに、編集はトランザクション単位でおこなう必要があります。すなわち、編集セッションの終了時には、変更をコミット(保存)するか、ロールバック(キャンセル)します。
  • エッジケースを適切に処理する必要があります。例としては、ユーザーが手動で URL を入力したりグローバルナビゲーションを使用したりしてページから移動する場合などが考えられます。
  • データが失われないよう、定期的な自動保存(x 分ごと)をおこなう必要があります。
  • 2 人のユーザーが同時に 1 つのコンテンツフラグメントを編集する場合に、互いの変更を上書きしてはなりません。

プロセス

次のプロセスが含まれます。

  • セッションの開始
    • コンテンツフラグメントの新しいバージョンが作成されます。
    • 自動保存が開始されます。
    • cookie が設定されます。この cookie により、現在編集しているフラグメントと、編集セッションがオープンしていることが記録されます。
  • セッションの終了
    • 自動保存が停止されます。
    • コミットする場合:
      • 最後に変更した情報が反映されます。
      • cookie が削除されます。
    • ロールバックする場合:
      • 編集セッションの開始時に作成されたコンテンツフラグメントのバージョンが復元されます。
      • cookie が削除されます。
  • 編集
    • すべての変更(自動保存を含む)は、分離され、保護された領域ではなく、アクティブなコンテンツフラグメントに対して実行されます。
    • したがって、このような変更は、各コンテンツフラグメントを参照する AEM ページに即座に反映されます。

アクション

使用可能なアクションには次のものがあります。

  • ページの入力
    • 対応する cookie を確認して、編集セッションが既に存在するかどうかを確認します。
      • 存在する場合は、編集セッションが現在編集中のコンテンツフラグメント用に開始されたことを確認します。
        • 現在のフラグメント用の場合は、セッションを再確立します。
        • それ以外の場合は、前に編集したコンテンツフラグメント用の編集のキャンセルと、cookie の削除をおこないます(以後、編集セッションは存在しなくなります)。
      • 編集セッションが存在しない場合は、ユーザーが最初の変更をおこなうまで待機します(下記を参照)。
    • コンテンツフラグメントが既にページ上で参照されているかどうかを確認し、参照されている場合は適切な情報を表示します。
  • コンテンツ変更
    • ユーザーがコンテンツを変更し、編集セッションが存在しない場合は必ず、新しい編集セッションが作成されます(セッションの開始を参照)。
  • ページからの移動
    • 編集セッションが存在していて、変更が保持されていない場合は、コンテンツが失われる可能性があることをユーザーに通知し、ページに留まるかどうかを尋ねるモーダル確認ダイアログが表示されます。 

例:既存のコンテンツフラグメントへのアクセス

既存のコンテンツフラグメントにアクセスするには、API を表すリソースを以下に適応させます。

com.adobe.cq.dam.cfm.ContentFragment

次に例を示します。

// first, get the resource
Resource fragmentResource = resourceResolver.getResource("/content/dam/fragments/my-fragment");
// then adapt it
if (fragmentResource != null) {
    ContentFragment fragment = fragmentResource.adaptTo(ContentFragment.class);
    // the resource is now accessible through the API
} 

例:新しいコンテンツフラグメントの作成

新しいコンテンツフラグメントをプログラムによって作成するには、以下を使用する必要があります。

com.adobe.cq.dam.cfm.ContentFragmentManager#create

次に例を示します。

Resource templateOrModelRsc = resourceResolver.getResource("...");
FragmentTemplate tpl = templateOrModelRsc.adaptTo(FragmentTemplate.class);
ContentFragment newFragment = tpl.createFragment(parentRsc, "A fragment name", "A fragment description.");

例:自動保存間隔の指定

自動保存間隔(秒単位)は、設定マネージャー(ConfMgr)を使用して定義できます。

  • ノード:<conf-root>/settings/dam/cfm/jcr:content
  • プロパティ名:autoSaveInterval
  • タイプ:Long
  • デフォルト:600(10 分)。/libs/settings/dam/cfm/jcr:content で定義されています

自動保存間隔を 5 分に設定する場合は、次のようにノードにプロパティを定義する必要があります。

  • ノード:/conf/global/settings/dam/cfm/jcr:content
  • プロパティ名:autoSaveInterval
  • タイプ:Long
  • 値:300(5 分は 300 秒です)

コンテンツフラグメントテンプレート

詳しくは、コンテンツフラグメントテンプレートを参照してください。

ページオーサリング用コンポーネント

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー