AEM 6.4의 사이트 저장소 구조 변경 sites-repository-restructuring-in-aem

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

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

6.4 업그레이드

6.5 이전 업그레이드

6.4 업그레이드 with-upgrade

ContextHub 선분 contexthub-segments

이전 위치
/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 세그먼트에 대한 참조를 새 위치의 마이그레이션된 ContextHub 세그먼트로 업데이트(/apps, /conf/global, /conf/<tenant>).

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

\

\

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

\

\

를 통해 실행할 수 있습니다

AEM QueryBuilder Debugger UI

. 이것은 통과 쿼리이므로 프로덕션에 대해 실행하지 마십시오. 필요에 따라 순회 제한을 조정하십시오.

메모

이전 위치로 지속된 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로 변환하는 것이 좋습니다.

6.5 이전 업그레이드 prior-to-upgrade

Adobe Analytics 클라이언트 라이브러리 adobe-analytics-client-libraries

이전 위치
/etc/clientlibs/foundation/sitecatalyst
새 위치
/libs/cq/analytics/clientlibs/analytics
구조 조정 지침

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

  1. 이전 위치의 경로별 클라이언트 라이브러리에 대한 모든 참조는 를 사용하도록 업데이트해야 합니다 프레임워크를 참조하는 AEM 클라이언트 라이브러리.

  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
메모

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

클라이언트 라이브러리 카테고리를 가져오려면 각각 을 방문하십시오. cq:ClientLIbraryFolder 노드 아래에 나열된 상태로 남아 있는 노드 또는 CRXDELite를 통해 범주 속성을 검사합니다.

  • /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에서 웹 페이지 디자인 classic-microsoft-word-to-web-page-designs

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

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

구조 조정 지침

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

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

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

  • 작성 가능한 디자인을 외부로 이동하지 마십시오 /etc.
메모
해당 없음

모바일 장치 에뮬레이터 구성 mobile-device-emulator-configurations

이전 위치
/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

다중 사이트 관리자 블루프린트 구성 multi-site-manager-blueprint-configurations

이전 위치
/etc/blueprints
새 위치

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

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

구조 조정 지침

신규 또는 수정된 다중 사이트 관리자 블루프린트 구성은 모두 새 위치 (/apps).

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

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

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

다중 사이트 관리자 롤아웃 구성 multi-site-manager-rollout-configurations

이전 위치
/etc/msm/rolloutConfigs
새 위치

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

구조 조정 지침

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

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

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

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

페이지 이벤트 알림 이메일 템플릿 page-event-notification-e-mail-template

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

페이지 스캐폴딩 page-scaffolding

이전 위치
/etc/scaffolding
새 위치
/libs/settings/ wcm /template-types/scaffolding/scaffolding/apps/settings/ wcm /template-types/scaffolding/scaffolding
구조 조정 지침
이전 위치 아래에 작성된 스캐폴딩은 이전 스캐폴딩 프레임워크를 사용하므로 새 위치로 마이그레이션할 수 없습니다. 새 위치에 맞추려면 지원되는 Scaffolding 프레임워크를 사용하여 모든 레거시 Scaffolding을 다시 개발해야 합니다.
메모
해당 없음

응답형 격자 감소 responsive-grid-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 파일이 페이지 및 템플릿 편집기의 레이아웃 모드가 작동하지 않고 페이지 레이아웃이 중단됩니다.

정적 템플릿 디자인 static-template-designs

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

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

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

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

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

Adobe Target 통합 클라이언트 라이브러리 adobe-target-integration-client-libraries

이전 위치
/etc/clientlibs/foundation/target
새 위치
/libs/cq/testandtarget/clientlibs/testandtarget
구조 조정 지침

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

  1. 이전 위치의 경로별 클라이언트 라이브러리에 대한 모든 참조는 를 사용하도록 업데이트해야 합니다 프레임워크를 참조하는 AEM 클라이언트 라이브러리.
  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

WCM Foundation 클라이언트 라이브러리 wcm-foundation-client-libraries

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

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

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

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

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

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56