Experience League

検索を終了

Experience Cloud

Document Cloud

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

注意

一部のコンテンツフラグメント機能では、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 コンテンツは、インスタンスを次回アップグレードするとき（場合によってはホットフィックスまたは機能パックを適用したとき）に上書きされるからです。

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

/appsの下に必要な項目（例：/libsに存在する項目）を再作成します
/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` 必須	コンテンツフラグメントの要素の定義を格納するノードです。必須であり、Main要素の子ノードを少なくとも1つ含める必要がありますが、[1...n] 個です。テンプレートを使用すると、要素のサブブランチがフラグメントのモデルのサブブランチにコピーされます。 CRXDE Lite に表示される最初の要素は、自動的にメイン要素と見なされます。ノード名に意味はなく、メインアセットによって表されるという点を除き、ノード自体に特別な重要性はありません。その他の要素はサブアセットとして扱われます。

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

variations

nt:unstructured

オプション

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

バリエーション名

名前タイプ値

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

<variation-name>

nt:unstructured

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

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

バリエーションは、それぞれの要素と同じ初期コンテンツを持ちます（defaultContent/ initialContentType またはを参照してください）。

jcr:title

String

必須

バリエーションのタイトルです（フラグメントエディターの「バリエーション」タブ（左レール）に表示されます）。

jcr:desciption

String

オプション