AEM 6.5의 Sites 저장소 재구성 sites-repository-restructuring-in-aem

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

6.5 업그레이드 포함

향후 업그레이드 전

6.5 업그레이드 포함 with-upgrade

ContextHub 선분 contexthub-segments

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

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

구조 조정 지침

새 ContextHub 세그먼트 또는 수정된 ContextHub 세그먼트가 AEM에서 편집되지 않고 소스 제어에서 편집되는 경우 새 위치로 마이그레이션해야 합니다.

  1. 이전 위치에서 새 ContextHub 세그먼트 또는 수정된 ContextHub 세그먼트를 적절한 새 위치(https://experienceleague.adobe.com/%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 > 대상 에서 읽기 전용으로 표시됩니다.

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로 변환하는 것이 좋습니다.

향후 업그레이드 전 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
메모

이러한 클라이언트 라이브러리는 편집할 수 없습니다.

클라이언트 라이브러리 범주를 얻으려면 CRXDELite를 통해 각 cq:ClientLIbraryFolder 노드를 방문하여 범주 속성을 검사하십시오.

  • /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 및 정적 리소스를 allowProxy = true이(가) 있는 클라이언트 라이브러리(으)로 변환합니다.
  3. cq:designPath 속성에서 이전 위치에 대한 참조를 업데이트합니다.
  4. 새 클라이언트 라이브러리 범주를 사용하도록 이전 위치를 참조하는 페이지를 업데이트합니다(이렇게 하려면 페이지 구현 코드를 업데이트해야 함).
  5. /etc.clientlibs/ 프록시 서블릿을 통해 클라이언트 라이브러리를 제공할 수 있도록 AEM Dispatcher 규칙을 업데이트합니다.

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 Pages의 참조를 이전 위치의 다중 사이트 관리자 롤아웃 구성으로 업데이트하여 새 위치(/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/scaffoling/scaffolding/apps/settings/ wcm /template-types/scaffoling/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 및 정적 리소스를 allowProxy = true이(가) 있는 클라이언트 라이브러리(으)로 변환합니다.
  3. AEM > 사이트 > 사용자 지정 사이트 페이지 > 페이지 속성 > 고급 탭 > 디자인 필드 를 통해 cq:designPath 속성의 이전 위치에 대한 참조를 업데이트합니다.
  4. 새 클라이언트 라이브러리 범주를 사용하도록 이전 위치를 참조하는 페이지를 업데이트합니다(이렇게 하려면 페이지 구현 코드를 업데이트해야 함).
  5. /etc.clientlibs/ 프록시 서블릿을 통해 클라이언트 라이브러리를 제공할 수 있도록 AEM Dispatcher 규칙을 업데이트합니다.

SCM에서 관리되지 않는 디자인 및 디자인 대화 상자를 통해 런타임 수정을 위한 경우:

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

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

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

이러한 클라이언트 라이브러리를 사용자 지정할 때 경로가 아닌 범주별로 클라이언트 라이브러리를 참조해야 합니다.

  1. 이전 위치의 경로별 클라이언트 라이브러리에 대한 모든 참조는 AEM의 프레임워크 참조를 사용하도록 업데이트해야 합니다.
  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 노드를 방문하여 범주 속성을 검사하십시오.

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

이러한 클라이언트 라이브러리는 편집할 수 없습니다.

클라이언트 라이브러리 범주를 얻으려면 CRXDELite를 통해 각 cq:ClientLIbraryFolder 노드를 방문하여 범주 속성을 검사하십시오.

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2