AEM 6.4의 사이트 저장소 재구성

상위 AEM 6.4 페이지의 저장소 재구성 페이지에 설명된 대로 AEM 6.4로 업그레이드하는 고객은 이 페이지를 사용하여 AEM Sites 솔루션에 영향을 주는 저장소 변경과 관련된 작업 노력을 평가해야 합니다. 일부 변경 사항은 AEM 6.4 업그레이드 프로세스 중에 작업해야 하는 반면, 다른 변경 사항은 6.5 업그레이드 때까지 연기될 수 있습니다.

6.4 업그레이드 포함

6.5 이전 업그레이드

6.4 업그레이드 시

ContextHub 선분

이전 위치 /etc/segmentation/contexthub
새 위치

/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 디버거 UI를 통해 실행할 수 있습니다. 이것은 탐색 쿼리이므로 프로덕션에서 실행하지 말고 필요에 따라 트래픽 제한을 조정하십시오.

메모

ContextHub 세그먼트가 이전 위치에 지속되면 AEM > Personalization > Audiences에 읽기 전용으로 표시됩니다.

ContextHub 세그먼트를 AEM에서 편집할 수 있으려면 새 위치(/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로 변환하는 것이 좋습니다.

6.5 이전 업그레이드

Adobe Analytics 클라이언트 라이브러리

이전 위치

/etc/clientlibs/foundation/sitecatalyst

새 위치 /libs/cq/analytics/clientlibs/analytics
구조 조정 지침

이러한 클라이언트 라이브러리를 사용자 정의할 때 사용하는 모든 사용자 지정 사용은 경로 대신 범주별로 클라이언트 라이브러리를 참조해야 합니다.

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

클래식 Microsoft Word에서 웹 페이지 디자인

이전 위치 /etc/designs/wordDesign
새 위치

/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 밖으로 이동하지 마십시오.
메모 N/A

모바일 장치 에뮬레이터 구성

이전 위치

/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

다중 사이트 관리자 블루프린트 구성

이전 위치 /etc/blueprints
새 위치

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

/libs/msm (화면, 상거래에 대한 기본 블루프린트 구성)

구조 조정 지침

새로운 사이트 관리자 블루프린트 구성을 수정하거나 새로 만든 사람은 모두 새 위치(/apps)로 마이그레이션해야 합니다.

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

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

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

다중 사이트 관리자 롤아웃 구성

이전 위치

/etc/msm/rolloutConfigs

새 위치

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

구조 조정 지침

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

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

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

메모 이전 위치에서 마이그레이션된 다중 사이트 관리자 롤아웃 구성을 제거하지 않으면 AEM 작성자에게 중복된 롤아웃 옵션이 표시됩니다.

페이지 이벤트 알림 이메일 템플릿

이전 위치

/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. 이전 위치에서 마이그레이션된 페이지 이벤트 알림 이메일 템플릿을 제거합니다.

페이지 스캐폴딩

이전 위치 /etc/scaffolding
새 위치

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

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

구조 조정 지침 이전 위치 아래에 만들어진 스캐폴딩은 기존 스캐폴딩 프레임워크를 사용하며 새 위치로 마이그레이션할 수 없습니다. 새 위치에 정렬하려면 지원되는 Scaffolding 프레임워크를 사용하여 기존 Scaffolding을 다시 개발해야 합니다.
메모 해당 없음

반응형 격자 LESS

이전 위치 /etc/clientlibs/wcm/foundation/grid/grid_base.less
새 위치 /libs/wcm/foundation/clientlibs/grid/grid_base.less
구조 조정 지침

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

  • 이전 위치에서 grid_base.less를 참조하는 모든 참조 사용자 지정 LESS 파일을 업데이트하여 새 위치를 참조합니다.
메모 기존 파일이 아닌 grid_base.less 파일을 참조하면 페이지 및 템플릿 편집기의 레이아웃 모드가 작동하지 않고 페이지 레이아웃이 중단됩니다.

정적 템플릿 디자인

이전 위치 /etc/designs/<custom-site>
새 위치 /apps/settings/wcm/designs/<custom-site>
구조 조정 지침

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

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

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

  • 작성 가능한 디자인을 /etc 밖으로 이동하지 마십시오.
메모 권장 방법은 디자인 대신 구조 컨텐츠 및 정책을 사용하는 편집 가능한 템플릿을 사용하여 AEM Sites 및 페이지를 만드는 것입니다.

Adobe 검색 및 홍보 통합 클라이언트 라이브러리

이전 위치

/etc/clientlibs/foundation/searchpromote

새 위치 /libs/cq/searchpromote/clientlibs/searchpromote
구조 조정 지침

이러한 클라이언트 라이브러리를 사용자 정의할 때 사용하는 모든 사용자 정의 사용은 경로가 아니라 범주별로 클라이언트 라이브러리를 참조해야 합니다.

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

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

클라이언트 라이브러리 범주를 얻으려면 CRXDELite를 통해 각 cq:ClientLibraryFolder 노드를 방문하여 categories 속성을 검사합니다.

  • /libs/cq/searchpromote/clientlibs/searchpromote

Adobe Target 통합 클라이언트 라이브러리

이전 위치

/etc/clientlibs/foundation/target

새 위치 /libs/cq/testandtarget/clientlibs/testandtarget
구조 조정 지침

이러한 클라이언트 라이브러리를 사용자 정의할 때 사용하는 모든 사용자 정의 사용은 경로가 아니라 범주별로 클라이언트 라이브러리를 참조해야 합니다.

  1. 이전 위치의 경로별로 클라이언트 라이브러리에 대한 모든 참조는 프레임워크을 참조하는 AEM 클라이언트 라이브러리를 사용하도록 업데이트해야 합니다.
  2. AEM Client Library referencing framework를 사용할 수 없는 경우 클라이언트 라이브러리의 절대 경로를 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:ClientLibraryFolder 노드를 방문하여 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

WCM Foundation 클라이언트 라이브러리

이전 위치

/etc/clientlibs/wcm/foundation

새 위치 /libs/wcm/foundation/clientlibs
구조 조정 지침

이러한 클라이언트 라이브러리를 사용자 정의할 때 사용하는 모든 사용자 정의 사용은 경로가 아니라 범주별로 클라이언트 라이브러리를 참조해야 합니다.

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

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now