AEM での Sling Resource Merger の使用

目的

Sling Resource Merger は、リソースのアクセスとマージのためのサービスを提供します.次の両方に対して差分メカニズムを提供します。

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

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

Sling Resource Merger を使用すると、リソースやプロパティのオーバーレイ／オーバーライドが元のリソース／プロパティにマージされます。

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

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

AEM の目的

AEM で Sling Resource Merger を使用する目的は、次のとおりです。

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

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

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

プロパティ

リソースマージャーには次のプロパティがあります。

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

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

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

• sling:hideResource（Boolean）

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

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

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

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

• sling:orderBefore（String）

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

これらのプロパティは、対応する（元の）リソースおよびプロパティ（/libs 内）がオーバーレイ／オーバーライド（/apps 内）によってどのように使用されるかに影響します。

構造の作成

オーバーレイまたはオーバーライドを作成するには、元のノードを同じ構造で、目的の場所（通常は /apps）に再作成する必要があります。次に例を示します。

• オーバーレイ

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

    /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

これらのいずれを作成する場合も、必要な作業はスケルトン構造を再作成することだけです。構造を簡単に再作成できるように、すべての中間ノードは、タイプ nt:unstructured として作成できます（例えば、/libs の元のノードタイプを反映する必要はありません）。

上述のオーバーレイの例では、次のノードが必要になります。

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

ユースケース

これらを標準機能と組み合わせることで、次の操作が可能になります。

• プロパティの追加

  /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 overlay/override を選択します。

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

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

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

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

• ノードの並べ替え

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

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

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

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

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

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

コードからの Sling Resource Merger の呼び出し

Sling Resource Merger には 2 つのカスタムリソースプロバイダーが含まれています。1 つはオーバーレイ用、もう 1 つはオーバーライド用です。それぞれ、マウントポイントを使用して、コード内で呼び出すことができます。

• オーバーレイ：

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

  • マウントポイント：/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>');

使用例

以下に、いくつかの例を示します。

• オーバーレイ：

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

• オーバーライド：

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