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

注意

一部のコンテンツフラグメント機能には、AEM 6.4 Service Pack 2(6.4.2.0)のアプリケーションが必要です。

注意

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

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

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

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

  • /libs/settings/dam/cfm/templates

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

  • /apps/settings/dam/cfm/templates

    標準のテンプレートをオーバーレイする場所、または実行時に拡張/変更することを意図していない、顧客固有のアプリケーション全体のテンプレートを提供する場所。

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

    実行時に変更する必要がある、インスタンス全体の顧客固有のテンプレートの場所。

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

注意

/libs パス内の設定は​一切​変更しないでください。

/libs コンテンツは、インスタンスを次回アップグレードするとき（場合によってはホットフィックスまたは機能パックを適用したとき）に上書きされるからです。

設定およびその他の変更に推奨される方法は次のとおりです。

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

  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

required

 テンプレートのタイトル（フラグメントを作成ウィザードに表示されます）。
jcr:description

String

オプション

 テンプレートの目的を説明するテキスト（フラグメントを作成ウィザードに表示されます）。
initialAssociatedContent

String[]

オプション

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

Boolean

required

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

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

Long

必須

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

注意:現在、このパラメーターはに設定する必要があり 2ます。
  • エレメント
名前 タイプ 値
elements

nt:unstructured

必須

コンテンツフラグメントの要素の定義を格納するノードです。必須で、Main要素の子ノードを少なくとも1つ含める必要がありますが、[1...n] 個です。

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

CRXDE Lite に表示される最初の要素は、自動的にメイン要素と見なされます。ノード名に意味はなく、メインアセットによって表されるという点を除き、ノード自体に特別な重要性はありません。その他の要素はサブアセットとして扱われます。
  • エレメント名
名前 タイプ 値
<element-name> nt:unstructured このノードは要素を定義します。このノードは必須で、一意の名前が必要です。
jcr:title

String

必須

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

String

オプション

デフォルト：""

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

String

オプション

default: 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

オプション

デフォルト：""

 バリエーションを説明するテキスト（フラグメントエディターの「バリエーション」タブ（左レール）に表示されます）。

このページ