AEM as a Cloud Service에서 Sling 리소스 병합 사용 using-the-sling-resource-merger-in-aem

검색 경로을(를) 사용하여 리소스의 오버레이 ​합니다.

리소스 유형 계층 구조(sling:resourceSuperType 속성 사용)를 사용하여 터치 사용 UI(cq:dialog)에 대한 구성 요소 대화 상자의 재정의.

사용자 지정된 정의의 콘텐츠의 우선 순위가 원래 콘텐츠의 우선 순위보다 높습니다(즉, 오버레이 또는 재정의).

필요한 경우 사용자 지정에 정의된 속성은(는) 원본에서 병합된 콘텐츠를 사용할 방법을 나타냅니다.

/libs에서 사용자 지정을 변경하지 않았는지 확인하십시오.

/libs에서 복제되는 구조를 줄이십시오.

Sling 리소스 병합을 사용하는 경우 /libs에서 전체 구조를 복사하지 않는 것이 좋습니다. 이렇게 하면 사용자 지정(일반적으로 /apps)에 너무 많은 정보가 포함될 수 있습니다. 정보를 중복하면 어떤 식으로든 시스템을 업그레이드할 때 문제가 발생할 가능성이 불필요하게 증가합니다.

sling:hideProperties( String 또는 String[])

숨길 속성 또는 속성 목록을 지정합니다.

와일드카드 *이(가) 모든 항목을 숨깁니다.

sling:hideResource( Boolean)

하위 리소스를 포함하여 리소스를 완전히 숨길지 여부를 나타냅니다.

sling:hideChildren( String 또는 String[])

숨길 하위 노드 또는 하위 노드 목록을 포함합니다. 노드의 속성은 유지됩니다.

와일드카드 *이(가) 모든 항목을 숨깁니다.

sling:orderBefore( String)

현재 노드가 앞에 배치해야 하는 형제 노드의 이름을 포함합니다.

오버레이

• 레일에 표시된 Sites 콘솔의 탐색 항목 정의는 다음과 같이 정의됩니다.

  /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. 원하는 jcr:primaryType을(를) 사용하여 /apps에 해당 노드를 만드십시오.

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>');

재정의:

• 목적: super type을 기반으로 리소스 병합

• 탑재 지점: /mnt/overide

• 사용: mount point + absolute path

• 예:

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