Show Menu
TEMAS×

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 a los cambios del repositorio que afectan a la solución AEM Sites. Algunos cambios requieren un esfuerzo de trabajo durante el proceso de actualización a AEM 6.4, mientras que otros se pueden aplazar 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 (/ apps , /conf/global o /conf/<tenant> )
  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 la interfaz de usuario del depurador de QueryBuilder de AEM . Tenga en cuenta que se trata de una consulta que atraviesa el proceso, 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 se van a editar en AEM, se deben migrar 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 la página Sitios de AEM 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 los sitios de referencia de AEM 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 de clientes 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 el marco de referencia de la biblioteca de clientes de AEM.
  2. Si no se puede utilizar el marco de referencia de la biblioteca de clientes de AEM, se puede hacer referencia a la ruta absoluta de las bibliotecas de clientes mediante el servlet Proxy de biblioteca de clientes de 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
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 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
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 Biblioteca de clientes (esto requiere actualizar el código de implementación de página).
  5. Actualice las reglas de AEM 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 todas las páginas de AEM Sites que dependan 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 varios sitios proporcionadas por AEM existen 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 de AEM a las configuraciones de despliegue de varios sitios del Administrador en la ubicación anterior para que apunten a sus homólogos en las nuevas ubicaciones ( /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 muestran a los autores de AEM opciones de implementación duplicadas.

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
Orientación de reestructuración
Las únicas plantillas de correo electrónico de notificación de eventos de página nuevas admitidas son las que admiten nuevas configuraciones regionales.
La resolución de la plantilla de correo electrónico del 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
Todas 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 las plantillas de correo electrónico de notificación de eventos 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 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
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 > 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 actualizar el código de implementación de página).
  5. Actualice las reglas de AEM 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 sitios y páginas de AEM 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 and 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 el marco de referencia de la biblioteca de clientes de AEM.
  2. Si no se puede utilizar el marco de referencia de la biblioteca de clientes de AEM, se puede hacer referencia a la ruta absoluta de las bibliotecas de clientes mediante el servlet Proxy de biblioteca de clientes de AEM:
  • /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 categories:
  • /libs/cq/searchpromote/clientlibs/searchpromote

Bibliotecas del cliente de integración de Adobe Target

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 el marco de referencia de la biblioteca de clientes de AEM.
  2. Si no se puede utilizar el marco de referencia de la biblioteca de clientes de AEM, se puede hacer referencia a la ruta absoluta de las bibliotecas de clientes mediante el servlet Proxy de biblioteca de clientes de 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
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 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 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 el marco de referencia de la biblioteca de clientes de AEM.
  2. Si no se puede utilizar el marco de referencia de la biblioteca de clientes de AEM, se puede hacer referencia a la ruta absoluta de las bibliotecas de clientes mediante el servlet Proxy de biblioteca de clientes de AEM.
  • /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 categories:
  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main