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 リソースリゾルバーの設定に基づいて優先度が決まります。

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

     /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 で定義）

   ワイルドカード&ast；を使用すると、すべての子ノードを非表示または無視できます。

ノードの並べ替え

ノードとその兄弟が /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>');

オーバーレイ：

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

オーバーライド：

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