Show Menu
화제×

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

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

6.5 업그레이드 포함

ContextHub 선분

이전 위치 /etc/segmentation/contexthub
새 위치
/apps/settings/wcm/segments
/conf/settings/settings/wcm/segments
/conf/<tenant>/settings/wcm/segments
구조 조정 지침
새 또는 수정된 ContextHub 세그먼트가 AEM에서 편집되지 않고 소스 제어에서 편집하려는 경우 새 위치로 마이그레이션해야 합니다.
  1. 새 또는 수정된 ContextHub 세그먼트를 이전 위치에서 적절한 새 위치(/ apps /conf/global 또는 /conf/<tenant> )로 복사
  2. 이전 위치의 ContextHub 세그먼트에 대한 참조를 새 위치( /apps , /conf/global , /conf/<tenant> )의 마이그레이션된 ContextHub 세그먼트로 업데이트합니다.
다음 QueryBuilder 쿼리는 이전 위치에서 ContextHub 세그먼트에 대한 모든 참조를 찾습니다. AEM path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/% QueryBuilder 디버거 UI 를 통해 실행할 수 있습니다 쿼리 빌더 API . 이것은 탐색 쿼리이므로 프로덕션에 대해 실행하지 말고 필요에 따라 통과가 조정되었는지 확인하십시오.
메모
ContextHub 세그먼트가 이전 위치로 지속된 경우 AEM > 개인화 > 대상에서 읽기 전용으로 표시됩니다 .
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로 변환하는 것이 좋습니다.

업그레이드 전

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

이전 위치
/etc/clientlibs/foundation/sitecatalyst
새 위치 /libs/cq/analytics/clientlibs/analytics
구조 조정 지침
이러한 클라이언트 라이브러리의 사용자 정의 사용은 경로가 아닌 범주별로 클라이언트 라이브러리를 참조해야 합니다.
  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

클래식 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. AEM Dispatcher 규칙을 업데이트하여 /etc.clientlibs/ 프록시 서블릿을 통해 클라이언트 라이브러리 제공을 허용합니다.
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. 이전 위치에서 마이그레이션된 다중 사이트 관리자 블루프린트 구성을 제거합니다.
메모
All AEM provided Multi-site Manager Blueprint Configurations는 의 새 위치에 있습니다 /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을 다시 개발해야 합니다.
메모 N/A

반응형 격자 없음

이전 위치 /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. AEM Dispatcher 규칙을 업데이트하여 /etc.clientlibs/ 프록시 서블릿을 통해 클라이언트 라이브러리 제공을 허용합니다.
SCM에서 관리하지 않고 디자인 대화 상자를 통해 수정된 런타임 시
  • 작성 가능한 디자인을 외부로 이동하지 마십시오 /etc .
메모 디자인 대신 구조 컨텐츠 및 정책을 사용하는 편집 가능한 템플릿을 사용하여 AEM 사이트 및 페이지를 구축하는 것이 좋습니다.

Adobe Search and Promote Integration Client Libraries

이전 위치
/etc/clientlibs/foundation/searchpromote
새 위치 /libs/cq/searchpromote/clientlibs/searchpromote
구조 조정 지침
이러한 클라이언트 라이브러리의 사용자 정의 사용은 경로가 아닌 범주별로 클라이언트 라이브러리를 참조해야 합니다.
  1. 이전 위치의 경로별 클라이언트 라이브러리에 대한 모든 참조는 프레임워크를 클라이언트측 라이브러리 참조 참조하도록 업데이트해야 합니다.
  2. AEM의 클라이언트 라이브러리 참조 프레임워크를 사용할 수 없는 경우 클라이언트 라이브러리의 절대 경로를 AEM의 클라이언트 라이브러리 프록시 서블릿을 통해 참조할 수 있습니다.
  • /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. 이전 위치의 경로별 클라이언트 라이브러리에 대한 모든 참조는 프레임워크를 클라이언트측 라이브러리 참조 참조하도록 업데이트해야 합니다.
  2. AEM의 클라이언트 라이브러리 참조 프레임워크를 사용할 수 없는 경우 클라이언트 라이브러리의 절대 경로를 AEM의 클라이언트 라이브러리 프록시 서블릿을 통해 참조할 수 있습니다.
  • /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. 이전 위치의 경로별 클라이언트 라이브러리에 대한 모든 참조는 프레임워크를 클라이언트측 라이브러리 참조 참조하도록 업데이트해야 합니다.
  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