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 AEM Sites. Algunos cambios requieren esfuerzo de trabajo durante el proceso de actualización a AEM 6.4, mientras que otros se pueden posponer hasta una actualización a 6.5.

Con actualización a 6.4

Antes de la actualización a 6.5

Con actualización a 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

Orientación de reestructuración

Si algún segmento de ContextHub nuevo o modificado está pensado para editarse en el 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 adecuada (/%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 AEM interfaz de usuariodel depurador QueryBuilder. Tenga en cuenta que se trata de una consulta que atraviesa la zona, por lo que no la ejecute con respecto a la producción y asegúrese de que los límites transversales se ajusten según sea necesario.

Notas

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

Si los segmentos de ContextHub deben ser editables en AEM, deben migrarse a la nueva ubicación (/conf/global o /conf/<tenant>). Los segmentos de ContentHub nuevos 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 nueva ubicación (/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 ClientContext está en uso, se recomienda convertir a ContextHub.

Antes de la actualización a 6.5

Bibliotecas del cliente de Adobe Analytics

Ubicación anterior

/etc/clientlibs/foundation/sitecatalyst

Nuevas ubicaciones /libs/cq/analytics/clientlibs/analytics
Orientación de reestructuración

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

  1. Todas las referencias a la biblioteca de clientes por ruta en la ubicación anterior deben actualizarse para utilizar AEM marcode referencia de la biblioteca de clientes.
  2. Si no se puede utilizar AEM marco de referencia de la biblioteca de clientes, se puede hacer referencia a la ruta absoluta de las bibliotecas de clientes mediante AEM servlet Proxy de la biblioteca de clientes.
    • /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 cliente.

Para obtener las categorías de la biblioteca de clientes, visite cada cq:ClientLIbraryFolder nodo mediante CRXDELite e inspeccione la propiedad categorías.

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

Orientación de reestructuración

Para cualquier diseño que se administre en SCM y no se escriba en tiempo de ejecución mediante los diálogos 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 una 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 de biblioteca de clientes (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 mediante el servlet /etc.clientlibs/ proxy.

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

  • No retire los diseños que pueden crear los autores 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

Orientación de reestructuración Cualquier configuración nueva del emulador de dispositivos móviles debe migrarse a la nueva ubicación.
  1. Copie cualquier configuración nueva del emulador de dispositivos móviles desde 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 nodo de la página jcr :content :
    [cq:Page]/jcr:content@cq: deviceGroups = Cadena[ móvil/grupos/adaptable ]
  3. Para cualquier plantilla editable que dependa de estas configuraciones del emulador de dispositivos móviles, actualice las plantillas editables, señalando 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 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 pantallas, comercio)

Orientación de reestructuración

Cualquier configuración del modelo de varios sitios nueva o modificada debe migrarse a la nueva ubicación (/apps).

  1. Copie cualquier configuración del modelo de varios sitios nueva o modificada de la ubicación anterior a la nueva ubicación (/apps).
  2. Elimine cualquier configuración del modelo de varios sitios migrada de la ubicación anterior.
Notas

Todas las configuraciones del modelo de Múltiples sitios AEM se encuentran en la nueva ubicación de /libs.

El contenido no hace referencia a las configuraciones azules del Administrador de multisitio, por lo tanto no hay referencias de contenido para ajustar.

Configuraciones de implementación de múltiples sitios del Administrador

Ubicación anterior

/etc/msm/rolloutConfigs

Nuevas ubicaciones

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Orientación de reestructuración

Todas las configuraciones de implementación de múltiples sitios nuevas o modificadas deben migrarse a la nueva ubicación.

  1. Copie las configuraciones de despliegue de varios sitios nuevas o modificadas desde la ubicación anterior a la nueva ubicación (/apps).
  2. Actualice las referencias de las páginas AEM a las configuraciones de despliegue del administrador de varios sitios en la ubicación anterior, para que apunten a sus homólogos en las ubicaciones nuevas (/libs o /apps).

Elimine las configuraciones migradas de implementación de varios sitios del Administrador de la ubicación anterior.

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

Plantilla de correo electrónico de notificación de Evento 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

Orientación de reestructuración

Las únicas plantillas de correo electrónico de notificación de Evento de página admitidas 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

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

  1. Copie las plantillas de correo electrónico de notificación de Evento de página nuevas o modificadas desde la ubicación anterior a la nueva ubicación (/apps).
  2. Elimine las plantillas de correo electrónico de notificación de Evento 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

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

Cuadrícula adaptable MENOS

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

Todas las referencias a la ubicación anterior en los archivos LESS personalizados deben 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 grid_base.less archivo 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>
Orientación de reestructuración

Para cualquier diseño que se administre en SCM y no se escriba en tiempo de ejecución mediante los diálogos 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 una biblioteca de clientes 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 > Ficha avanzada > Campode diseño.
  4. Actualice las páginas que hagan referencia a la ubicación anterior para utilizar la nueva categoría de biblioteca de clientes (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 mediante el servlet /etc.clientlibs/ proxy.

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

  • No retire los diseños que pueden crear los autores de /etc.
Notas El método recomendado es crear AEM Sites y Páginas mediante plantillas editables que utilicen Contenido y políticas de estructura en lugar de Diseños.

Bibliotecas del cliente de integración de Adobe Search y Promote

Ubicación anterior

/etc/clientlibs/foundation/searchpromote

Nuevas ubicaciones /libs/cq/searchpromote/clientlibs/searchpromote
Orientación de reestructuración

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

  1. Todas las referencias a la biblioteca de clientes por ruta en la ubicación anterior deben actualizarse para utilizar AEM marcode referencia de la biblioteca de clientes.
  2. Si no se puede utilizar AEM marco de referencia de la biblioteca de clientes, se puede hacer referencia a la ruta absoluta de las bibliotecas de clientes mediante AEM servlet Proxy de la biblioteca de clientes:
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js
Notas

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

Para obtener las categorías de la biblioteca de clientes, visite cada nodo cq:ClientLIbraryFolder mediante CRXDELite e inspeccione la propiedad categorías:

  • /libs/cq/searchpromote/clientlibs/searchpromote

Bibliotecas de Adobe Target Integration Client

Ubicación anterior

/etc/clientlibs/foundation/target

Nuevas ubicaciones /libs/cq/testandtarget/clientlibs/testandtarget
Orientación de reestructuración

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

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

Para obtener las categorías de la biblioteca de clientes, visite cada nodo cq:ClientLIbraryFolder mediante CRXDELite e inspeccione la propiedad categorías:

  • /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 clientes de WCM Foundation

Ubicación anterior

/etc/clientlibs/wcm/foundation

Nuevas ubicaciones /libs/wcm/foundation/clientlibs
Orientación de reestructuración

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

  1. Todas las referencias a la biblioteca de clientes por ruta en la ubicación anterior deben actualizarse para utilizar AEM marcode referencia de la biblioteca de clientes.
  2. Si no se puede utilizar AEM marco de referencia de la biblioteca de clientes, se puede hacer referencia a la ruta absoluta de las bibliotecas de clientes mediante AEM servlet Proxy de la biblioteca de clientes.
  • /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 cliente.

Para obtener las categorías de la biblioteca de clientes, visite cada cq:ClientLIbraryFolder nodo mediante CRXDELite e inspeccione la propiedad categorías:

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

En esta página