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

AEM AEM Como se describe en la página principal Reestructuración del repositorio en la página de 6.5, 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 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 (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. 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.AEM

\

\

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

\

\

Esto se puede ejecutar a través de

IU de QueryBuilder Debugger de QueryBuilder

. 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

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

AEM Si los segmentos de ContextHub se van a poder editar en la, se deben migrar a la nueva ubicación (/conf/global o /conf/<tenant>). AEM Cualquier segmento de segmentos de ContentHub nuevo creado en la aplicación se mantendrá 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.

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. AEM Cualquier referencia a la biblioteca de cliente por ruta de acceso en la ubicación anterior debe actualizarse para que utilice el marco de referencia de la biblioteca de cliente de.

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

    • /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 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 nueva ubicación (/apps).
  2. Convierta cualquier recurso CSS, JavaScript y estático del diseño en 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 clientes (esto requiere la actualización del código de implementación de la página).
  5. AEM Actualizar reglas de Dispatcher para permitir el servicio de bibliotecas de cliente mediante el servlet proxy /etc.clientlibs/.

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 mueva los diseños que permiten crear 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 de la página jcr Nodo :content :
    [cq:Page]/jcr:content@cq: deviceGroups = Cadena[ 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 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 del 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 administrador de varios sitios 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 administrador de varios sitios proporcionadas 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 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 despliegue 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
Si se hace referencia a un archivo grid_base.less no existente, el modo Diseño del Editor de páginas y plantillas no funcionará y se interrumpirá 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 nueva ubicación (/apps).
  2. Convierta cualquier recurso CSS, JavaScript y estático del diseño en una biblioteca de cliente con allowProxy = true.
  3. AEM Actualice las referencias a la ubicación anterior en la propiedad cq:designPath mediante > 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 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 cuadros de diálogo de diseño:

  • No mueva los diseños que permiten crear 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. AEM Cualquier referencia a la biblioteca de cliente por ruta de acceso en la ubicación anterior debe actualizarse para que utilice el marco de referencia de la biblioteca de cliente de.
  2. AEM AEM Si no se puede utilizar el marco de referencia de la biblioteca de cliente de, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante el servlet proxy de la biblioteca de cliente de:
  • /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. AEM Cualquier referencia a la biblioteca de cliente por ruta de acceso en la ubicación anterior debe actualizarse para que utilice el marco de referencia de la biblioteca de cliente de.
  2. AEM AEM Si no se puede utilizar el marco de referencia de la biblioteca de cliente de, se puede hacer referencia a la ruta absoluta de las bibliotecas de cliente mediante el servlet proxy de la biblioteca de cliente de.
  • /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
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2