Reestructuración del repositorio de sitios en AEM 6.4 sites-repository-restructuring-in-aem

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

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

Con actualización a la versión 6.4

Antes de la actualización a la versión 6.5

Con actualización a la versión 6.4 with-upgrade

Segmentos de ContextHub contexthub-segments

Ubicación anterior
/etc/segmentation/contexthub
Nuevas ubicaciones

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

Directrices de reestructuración

Si algún segmento de ContextHub nuevo o modificado está pensado para editarse en control de código fuente en lugar de editarse en AEM, debe migrarse a la nueva ubicación:

  1. Copie cualquier segmento de ContextHub nuevo o modificado de la ubicación anterior a la nueva ubicación apropiada (https://experienceleague.adobe.com/%3Ccode%3Eapps%3C/code%3E,%20%3Ccode%3E/conf/global%3C/code%3E%20o%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=es)
  2. Actualice las referencias a los segmentos de ContextHub en la ubicación anterior a los segmentos de ContextHub migrados en las nuevas ubicaciones (/apps, /conf/global, /conf/<tenant>).

La siguiente consulta de QueryBuilder localiza todas las referencias a los 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 Interfaz de usuario de AEM QueryBuilder Debugger. Tenga en cuenta que esta es una consulta que atraviesa, por lo que no la ejecute con la producción y asegúrese de que los límites transversales estén ajustados según sea necesario.

Notas

Los segmentos de ContextHub persistían en la visualización de la ubicación anterior como solo lectura en AEM > Personalización > Audiencias.

Si los segmentos de ContextHub se pueden editar en AEM, se deben migrar a la nueva ubicación (/conf/global o /conf/<tenant>). Los segmentos de ContentHub creados en AEM se mantienen 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>) para seleccionarlo, por lo que los segmentos de ContextHub deben migrarse según corresponda.

Los segmentos de ContextHub no utilizados de AEM sitios de referencia 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 convertir a ContextHub.

Antes de la actualización a la versión 6.5 prior-to-upgrade

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

Ubicación anterior
/etc/clientlibs/foundation/sitecatalyst
Nuevas ubicaciones
/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 de acceso a la ubicación anterior debe actualizarse para utilizar AEM marco de referencia de la biblioteca de cliente.

  2. Si no se puede utilizar AEM marco de referencia de la biblioteca de cliente, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante AEM servlet proxy 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 la biblioteca de cliente, visite cada 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ño clásico de Word a página web de Microsoft classic-microsoft-word-to-web-page-designs

Ubicación anterior
/etc/designs/wordDesign
Nuevas ubicaciones

/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 tiempo de ejecución mediante los cuadros de diálogo de diseño.

  1. Copie los diseños de la ubicación anterior a la nueva ubicación (/apps).
  2. Convierta cualquier recurso CSS, JavaScript y estático del diseño en un Biblioteca de clientes 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 cliente (esto requiere actualizar el código de implementación de página).
  5. Actualice AEM reglas de Dispatcher para permitir el servicio de bibliotecas de cliente a través de la variable /etc.clientlibs/ proxy servlet.

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

  • No mueva los diseños que se pueden crear fuera de /etc.
Notas
N/D

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

Ubicación anterior
/etc/mobile
Nuevas ubicaciones

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Directrices de reestructuración

Las configuraciones del emulador de dispositivos móviles nuevas deben migrarse a la ubicación nueva.

  1. Copie cualquier configuración nueva del emulador de dispositivos móviles de la ubicación anterior a la nueva ubicación (/apps, /conf/global, /conf/<tenant>).
  2. Para las páginas de AEM Sites que dependen de estas configuraciones del emulador de dispositivos móviles, actualice el informe 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 y señale la variable cq : deviceGroups a Nueva ubicación.
Notas

La resolución de 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 del administrador de varios sitios multi-site-manager-blueprint-configurations

Ubicación anterior
/etc/blueprints
Nuevas ubicaciones

/apps/msm (Configuraciones del modelo del cliente)

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

Directrices de reestructuración

Las configuraciones de modelo de Multi-site Manager nuevas o modificadas deben 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

Todas las configuraciones de modelo de Multi-site Manager proporcionadas AEM existen 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 para ajustar.

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

Ubicación anterior
/etc/msm/rolloutConfigs
Nuevas ubicaciones

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Directrices de reestructuración

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

  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. Actualice cualquier referencia en AEM páginas a configuraciones de despliegue de administrador de varios sitios en la ubicación anterior, para que apunte a sus homólogos en las nuevas ubicaciones (/libs o /apps).

Elimine las configuraciones de lanzamiento migradas del administrador de varios sitios de la ubicación anterior.

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

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
Nuevas ubicaciones

/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 compatibles son las nuevas configuraciones regionales.

La resolución de la plantilla de correo electrónico de Evento de página 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

Las plantillas de correo electrónico de notificación de eventos de página nuevas o modificadas deben 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. Elimine las plantillas de correo electrónico de notificación de eventos de página migradas de la ubicación anterior.

Andamiaje de páginas page-scaffolding

Ubicación anterior
/etc/scaffolding
Nuevas ubicaciones

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

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

Directrices de reestructuración
El scaffolding creado en Ubicación anterior utiliza el marco de scaffolding heredado y no se puede migrar a la Nueva ubicación. Para alinearse con la Nueva ubicación, cualquier Scaffolding heredado debe ser redesarrollado usando el marco de Scaffolding admitido.
Notas
N/D

Cuadrícula adaptable MENOS responsive-grid-less

Ubicación anterior
/etc/clientlibs/wcm/foundation/grid/grid_base.less
Nuevas ubicaciones
/libs/wcm/foundation/clientlibs/grid/grid_base.less
Directrices de reestructuración

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

  • Actualice cualquier referencia a 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 grid_base.less El resultado del archivo es que el modo Diseño del Editor de plantillas y páginas no funciona, y una interrupción del diseño de la página.

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

Ubicación anterior
/etc/designs/<custom-site>
Nuevas ubicaciones
/apps/settings/wcm/designs/<custom-site>
Directrices de reestructuración

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

  1. Copie los diseños de la ubicación anterior a la nueva ubicación (/apps).
  2. Convierta cualquier recurso CSS, JavaScript y estático del diseño en un Biblioteca de clientes con allowProxy = true.
  3. Actualizar 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 cliente (esto requiere actualizar el código de implementación de página).
  5. Actualice AEM las reglas de Dispatcher para permitir el servicio de bibliotecas de cliente a través del /etc.clientlibs/ proxy servlet.

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

  • No mueva los diseños que se pueden crear fuera de /etc.
Notas
El método recomendado es crear AEM Sites y páginas utilizando plantillas editables que utilicen contenido de estructura y políticas en lugar de diseños.

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

Ubicación anterior
/etc/clientlibs/foundation/target
Nuevas ubicaciones
/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 de acceso a la ubicación anterior debe actualizarse para utilizar AEM marco de referencia de la biblioteca de cliente.
  2. Si no se puede utilizar AEM marco de referencia de la biblioteca de cliente, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante AEM 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 cliente, 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
Nuevas ubicaciones
/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 de acceso a la ubicación anterior debe actualizarse para utilizar AEM marco de referencia de la biblioteca de cliente.
  2. Si no se puede utilizar AEM marco de referencia de la biblioteca de cliente, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante AEM servlet proxy 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 la biblioteca de cliente, visite cada 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
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56