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

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Developing,Content Fragments

作成対象：

Developer

CAUTION

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

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

NOTE

AEM 6.3 以前は、モデルではなくテンプレートに基づいてコンテンツフラグメントを作成していました。

コンテンツフラグメントテンプレートは現在は廃止されています。フラグメントの作成には引き続き使用できますが、代わりにコンテンツフラグメントモデルを使用することをお勧めします。フラグメントテンプレートには新機能は追加されず、今後のバージョンで削除されます。

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

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

/libs/settings/dam/cfm/templates

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

/apps/settings/dam/cfm/templates
既製のテンプレートをオーバーレイしたり、実行時に拡張／変更されないお客様固有のアプリケーションレベルのテンプレートを提供したりするための場所です。
/conf/global/settings/dam/cfm/templates
実行時に変更する必要があるお客様固有のインスタンスレベルのテンプレートを提供するための場所です。

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

CAUTION

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

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

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

必要な項目（/libs 内に存在）を、/apps の下で再作成します。
/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

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

テンプレート

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
名前	タイプ	値
`<template-name>`	`nt:unstructured`	このノードは各テンプレートのルートです。このノードは必須で、一意の名前が必要です。
`jcr:title`	`String` 必須	テンプレートのタイトル（フラグメントを作成ウィザードに表示）。
`jcr:description`	`String` オプション	テンプレートの目的を説明するテキスト（フラグメントを作成ウィザードに表示）。
`initialAssociatedContent`	`String[]` オプション	新規作成されたコンテンツフラグメントにデフォルトで関連付ける必要があるコレクションへのパスが格納された配列です。
`precreateElements`	`Boolean` 必須	`true`コンテンツフラグメントの作成時に、コンテンツフラグメントの要素（マスター要素を除く）を表すサブアセットを作成する必要がある場合は、その場で作成する場合は false に設定します。注意：現在、このパラメーターは `true` に設定する必要があります。
`version`	`Long` 必須	コンテンツ構造のバージョン。現在サポートされています。注意：現在、このパラメーターは `2` に設定する必要があります。

要素

table 0-row-3 1-row-3 html-authored

名前タイプ値

elements

nt:unstructured

必須

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

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

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

要素名

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
名前	タイプ	値
`<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` 必須	要素の初期名で、フラグメントタイプに対して一意である必要があります。

バリエーション

table 0-row-3 1-row-3 html-authored

名前タイプ値

variations

nt:unstructured

オプション

このオプションのノードには、コンテンツフラグメントの初期バリエーションの定義が格納されます。

バリエーション名

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
名前	タイプ	値
`<variation-name>`	`nt:unstructured` バリエーションノードが存在する場合は必須	初期バリエーションを定義します。バリエーションは、デフォルトでコンテンツフラグメントのすべての要素に追加されます。バリエーションは、それぞれの要素と同じ初期コンテンツを持ちます（ `defaultContent/ initialContentType` を参照してください）。
`jcr:title`	`String` 必須	バリエーションのタイトルです（フラグメントエディターの「バリエーション」タブ（左パネル）に表示）。
`jcr:desciption`	`String` オプションデフォルト：""	バリエーションを説明するテキスト（フラグメントエディターの「バリエーション」タブ（左レール）に表示されます）。

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2