Reestructuración del repositorio de sitios en AEM 6.4

Como se describe en la página principal Reestructuración del repositorio 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 del 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 de 6.4

Segmentos de ContextHub

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 (/%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 a través de AEM interfaz de usuario de 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 seleccionar la ubicación anterior (/etc) o una sola ubicación nueva (/apps, /conf/global o /conf/<tenant>), 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 a0/> de 6.5

Bibliotecas de cliente de Adobe Analytics

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 en la ubicación anterior debe actualizarse para utilizar AEM Client Library reference framework.
  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 nodo 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 Microsoft Word para páginas web

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 en el diseño a una 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 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 del servlet proxy /etc.clientlibs/.

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 de autor fuera de /etc.
Notas N/D

Configuraciones del emulador de dispositivos móviles

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 dispositivo móvil 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 la página 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 el cq : deviceGroups a la ubicación nueva.
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

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

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

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

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

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

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 interactiva MENOS

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 Al hacer referencia a un archivo grid_base.less no existente, el modo Diseño del Editor de plantillas y páginas no funciona, y se interrumpe el diseño de la página.

Diseños de plantilla estáticos

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 en el diseño a una biblioteca de cliente con allowProxy = true.
  3. Actualice las referencias a la ubicación anterior en la propiedad cq:designPath mediante AEM > Sitios > Páginas de sitio personalizadas > Propiedades de página > Pestaña avanzada > 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 reglas de Dispatcher para permitir el servicio de bibliotecas de cliente a través del servlet proxy /etc.clientlibs/.

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 de autor 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 cliente de integración de Adobe Search and Promote

Ubicación anterior

/etc/clientlibs/foundation/searchpromote

Nuevas ubicaciones /libs/cq/searchpromote/clientlibs/searchpromote
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 en la ubicación anterior debe actualizarse para utilizar AEM Client Library reference framework.
  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/searchpromote/clientlibs/searchpromotei.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/searchpromote/clientlibs/searchpromote

Bibliotecas de cliente de integración de Adobe Target

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 en la ubicación anterior debe actualizarse para utilizar AEM Client Library reference framework.
  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

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 en la ubicación anterior debe actualizarse para utilizar AEM Client Library reference framework.
  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 nodo cq:ClientLIbraryFolder a través de CRXDELite e inspeccione la propiedad categories :

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main

En esta página