AEM Reestructuración de repositorios de Sites en 6.5 sites-repository-restructuring-in-aem

Como se describe en el elemento principal AEM Reestructuración de repositorios en 6.5 AEM , los clientes que actualicen a la versión 6.5 deben utilizar esta página para evaluar el esfuerzo de trabajo asociado con los cambios del repositorio que afectan a la solución de AEM Sites. AEM Algunos cambios requieren un esfuerzo durante el proceso de actualización de la versión 6.5 de la, mientras que otros se pueden aplazar hasta una actualización futura.

Con actualización a 6.5

Antes de una actualización futura

Con actualización a 6.5 with-upgrade

Segmentos de ContextHub contexthub-segments

Ubicación anterior
/etc/segmentation/contexthub
Nueva ubicación(es)

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

Directrices de reestructuración

AEM Si algún segmento de ContextHub nuevo o modificado se edita en el control de código fuente en lugar de editarse en el control de código fuente, se debe migrar a la nueva ubicación:

  1. Copie cualquier segmento de ContextHub nuevo o modificado de la ubicación anterior a la nueva ubicación adecuada (/)apps, /conf/global o /conf/<tenant>)
  2. Actualizar referencias a segmentos de ContextHub en la ubicación anterior a segmentos de ContextHub migrados en las nuevas ubicaciones (/apps, /conf/global, /conf/<tenant>).

La siguiente consulta de QueryBuilder busca todas las referencias a segmentos de ContextHub en las ubicaciones anteriores.

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

Esto se puede ejecutar mediante AEM IU de QueryBuilder Debugger. Tenga en cuenta que se trata de una consulta de recorrido, por lo que no la ejecute en producción y asegúrese de ajustar los límites transversales según sea necesario.

Notas

Los segmentos de ContextHub que persistieron en la ubicación anterior se muestran como de solo lectura en AEM > Personalización > Audiencias.

AEM Si los segmentos de ContextHub van a poder editarse en la, deben migrarse a la nueva ubicación (/conf/global o /conf/<tenant>). AEM Cualquier nuevo segmento de segmentos de ContentHub creado en la se mantiene en la nueva ubicación (/conf/global o /conf/<tenant>).

Las propiedades de página de AEM Sites solo permiten la ubicación anterior (/etc) o una sola ubicación nueva (/apps, /conf/global o /conf/<tenant>) que se van a seleccionar, por lo que los segmentos de ContextHub deben migrarse en consecuencia.

AEM Los segmentos de ContextHub no utilizados de los sitios de referencia de la se pueden eliminar y no migrar a la nueva ubicación:

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

Nota: Si el ClientContext está en uso, se recomienda convertirlo a ContextHub.

Antes de una actualización futura prior-to-upgrade

Bibliotecas de cliente de Adobe Analytics adobe-analytics-client-libraries

Ubicación anterior
/etc/clientlibs/foundation/sitecatalyst
Nueva ubicación(es)
/libs/cq/analytics/clientlibs/analytics
Directrices de reestructuración

Cualquier uso personalizado de estas bibliotecas de cliente debe hacer referencia a la biblioteca de cliente por categoría y no por ruta:

  1. Cualquier referencia a la biblioteca de cliente por ruta en la ubicación anterior debe actualizarse para utilizar AEM Marco de referencia de la biblioteca de clientes.

  2. AEM AEM Si no se puede utilizar el marco de referencia de la biblioteca de cliente de la biblioteca de cliente, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante el servlet proxy de la biblioteca de cliente de la biblioteca de cliente de la biblioteca de cliente.

    • /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
Notas

Nunca se admitió la edición de estas bibliotecas de cliente.

Para obtener las categorías de Biblioteca de clientes, visite cada una cq:ClientLIbraryFolder a través de CRXDELite e inspeccione la propiedad 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

Diseños clásicos de Word a página web de Microsoft classic-microsoft-word-to-web-page-designs

Ubicación anterior
/etc/designs/wordDesign
Nueva ubicación(es)

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

Directrices de reestructuración

Para cualquier diseño que se administre en SCM y no se escriba en en tiempo de ejecución mediante cuadros de diálogo de diseño.

  1. Copie los diseños de la Ubicación anterior en la Ubicación nueva (/apps).
  2. Convierta cualquier recurso CSS, JavaScript y estático de Design a un Biblioteca de cliente con allowProxy = true.
  3. Actualice las referencias a la Ubicación anterior en la propiedad cq:designPath.
  4. Actualice las páginas que hagan referencia a la ubicación anterior para utilizar la nueva categoría Biblioteca de clientes (esto requiere la actualización del código de implementación de la página).
  5. AEM Actualizar las reglas de Dispatcher para permitir el servicio de bibliotecas de cliente a través de /etc.clientlibs/ servlet proxy.

Para cualquier diseño que NO se administre en SCM y que se modifique en tiempo de ejecución mediante cuadros de diálogo de diseño:

  • No saque los diseños con autor de /etc.
Notas
N/D

Configuraciones del emulador de dispositivos móviles mobile-device-emulator-configurations

Ubicación anterior
/etc/mobile
Nueva ubicación(es)

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Directrices de reestructuración

Cualquier nueva configuración del emulador de dispositivos móviles debe migrarse a la nueva ubicación.

  1. Copie cualquier nueva configuración del emulador de dispositivos móviles de la ubicación anterior a la nueva ubicación (/apps, /conf/global, /conf/<tenant>).
  2. Para cualquier página de AEM Sites que dependa de estas configuraciones del emulador de dispositivos móviles, actualice el jcr ``:content nodo:
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
  3. Para cualquier plantilla editable que dependa de estas configuraciones del emulador de dispositivos móviles, actualice las plantillas editables, señalando la opción cq : deviceGroups a la Nueva ubicación.
Notas

La resolución de las configuraciones del emulador de dispositivos móviles se produce en el siguiente orden:

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

Configuraciones del modelo de administración de varios sitios multi-site-manager-blueprint-configurations

Ubicación anterior
/etc/blueprints
Nueva ubicación(es)

/apps/msm (Configuraciones del modelo del cliente)

/libs/msm (Configuraciones de modelo listas para usar para Screens, Commerce)

Directrices de reestructuración

Cualquier configuración de modelo de Multi-site Manager nueva o modificada debe migrarse a la nueva ubicación (/apps).

  1. Copie cualquier configuración de modelo de Multi-site Manager nueva o modificada de la ubicación anterior a la nueva ubicación (/apps).
  2. Elimine cualquier configuración de modelo de Multi-site Manager migrada de la ubicación anterior.
Notas

AEM Todas las configuraciones de modelo de administración de varios sitios proporcionadas se encuentran en la nueva ubicación de /libs.

El contenido no hace referencia a las configuraciones azules del Administrador de varios sitios, por lo que no hay referencias de contenido que ajustar.

Configuraciones de despliegue del administrador de varios sitios multi-site-manager-rollout-configurations

Ubicación anterior
/etc/msm/rolloutConfigs
Nueva ubicación(es)

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Directrices de reestructuración

Cualquier configuración de despliegue del administrador de varios sitios nueva o modificada debe migrarse a la nueva ubicación.

  1. Copie cualquier configuración de lanzamiento del Administrador de varios sitios nueva o modificada de la ubicación anterior a la nueva ubicación (/apps).
  2. AEM Actualice las referencias de las páginas de la lista de direcciones a Configuraciones de despliegue del Administrador de varios sitios en la ubicación anterior para que apunten a sus equivalentes en las nuevas ubicaciones (/libs o /apps).

Quitar las configuraciones de despliegue del Administrador de varios sitios migradas de la ubicación anterior.

Notas
AEM Si no se quitan las configuraciones de despliegue del Administrador de varios sitios migradas de la ubicación anterior, se mostrarán opciones de despliegue duplicadas a los autores de la.

Plantilla de correo electrónico de notificación de eventos de página page-event-notification-e-mail-template

Ubicación anterior
/etc/notification/email/default/com.day.cq.wcm.core.page
Nueva ubicación(es)

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

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

Directrices de reestructuración

Las únicas plantillas de correo electrónico de notificación de eventos de página nuevas admitidas son las nuevas configuraciones regionales.

Evento de página La resolución de la plantilla de correo electrónico se produce en el siguiente orden:

  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
Notas

Cualquier plantilla de correo electrónico de notificación de eventos de página nueva o modificada debe migrarse a la nueva ubicación en /apps:

  1. Copie cualquier plantilla de correo electrónico de notificación de eventos de página nueva o modificada de la ubicación anterior a la nueva ubicación (/apps).
  2. Quite las plantillas de correo electrónico de notificación de eventos de página migradas de la ubicación anterior.

Andamiaje de página page-scaffolding

Ubicación anterior
/etc/scaffolding
Nueva ubicación(es)

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

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

Directrices de reestructuración
El andamiaje creado en la ubicación anterior utiliza el marco de andamiaje heredado y no se puede migrar a la nueva ubicación. Para alinearse con la Nueva ubicación, cualquier andamiaje heredado debe volver a desarrollarse utilizando el marco de andamiaje admitido.
Notas
N/D

Cuadrícula interactiva LESS responsive-grid-less

Ubicación anterior
/etc/clientlibs/wcm/foundation/grid/grid_base.less
Nueva ubicación(es)
/libs/wcm/foundation/clientlibs/grid/grid_base.less
Directrices de reestructuración

Cualquier referencia a la Ubicación anterior en los archivos personalizados LESS debe actualizarse para poder importarse desde la Nueva ubicación.

  • Actualice los archivos LESS personalizados que hagan referencia a grid_base.less en la Ubicación anterior para hacer referencia a la nueva ubicación.
Notas
Referencia a un archivo no existente grid_base.less Esto provoca que el modo Diseño del Editor de páginas y plantillas no funcione y que se interrumpa el diseño de la página.

Diseños de plantilla estática static-template-designs

Ubicación anterior
/etc/designs/<custom-site>
Nueva ubicación(es)
/apps/settings/wcm/designs/<custom-site>
Directrices de reestructuración

Para cualquier diseño que se administre en SCM y no se escriba en en tiempo de ejecución mediante cuadros de diálogo de diseño.

  1. Copie los diseños de la Ubicación anterior en la Ubicación nueva (/apps).
  2. Convierta cualquier recurso CSS, JavaScript y estático de Design a un Biblioteca de cliente con allowProxy = true.
  3. Actualice las referencias a la Ubicación anterior en la cq:designPath propiedad mediante AEM > Sitios > Páginas de sitio personalizadas > Propiedades de página > Pestaña Avanzadas > Campo de diseño.
  4. Actualice las páginas que hagan referencia a la ubicación anterior para utilizar la nueva categoría Biblioteca de clientes (esto requiere la actualización del código de implementación de la página).
  5. AEM Actualizar las reglas de Dispatcher para permitir el servicio de bibliotecas de cliente a través de /etc.clientlibs/ servlet proxy.

Para cualquier diseño que NO se administre en SCM y que se modifique en tiempo de ejecución mediante cuadros de diálogo de diseño:

  • No saque los diseños con autor de /etc.
Notas
El método recomendado es crear AEM Sites y páginas mediante plantillas editables que utilicen contenido de estructura y directivas en lugar de diseños.

Bibliotecas de cliente de integración de Adobe Target adobe-target-integration-client-libraries

Ubicación anterior
/etc/clientlibs/foundation/target
Nueva ubicación(es)
/libs/cq/testandtarget/clientlibs/testandtarget
Directrices de reestructuración

Cualquier uso personalizado de estas bibliotecas de cliente debe hacer referencia a la biblioteca de cliente por categoría y no por ruta.

  1. Cualquier referencia a la biblioteca de cliente por ruta en la ubicación anterior debe actualizarse para utilizar AEM Marco de referencia de la biblioteca de clientes.
  2. AEM AEM Si no se puede utilizar el marco de referencia de la biblioteca de cliente de la biblioteca de cliente, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante el servlet proxy de la biblioteca de cliente:
  • /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
Notas

Nunca se admitió la edición de estas bibliotecas de cliente.

Para obtener las categorías de la Biblioteca de clientes, visite cada nodo cq:ClientLibraryFolder a través de CRXDELite e inspeccione la propiedad 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

Bibliotecas de cliente de WCM Foundation wcm-foundation-client-libraries

Ubicación anterior
/etc/clientlibs/wcm/foundation
Nueva ubicación(es)
/libs/wcm/foundation/clientlibs
Directrices de reestructuración

Cualquier uso personalizado de estas bibliotecas de cliente debe hacer referencia a la biblioteca de cliente por categoría y no por ruta.

  1. Cualquier referencia a la biblioteca de cliente por ruta en la ubicación anterior debe actualizarse para utilizar AEM Marco de referencia de la biblioteca de clientes.
  2. AEM AEM Si no se puede utilizar el marco de referencia de la biblioteca de cliente de la biblioteca de cliente, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante el servlet proxy de la biblioteca de cliente de la biblioteca de cliente de la biblioteca de cliente.
  • /etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.js
Notas

Nunca se admitió la edición de estas bibliotecas de cliente.

Para obtener las categorías de Biblioteca de clientes, visite cada una cq:ClientLIbraryFolder a través de CRXDELite e inspeccione la propiedad categories:

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