AEM での Sling Resource Merger の使用 using-the-sling-resource-merger-in-aem

設定済み検索パスを使用するリソースの​ オーバーレイ。

リソースタイプ階層を（プロパティを通じて）使用するタッチ操作対応 UI のコンポーネントダイアログ（）のcq:dialogオーバーライドsling:resourceSuperType。

カスタマイズされた定義のコンテンツの方が、元の定義のコンテンツよりも優先されます（つまり、前者が後者を​ オーバーレイ ​または​ オーバーライド ​します）。

必要な場合には、カスタマイズされた定義に含まれるプロパティが、元の定義からマージされたコンテンツをどう使用するかを指定します。

/libs にカスタマイズの変更が加えられないようにする。

/libs からレプリケートされる構造を減らす。

Sling Resource Merger を使用するときは、/libs の構造全体をコピーすることは推奨されません。そうすると、カスタマイズ（通常は /apps）で維持される情報が多くなりすぎるからです。情報を不必要に複製すると、システムのアップグレード時に問題が発生しやすくなります。

sling:hideProperties（String または String[]）

非表示にするプロパティまたはプロパティのリストを指定します。

ワイルドカード * を指定した場合はすべて非表示になります。

sling:hideResource（Boolean）

リソースを子も含めて完全に非表示にするかを示します。

sling:hideChildren（String または String[]）

非表示にする子ノードまたは子ノードのリストが格納されます。ノードのプロパティは維持されます。

ワイルドカード * を指定した場合はすべて非表示になります。

sling:orderBefore（String）

現在のノードの直後に配置する兄弟ノードの名前が格納されます。

オーバーレイ

• サイトコンソールのナビゲーションエントリの定義（パネルに表示されるもの）は次の場所で定義されています。

  /libs/cq/core/content/nav/sites/jcr:title

• これをオーバーレイするには、次のノードを作成します。

  /apps/cq/core/content/nav/sites

  次に、必要に応じて jcr:title プロパティを更新します。

オーバーライド

• テキストコンソールのタッチ操作対応ダイアログの定義は、次の場所に定義されます。

  /libs/foundation/components/text/cq:dialog

• これをオーバーライドするには、例えば、次のノードを作成します。

  /apps/the-project/components/text/cq:dialog

プロパティの追加

/libs 定義に存在しないプロパティが /apps オーバーレイ／オーバーライドで必要になった場合に、プロパティを追加できます。

1. /apps 内に、対応するノードを作成します。
2. このノード``で新しいプロパティを作成します。

プロパティの再定義（自動作成されたプロパティ以外）

/libs で定義されているプロパティについて、/apps オーバーレイ／オーバーライドで新しい値が必要になった場合に、プロパティを再定義できます。

1. /apps 内に、対応するノードを作成します。

2. このノード（apps 以下）で対応するプロパティを作成します。

   • このプロパティには、Sling Resource Resolver 設定に基づいた優先順位が付けられます。

   • プロパティタイプの変更がサポートされています。

     /libs で使用されているものとは異なるプロパティタイプを使用する場合、その定義したプロパティタイプが使用されます。

自動作成されたプロパティの再定義

デフォルトでは、自動作成されたプロパティ（jcr:primaryType など）はオーバーレイ／オーバーライドの対象にならず、現在 /libs 以下にあるノードタイプが尊重されます。オーバーレイ／オーバーライドを適用するには、/apps でノードを再作成して、プロパティを明示的に非表示にし、再定義する必要があります。

1. /apps 以下に、必要な jcr:primaryType を持つ、対応するノードを作成します。

2. 自動作成されたプロパティに設定された値で、そのノードに sling:hideProperties プロパティを作成します。例：jcr:primaryType

   /appsで定義されるこのプロパティは、/libs 以下で定義されるプロパティより優先されるようになります。

ノードおよびその子の再定義

/libs 内に定義されているノードとその子について、/apps オーバーレイ／オーバーライドで新しい設定が必要な場合は、再定義を行います。

1. 次のアクションを組み合わせます。

   1. ノードの子の非表示（そのノードのプロパティは維持）
   2. プロパティの再定義

プロパティの非表示

/libs 内に定義されているプロパティが、/apps オーバーレイ／オーバーライドでは不要な場合に、プロパティを非表示にできます。

1. /apps 内に、対応するノードを作成します。

2. String 型または String[] 型の sling:hideProperties プロパティを作成します。これを使用して、非表示／無視するプロパティを指定します。ワイルドカードも使用できます。次に例を示します。

   • *
   • ["*"]
   • jcr:title
   • ["jcr:title", "jcr:description"]

ノードおよびその子の非表示

/libs 内に定義されているノードとその子が、/apps オーバーレイ／オーバーライドでは不要な場合に、不要なものを非表示にできます。

1. /apps 以下に、対応するノードを作成します。

2. sling:hideResource プロパティを作成します

   • 型：Boolean
   • 値：true

ノードの子の非表示（そのノードのプロパティは維持）

ノード、そのプロパティおよびその子が /libs に定義されていて、ノードとそのプロパティは /apps オーバーレイ／オーバーライドで必要であるものの、一部またはすべての子ノードは /apps オーバーレイ／オーバーライドでは不要です。

1. /apps 以下に、対応するノードを作成します。

2. sling:hideChildren プロパティを作成します。

   • 型：String[]
   • 値：非表示にする（無視する）子ノードのリスト（/libs 内に定義されているもの）

   ワイルドカード * を使用してすべての子ノードを非表示にする（無視する）ことができます。

ノードの並べ替え

ノードとその兄弟が /libs 内で定義されていて、ノードの位置を変更したい場合には、目的のノードを /apps 内のオーバーレイ／オーバーライドで再作成し、その中で、/libs 内の適切な兄弟ノードを参照して新しい位置を定義します。

• sling:orderBefore プロパティを使用します。

  1. /apps 以下に、対応するノードを作成します。

  2. sling:orderBefore プロパティを作成します。

     これは、現在のノードを配置する前の（/libs 以下にある）ノードを指定します。

     • 型：String
     • 値：<before-SiblingName>

オーバーレイ：

• 目的：検索パスに基づいてリソースをマージする。

• マウントポイント：/mnt/overlay

• 使用方法：mount point + relative path

• 例：

  • getResource('/mnt/overlay' + '<relative-path-to-resource>');

オーバーライド：

• 目的：スーパータイプに基づいてリソースをマージする。

• マウントポイント：/mnt/overide

• 使用方法：mount point + absolute path

• 例：

  • getResource('/mnt/override' + '<absolute-path-to-resource>');

オーバーレイ：

• コンソールのカスタマイズ
• ページオーサリングのカスタマイズ

オーバーライド：

• ページプロパティの設定