AEM 6.4에서 사이트 저장소 구조 변경

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

/conf/<tenant>/settings/wcm/segments

새 세그먼트나 수정된 ContextHub 세그먼트가 AEM에서 편집되지 않고 소스 제어에서 편집되도록 하려면 새 위치로 마이그레이션해야 합니다.

1. 이전 위치의 새 세그먼트나 수정된 ContextHub 세그먼트를 적절한 새 위치(/%3Ccode%3Eapps%3C/code%3E,%20%3Ccode%3E/conf/global%3C/code%3E%20%EB%98%90%EB%8A%94%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=ko)에 복사합니다
2. 이전 위치의 ContextHub 세그먼트에 대한 참조를 새 위치(/apps, /conf/global, /conf/<tenant>)의 마이그레이션된 ContextHub 세그먼트로 업데이트합니다.

다음 QueryBuilder 쿼리는 이전 위치의 ContextHub 세그먼트에 대한 모든 참조를 찾습니다.

path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/%

이 작업은 AEM QueryBuilder Debugger UI를 통해 실행할 수 있습니다. 이것은 통과 쿼리이므로 프로덕션에 대해 실행하지 마십시오. 필요에 따라 순회 제한을 조정하십시오.

이전 위치로 지속된 ContextHub 세그먼트는 AEM > 개인화 > 대상에 읽기 전용으로 표시됩니다.

AEM에서 ContextHub 세그먼트를 편집할 수 있는 경우 새 위치(/conf/global 또는 /conf/<tenant>)로 마이그레이션해야 합니다. AEM에서 만들어진 새 ContentHub 세그먼트 는 새 위치(/conf/global 또는 /conf/<tenant>)로 유지됩니다.

AEM Sites 페이지 속성은 이전 위치(/etc) 또는 단일 새 위치(/apps, /conf/global 또는 /conf/<tenant>)만 선택할 수 있으므로 ContextHub 세그먼트를 그에 따라 마이그레이션해야 합니다.

AEM 참조 사이트에서 사용되지 않은 모든 ContextHub 세그먼트를 제거하고 새 위치로 마이그레이션하지 않을 수 있습니다.

• /etc/segmentation/geometrixx/
• /etc/segmentation/geometrixx-outdoors

참고:ClientContext이 사용 중인 경우 ContextHub로 변환하는 것이 좋습니다.

/etc/clientlibs/foundation/sitecatalyst

이러한 클라이언트 라이브러리를 사용자 지정하는 경우 경로보다는 카테고리별로 클라이언트 라이브러리를 참조해야 합니다.

1. 이전 위치에서 경로별로 클라이언트 라이브러리에 대한 모든 참조는 프레임워크 참조를 사용하도록 업데이트해야 합니다.
2. 프레임워크를 참조하는 AEM 클라이언트 라이브러리를 사용할 수 없는 경우 AEM 클라이언트 라이브러리 프록시 서블릿을 통해 클라이언트 라이브러리의 절대 경로를 참조할 수 있습니다.
   • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/appmeasurement.js
   • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/plugins.js
   • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst.js
   • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/tracking.js
   • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/util.js

이러한 클라이언트 라이브러리의 편집은 지원되지 않습니다.

클라이언트 라이브러리 카테고리를 가져오려면 CRXDELite를 통해 각 cq:ClientLIbraryFolder 노드를 방문하여 categories 속성을 검사하십시오.

• /libs/cq/analytics/clientlibs/sitecatalyst/appmeasurement
• /libs/cq/analytics/clientlibs/sitecatalyst/plugins
• /libs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst
• /libs/cq/analytics/clientlibs/sitecatalyst/tracking
• /libs/cq/analytics/clientlibs/sitecatalyst/util

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

SCM에서 관리되고 디자인 대화 상자를 통해 런타임에 작성되지 않는 모든 디자인의 경우

1. 이전 위치에서 새 위치(/apps)로 디자인을 복사합니다.
2. 디자인의 모든 CSS, JavaScript 및 정적 리소스를 allowProxy = true를 사용하는 클라이언트 라이브러리로 변환합니다.
3. cq:designPath 속성에서 이전 위치에 대한 참조를 업데이트합니다.
4. 이전 위치를 참조하는 페이지를 업데이트하여 새 클라이언트 라이브러리 카테고리를 사용합니다(페이지 구현 코드를 업데이트해야 함).
5. /etc.clientlibs/ 프록시 서블릿을 통해 클라이언트 라이브러리 제공을 허용하도록 AEM Dispatcher 규칙을 업데이트합니다.

SCM에서 관리되지 않고 디자인 대화 상자를 통해 수정된 런타임 디자인의 경우:

• 작성자 가능 디자인을 /etc 외부로 이동하지 마십시오.

/etc/mobile

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

1. 새 모바일 장치 에뮬레이터 구성을 이전 위치에서 새 위치(/apps, /conf/global, /conf/<tenant>)로 복사합니다.
2. 이러한 모바일 장치 에뮬레이터 구성을 사용하는 모든 AEM Sites 페이지의 경우 페이지의 을 업데이트하십시오 jcr :content 노드:
   [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
3. 이러한 모바일 장치 에뮬레이터 구성을 사용하는 편집 가능한 템플릿의 경우 을 가리키며 편집 가능한 템플릿을 업데이트합니다. cq : deviceGroups 를 새 위치에 추가합니다.

모바일 장치 에뮬레이터 구성 해상도는 다음 순서로 발생합니다.

1. /conf/<tenant>/settings/mobile
2. /conf/global/settings/mobile
3. /apps/settings/mobile
4. /libs/settings/mobile
5. /etc/mobile

/apps/msm (고객 블루프린트 구성)

/libs/msm (Screens, Commerce에 대한 기본 블루프린트 구성)

새 사이트 관리자 블루프린트 구성을 만들거나 수정한 경우 새 위치(/apps)로 마이그레이션해야 합니다.

1. 새 사이트 관리자 블루프린트 구성을 이전 위치에서 새 위치(/apps)로 복사합니다.
2. 이전 위치에서 마이그레이션된 다중 사이트 관리자 블루프린트 구성을 제거합니다.

제공된 모든 AEM의 다중 사이트 관리자 블루프린트 구성이 /libs의 새 위치에 있습니다.

컨텐츠는 다중 사이트 관리자 파란색 구성을 참조하지 않으므로 조정할 컨텐츠 참조가 없습니다.

/etc/msm/rolloutConfigs

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

새 사이트 관리자 롤아웃 구성 또는 수정된 모든 새 사이트 관리자 롤아웃 구성은 새 위치로 마이그레이션해야 합니다.

1. 새 사이트 관리자 롤아웃 구성을 이전 위치에서 새 위치(/apps)로 복사합니다.
2. AEM 페이지의 참조를 이전 위치의 다중 사이트 관리자 롤아웃 구성으로 업데이트하여 새 위치(/libs 또는 /apps)의 해당 참조를 가리킵니다.

이전 위치에서 마이그레이션된 다중 사이트 관리자 롤아웃 구성을 제거합니다.

/etc/notification/email/default/com.day.cq.wcm.core.page

/libs/settings/notification-templates/com.day.cq.wcm.core.page

/apps/settings/notification-templates/com.day.cq.wcm.core.page

새 로케일을 지원하는 유일한 새 페이지 이벤트 알림 이메일 템플릿은 새 로케일을 지원합니다.

페이지 이벤트 이메일 템플릿 해상도는 다음 순서로 발생합니다.

1. /etc/notification/email/default/com.day.cq.wcm.core.page
2. /apps/settings/notification-templates/com.day.cq.wcm.core.page
3. /libs/settings/notification-templates/com.day.cq.wcm.core.page

새 페이지 이벤트 알림 이메일 템플릿 또는 수정된 모든 페이지 템플릿은 /apps 아래의 새 위치로 마이그레이션해야 합니다.

1. 새 페이지 이벤트 알림 이메일 템플릿을 이전 위치에서 새 위치(/apps)로 복사합니다.
2. 이전 위치에서 마이그레이션된 페이지 이벤트 알림 이메일 템플릿을 제거합니다.

/libs/settings/ wcm /template-types/scaffolding/scaffolding

/apps/settings/ wcm /template-types/scaffolding/scaffolding

사용자 지정 LESS 파일의 이전 위치에 대한 모든 참조는 새 위치에서 가져오도록 업데이트해야 합니다.

• 이전 위치에서 grid_base.less를 참조하는 모든 참조 사용자 지정 LESS 파일을 업데이트하여 새 위치를 참조합니다.

SCM에서 관리되고 디자인 대화 상자를 통해 런타임에 작성되지 않는 모든 디자인의 경우

1. 이전 위치에서 새 위치(/apps)로 디자인을 복사합니다.
2. 디자인의 모든 CSS, JavaScript 및 정적 리소스를 allowProxy = true를 사용하는 클라이언트 라이브러리로 변환합니다.
3. AEM > 사이트 > 사용자 지정 사이트 페이지 > 페이지 속성 > 고급 탭 > 디자인 필드를 통해 cq:designPath 속성에서 이전 위치에 대한 참조를 업데이트합니다.
4. 이전 위치를 참조하는 페이지를 업데이트하여 새 클라이언트 라이브러리 카테고리를 사용합니다(페이지 구현 코드를 업데이트해야 함).
5. /etc.clientlibs/ 프록시 서블릿을 통해 클라이언트 라이브러리 제공을 허용하도록 AEM Dispatcher 규칙을 업데이트합니다.

SCM에서 관리되지 않고 디자인 대화 상자를 통해 수정된 런타임 디자인의 경우:

• 작성자 가능 디자인을 /etc 외부로 이동하지 마십시오.

/etc/clientlibs/foundation/searchpromote

이러한 클라이언트 라이브러리를 사용자 정의한 경우 경로가 아니라 카테고리별로 클라이언트 라이브러리를 참조해야 합니다.

1. 이전 위치에서 경로별로 클라이언트 라이브러리에 대한 모든 참조는 프레임워크 참조를 사용하도록 업데이트해야 합니다.
2. 프레임워크를 참조하는 AEM Client Library를 사용할 수 없는 경우, AEM Client Library Proxy 서블릿을 통해 클라이언트 라이브러리의 절대 경로를 참조할 수 있습니다.

• /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js

이러한 클라이언트 라이브러리의 편집은 지원되지 않습니다.

클라이언트 라이브러리 카테고리를 가져오려면 CRXDELite를 통해 각 cq:ClientLIlibraryFolder 노드를 방문하여 categories 속성을 검사하십시오.

• /libs/cq/searchpromote/clientlibs/searchpromote

/etc/clientlibs/foundation/target

이러한 클라이언트 라이브러리를 사용자 정의한 경우 경로가 아니라 카테고리별로 클라이언트 라이브러리를 참조해야 합니다.

1. 이전 위치에서 경로별로 클라이언트 라이브러리에 대한 모든 참조는 프레임워크 참조를 사용하도록 업데이트해야 합니다.
2. 프레임워크를 참조하는 AEM Client Library를 사용할 수 없는 경우, AEM Client Library Proxy 서블릿을 통해 클라이언트 라이브러리의 절대 경로를 참조할 수 있습니다.

• /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/testandtarget.js
• /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs.js
• /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs-integration.js
• /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/init.js
• /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/mbox.js
• /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/parameters.js
• /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/util.js

이러한 클라이언트 라이브러리의 편집은 지원되지 않습니다.

클라이언트 라이브러리 카테고리를 가져오려면 CRXDELite를 통해 각 cq:ClientLIlibraryFolder 노드를 방문하여 categories 속성을 검사하십시오.

• /libs/cq/testandtarget/clientlibs/testandtarget/testandtarget
• /libs/cq/testandtarget/clientlibs/testandtarget/atjs
• /libs/cq/testandtarget/clientlibs/testandtarget/atjs-integration
• /libs/cq/testandtarget/clientlibs/testandtarget/init
• /libs/cq/testandtarget/clientlibs/testandtarget/mbox
• /libs/cq/testandtarget/clientlibs/testandtarget/parameters
• /libs/cq/testandtarget/clientlibs/testandtarget/util

/etc/clientlibs/wcm/foundation

이러한 클라이언트 라이브러리를 사용자 정의한 경우 경로가 아니라 카테고리별로 클라이언트 라이브러리를 참조해야 합니다.

1. 이전 위치에서 경로별로 클라이언트 라이브러리에 대한 모든 참조는 프레임워크 참조를 사용하도록 업데이트해야 합니다.
2. 프레임워크를 참조하는 AEM 클라이언트 라이브러리를 사용할 수 없는 경우 AEM 클라이언트 라이브러리 프록시 서블릿을 통해 클라이언트 라이브러리의 절대 경로를 참조할 수 있습니다.

• /etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
• /etc.clientlibs/wcm/foundation/clientlibs/main.css
• /etc.clientlibs/wcm/foundation/clientlibs/main.js

이러한 클라이언트 라이브러리의 편집은 지원되지 않습니다.

클라이언트 라이브러리 카테고리를 가져오려면 CRXDELite를 통해 각 cq:ClientLIbraryFolder 노드를 방문하여 categories 속성을 검사하십시오.

• /libs/wcm/foundation/clientlibs/accessibility
• /libs/wcm/foundation/clientlibs/main