ドキュメントAEM 6.4開発ガイド

コンテンツフラグメントテンプレート content-fragment-templates

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer
CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.
CAUTION
一部のコンテンツフラグメント機能には、 AEM 6.4 Service Pack 2(6.4.2.0).
CAUTION
コンテンツフラグメントモデルは、すべてのフラグメント作成で使用することが推奨されています。
コンテンツフラグメントモデルは、We.Retail のすべての例で使用されます。

コンテンツフラグメントの作成時に、テンプレートが選択されます。 新しいフラグメントには、基本的な構造、要素およびバリエーションが提供されます。 コンテンツフラグメントに使用するテンプレートは、Granite 設定マネージャーに依存しています。

既製のテンプレートは次の場所に保持されます。

  • /libs/settings/dam/cfm/templates

次の場所に、サイト固有のコンテンツフラグメントテンプレートを作成できます。

  • /apps/settings/dam/cfm/templates

    既製のテンプレートをオーバーレイしたり、実行時に拡張／変更されないお客様固有のアプリケーションレベルのテンプレートを提供したりするための場所です。

  • /conf/global/settings/dam/cfm/templates

    実行時に変更する必要があるお客様固有のインスタンスレベルのテンプレートを提供するための場所です。

優先順位は（上から順に）/conf、/apps、/libs です。

CAUTION
/libs パス内の設定は​ 一切 ​変更しないでください。
/libs コンテンツは、インスタンスを次回アップグレードするとき（場合によってはホットフィックスまたは機能パックを適用したとき）に上書きされるからです。
設定およびその他の変更に推奨される方法は次のとおりです。

  1. 必要な項目（/libs内に存在）を、/appsの下で再作成します。

  2. /apps 内で変更作業を行う

テンプレートの基本構造は、次の場所に保持されます。

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

特定の構造は次のようになります。

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

ノードとプロパティの詳細を以下に示します。

  • テンプレート
名前
タイプ
値
<template-name>
nt:unstructured
このノードは、各テンプレートのルートです。 これは必須で、一意の名前を持つ必要があります。
jcr:title

String

必須

テンプレートのタイトル ( フラグメントを作成 ウィザードで )。
jcr:description

String

オプション

テンプレートの目的を説明するテキスト ( フラグメントを作成 ウィザードで )。
initialAssociatedContent

String[]

オプション

デフォルトで新しく作成されたコンテンツフラグメントに関連付ける必要があるコレクションへのパスを含む配列。
precreateElements

Boolean

必須

trueコンテンツフラグメントの作成時に、コンテンツフラグメントの要素（マスター要素を除く）を表すサブアセットを作成する必要がある場合は、その場で作成する場合は false に設定します。

注意：現在、このパラメーターは true に設定する必要があります。

version

Long

必須

コンテンツ構造のバージョン。現在サポートされている：

注意：現在、このパラメーターは 2 に設定する必要があります。

  • 要素
名前
タイプ
値
elements

nt:unstructured

必須

コンテンツフラグメントの要素の定義を含むノード。 このノードは必須で、メイン 要素の子ノードを 1 つ以上格納する必要がありますが、格納できる子ノードは [1..n] 個の子ノード。

テンプレートを使用すると、要素のサブブランチがフラグメントのモデルのサブブランチにコピーされます。

CRXDE Lite に表示される最初の要素は、自動的にメイン要素と見なされます。ノード名に意味はなく、メインアセットによって表されるという点を除き、ノード自体に特別な重要性はありません。その他の要素はサブアセットとして扱われます 。

  • 要素名
名前
タイプ
値
<element-name>
nt:unstructured
このノードは要素を定義します。 これは必須で、一意の名前を持つ必要があります。
jcr:title

String

必須

要素のタイトル（フラグメントエディターの要素セレクターに表示されます）。
defaultContent

String

オプション

デフォルト：""

要素の初期コンテンツで、precreateElements = true の場合にのみ使用されます。
initialContentType

String

オプション

デフォルト： text/html

要素の初期コンテンツタイプで、precreateElements = true の場合にのみ使用されます。現在、次のタイプがサポートされています。

  • text/html
  • text/plain
  • text/x-markdown
name

String

必須

要素の内部名。フラグメントタイプに対して一意である必要があります。
  • バリエーション
名前
タイプ
値
variations

nt:unstructured

オプション

このオプションのノードには、コンテンツフラグメントの初期バリエーションの定義が含まれます。
  • バリエーション名
名前
タイプ
値
<variation-name>

nt:unstructured

バリエーションノードが存在する場合は必須

初期バリエーションを定義します。
バリエーションは、デフォルトでコンテンツフラグメントのすべての要素に追加されます。

バリエーションは、それぞれの要素と同じ初期コンテンツを持ちます（

defaultContent/ initialContentType

を参照してください）。

jcr:title

String

必須

バリエーションのタイトル ( フラグメントエディターの バリエーション タブ（左側のレール）を使用 )。
jcr:desciption

String

オプション

デフォルト：""

バリエーションを説明するテキスト（フラグメントエディターの「バリエーション」タブ（左レール）に表示されます）。
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e