Reestructuración de repositorios comunes en AEM 6.5 common-repository-restructuring-in-aem

/libs/settings/workflow/models

/conf/global/settings/workflow/models

/var/workflow/models

Cualquier modelo de flujo de trabajo nuevo o modificado debe migrarse a /conf/global/workflow/models.

1. Implemente los modelos de flujo de trabajo modificados en una instancia de desarrollo de AEM 6.5 local, de modo que existan en la ubicación Anterior.

2. Edite el modelo de flujo de trabajo con el Editor del modelo de flujo de trabajo de AEM en AEM > Herramientas > Flujo de trabajo > Modelos.

3. Al migrar modelos de flujo de trabajo modificados proporcionados por AEM

   1. Con el Editor del modelo de flujo de trabajo abierto, modifique la dirección URL del explorador y reemplace el segmento de ruta /libs/settings/workflow/models por /etc/workflow/models.
      • Por ejemplo, cambie: http://localhost:4502/editor.html/libs/settings/workflow/models/dam/update_asset.html a http://localhost:4502/editor.html/etc/workflow/models/dam/update_asset.html

4. Habilite el modo de edición en el Editor del modelo de flujo de trabajo, que copiará la definición del modelo de flujo de trabajo en /conf/global/workflow/models.

5. Seleccione el botón Sincronizar para sincronizar los cambios en el Modelo de flujo de trabajo en tiempo de ejecución en /var/workflow/models.

6. Exporte el modelo de flujo de trabajo (/conf/global/workflow/models/<workflow-model>) y el modelo de flujo de trabajo de tiempo de ejecución (/var/workflow/models/<workflow-model>) e integre en el proyecto de AEM.

   1. Por ejemplo, exportar:

      • /conf/global/settings/workflow/models/dam/my_workflow_model
        y
      • /var/workflow/models/dam/my_workflow_model

La resolución del modelo de flujo de trabajo se produce en el siguiente orden:

1. /conf/global/settings/workflow/models
2. /libs/settings/workflow/models
3. /etc/workflow/models

Por lo tanto, cualquier personalización de los modelos de flujo de trabajo proporcionados por AEM que persista en la ubicación anterior debe moverse a /conf/global/settings/workflow/models si se va a conservar, de lo contrario, se reemplazarán con la definición del modelo de flujo de trabajo proporcionado por AEM en /libs/settings/workflow/models.

No se requiere ninguna acción para alinearse con la Nueva ubicación.

Las instancias de flujo de trabajo históricas pueden seguir residiendo de forma segura en la ubicación anterior y se crearán nuevas instancias de flujo de trabajo en la nueva ubicación.

Cualquier referencia de ruta explícita en El código custom de la ubicación anterior también debe tener en cuenta la nueva ubicación. Se recomienda refactorizar este código para utilizar las API de flujo de trabajo de AEM.

/libs/settings/workflow/launcher/config

/conf/global/settings/workflow/launcher/config

Cualquier lanzador de flujo de trabajo nuevo o modificado debe migrarse a /conf/global/workflow/launcher/config.

1. Copie cualquier configuración del lanzador de flujos de trabajo nueva o modificada de la ubicación anterior a la nueva ubicación (/conf/global).

La resolución del lanzador de flujos de trabajo se produce en el siguiente orden:

1. /conf/global/settings/workflow/launcher
2. /libs/settings/workflow/launcher
3. /etc/workflow/launcher

Por lo tanto, cualquier personalización del lanzador de flujos de trabajo proporcionado por AEM que persista en la ubicación anterior debe moverse a la nueva ubicación (/conf/global/settings/workflow/launcher) si se va a conservar; de lo contrario, se reemplazará con la definición del lanzador de flujos de trabajo proporcionada por AEM en /libs/settings/workflow/launcher.

/libs/workflow/scripts

/apps/workflow/scripts

Cualquier script de flujo de trabajo nuevo o modificado debe migrarse a la nueva ubicación y los modelos de flujo de trabajo de referencia deben actualizarse para reflejar la nueva ubicación.

1. Copie cualquier script de flujo de trabajo nuevo o modificado de la ubicación anterior a la nueva ubicación.
   • /apps/workflow/scripts debe mantenerse en SCM.
2. Actualice las referencias a los scripts de flujo de trabajo en la ubicación anterior en modelos de flujo de trabajo para que apunten a las nuevas ubicaciones.

AEM 6.4 SP1, cuando se publica, hace que esta reestructuración se pueda aplazar hasta 6.5 upgrade .

Si la actualización a AEM 6.4 es anterior a la publicación de AEM 6.4 SP1, esta reestructuración debe realizarse como parte del proyecto de actualización. Sin hacerlo, editar y guardar los pasos del flujo de trabajo que hacen referencia a scripts en la ubicación anterior eliminará por completo la referencia de script de flujo de trabajo del paso de flujo de trabajo, y solo los scripts de flujo de trabajo en nuevas ubicaciones estarán disponibles en la lista desplegable de selección de scripts.

/libs/settings/cloudsettings

/conf/global/settings/cloudsettings

/conf/<tenant>/settings/cloudsettings

Cualquier configuración de ContextHub nueva o modificada debe migrarse a la nueva ubicación y las páginas de referencia de AEM Sites deben actualizarse para reflejar la nueva ubicación.

1. Copie cualquier configuración de ContextHub nueva o modificada de la ubicación anterior a la nueva ubicación.
2. Asocie las configuraciones de AEM aplicables a las jerarquías de contenido de AEM.
   1. Jerarquías de páginas de AEM Sites mediante AEM Sites > Página > Propiedades de página > Pestaña Avanzadas > Configuración de nube.
3. Desasocie cualquier configuración de ContextHub heredada migrada de las jerarquías de contenido de AEM mencionadas anteriormente.

N/A

/libs/settings/wcm/designs/cloudservices

/apps/settings/wcm/designs/cloudservices

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 cq : Propiedad 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. Actualice las reglas de AEM Dispatcher para permitir el servicio de bibliotecas de cliente a través del servlet proxy /etc.clientlibs/...

Para cualquier diseño que NO se haya administrado en SCM y que se haya modificado en tiempo de ejecución mediante cuadros de diálogo de diseño.

• No mueva los diseños que permiten crear de /etc.

N/A

/libs/settings/wcm/designs/dashboards

/apps/settings/wcm/designs/dashboards

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 a 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 cq : Propiedad 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. Actualice las reglas de AEM Dispatcher para permitir el servicio de bibliotecas de cliente a través del servlet proxy /etc.clientlibs/...

Para cualquier diseño que NO se haya administrado en SCM y que se haya modificado en tiempo de ejecución mediante cuadros de diálogo de diseño.

• No mueva los diseños que permiten crear de /etc.

N/A

/libs/settings/wcm/designs/reports

/apps/settings/wcm/designs/reports

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 a 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 cq : Propiedad 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. Actualice las reglas de AEM Dispatcher para permitir el servicio de bibliotecas de cliente a través del servlet proxy /etc.clientlibs/...

Para cualquier diseño que NO se haya administrado en SCM y que se haya modificado en tiempo de ejecución mediante cuadros de diálogo de diseño.

• No mueva los diseños que permiten crear de /etc.

N/A

/libs/settings/wcm/designs/default

/apps/settings/wcm/designs/default

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 a 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 cq : Propiedad 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. Actualice las reglas de AEM Dispatcher para permitir el servicio de bibliotecas de cliente a través del servlet proxy /etc.clientlibs/...

Para cualquier diseño que NO se haya administrado en SCM y que se haya modificado en tiempo de ejecución mediante cuadros de diálogo de diseño.

• No mueva los diseños que permiten crear de /etc.

N/A

No se requiere ninguna acción.

La ubicación anterior pública actúa como extremo proxy para la nueva ubicación privada.

N/A

No se requiere ninguna acción.

La ubicación anterior pública actúa como extremo proxy para la nueva ubicación privada.

N/A

Use la Tarea de mantenimiento de purga de la bandeja de entrada para quitar las tareas antiguas de la ubicación anterior según sea necesario.

No se requiere ninguna acción para migrar tareas a la nueva ubicación.

• Las tareas presentes en la Ubicación anterior siguen estando disponibles y funcionan.
• Las Tareas nuevas se crean en la Nueva ubicación.

/libs/msm

/apps/msm

1. Copiar configuraciones personalizadas de /etc/blueprints a /apps/msm.
2. Quitar /etc/blueprints.

N/A

/libs/cq/core/content/projects/dashboard/gadgets

/apps/cq/core/content/projects/dashboard/gadgets

Cualquier configuración de gadget del panel de proyectos de AEM nueva o modificada debe migrarse a la nueva ubicación (/apps).

1. Copie cualquier configuración de gadget del panel de proyectos de AEM nueva o modificada de la ubicación anterior a la nueva ubicación (/apps).
   1. No copie configuraciones de gadget del panel de proyectos de AEM sin modificar, ya que ahora existen en la nueva ubicación (/libs).
2. Actualice cualquier plantilla de AEM Projects que haga referencia a la ubicación anterior para que apunte a la nueva ubicación adecuada.

Si se aplica el paquete de compatibilidad de AEM 6.4, será necesario realizar las actividades de alineación del repositorio en el momento de la eliminación del paquete de compatibilidad.

/libs/settings/notification-templates/com.day.cq.replication

/apps/settings/notification-templates/com.day.cq.replication

Cualquier plantilla de correo electrónico de notificación de replicación nueva o modificada debe migrarse a la nueva ubicación (/apps)

1. Copie las plantillas de correo electrónico de notificación de replicación nuevas o modificadas de la ubicación anterior a la nueva ubicación (/apps).
2. Quite las plantillas de correo electrónico de notificación de replicación migradas de la ubicación anterior.

Las únicas plantillas de correo electrónico de notificación de replicación nuevas admitidas son las nuevas configuraciones regionales.

La resolución de la plantilla de correo electrónico de notificación de replicación se produce en el siguiente orden:

1. /etc/notification/email/default/com.day.cq.replication
2. /apps/settings/notification-templates/com.day.cq.replication
3. /libs/settings/notification-templates/com.day.cq.replication

Todas las etiquetas deben migrarse a /content/cq:tags.

1. Copie todas las etiquetas de la ubicación anterior a la nueva ubicación.
2. Quitar todas las etiquetas de la ubicación anterior.
3. A través de la consola web de AEM, reinicie el paquete OSGi de etiquetado del Día Comunicado 5 en https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging para que AEM reconozca que la Nueva ubicación contiene contenido y debe usarse.

Al reiniciar el paquete OSGi de etiquetado comunitario de día, solo se registrará la nueva ubicación como raíz de etiqueta si la ubicación anterior está vacía.

Las referencias a la ubicación anterior seguirán funcionando después de migrar a la nueva ubicación para todas las funcionalidades que utilicen la API TagManager de AEM para la resolución de etiquetas.

Cualquier código personalizado que haga referencia explícita a la ruta de acceso /etc/tags debe actualizarse a /content/ cq ``:tags, o preferiblemente reescrito para utilizar la API de Java de TagManager junto con esta migración.

/libs/settings/cloudconfigs/translation/translationcfg

/apps/settings/cloudconfigs/translation/translationcfg

/conf/global/settings/cloudconfigs/translation/translationcfg

/conf/<tenant>/settings/cloudconfigs/translation/translationcfg

Cualquier nuevo servicio de nube de traducción debe migrarse a la nueva ubicación (/apps, /conf/global o /conf/<tenant>).

1. Migre las configuraciones existentes en la ubicación anterior a la nueva ubicación.

   • Vuelva a crear manualmente las nuevas configuraciones de los servicios de nube de traducción mediante la interfaz de usuario de creación de AEM en Herramientas > Cloud Services > Servicios de nube de traducción.
     OR
   • Copie cualquier configuración nueva de los servicios de nube de traducción de la ubicación anterior a la nueva ubicación (/apps, /conf/global o /conf/<tenant>).

2. Asocie las configuraciones de AEM aplicables a las jerarquías de contenido de AEM.

   1. Jerarquías de páginas de AEM Sites mediante AEM Sites > Página > Propiedades de página > Pestaña Avanzadas > Configuración de nube.
   2. Jerarquías de fragmentos de experiencias de AEM mediante Fragmentos de experiencias de AEM > Fragmento de experiencias > Propiedades > Pestaña Servicios de nube > Configuración de nube.
   3. Jerarquías de carpetas de fragmentos de experiencias de AEM a través de Fragmentos de experiencias de AEM > Carpeta > Propiedades > Pestaña Servicios de nube > Configuración de nube.
   4. AEM Assets las jerarquías de carpetas mediante AEM Assets > Carpeta > Propiedades de carpeta > Pestaña Cloud Services > Configuración.
   5. Proyectos AEM mediante Proyectos AEM > Proyecto > Propiedades del proyecto > Pestaña Avanzadas > Configuración de nube.

3. Desasocie los servicios de nube de traducción heredados migrados de las jerarquías de contenido de AEM mencionadas anteriormente.

La resolución de los servicios de nube de traducción se produce en el siguiente orden:

1. /conf/<tenant>/settings/cloudconfigs/translations/translationcfg
2. /conf/global/settings/cloudconfigs/translations/translationcfg
3. /apps/settings/cloudconfigs/translations/translationcfg
4. /libs/settings/cloudconfigs/translations/translationcfg

Los servicios de nube de traducción migrados deben ser compatibles con AEM 6.4.

/libs/settings/translation/supportedLanguages

/apps/settings/translation/supportedLanguages

Cualquier definición de idioma de traducción nueva o modificada requiere una migración de todas las definiciones de idioma de traducción a la nueva ubicación (/apps).

1. Si se han realizado adiciones o modificaciones en las definiciones de idioma de traducción, copie todas las definiciones de idioma de traducción de la ubicación anterior a la nueva ubicación (/apps).

La resolución de la ruta del idioma de traducción se produce en el siguiente orden:

1. /etc/translation/supportedLanguages
2. /apps/settings/translation/supportedLanguage
3. /libs/settings/translation/supportedLanguages

Esta resolución no admite una superposición combinada, lo que significa que la ruta resuelta debe contener todos los idiomas compatibles y no heredará los idiomas compatibles de resoluciones de orden superior.

/libs/settings/translation/rules/translation_rules.xml

/apps/settings/translation/rules/translation_rules.xml

/conf/global/settings/translation/rules/translation_rules.xml

Se debe migrar un archivo XML de reglas de traducción modificado a la nueva ubicación (/apps o /conf/global).

1. Copie el archivo XML de reglas de traducción modificado de la ubicación anterior a la nueva ubicación.

La resolución XML de reglas de traducción de replicación se produce en el siguiente orden:

1. /conf/global/settings/translation/rules/translation_rules.xml
2. /apps/settings/translation/rules/translation_rules.xml
3. /etc/workflow/models/translation/translation_rules.xml
4. /libs/settings/translation/rules/translation_rules.xml

/libs/settings/wcm/designs/translation/translationwidget

/apps/settings/wcm/designs/translation/translationwidget

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 a 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 cq : Propiedad 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. Actualice las reglas de AEM Dispatcher para permitir el servicio de bibliotecas de cliente a través del servlet proxy /etc.clientlibs/...

Para cualquier diseño que NO se haya administrado en SCM y que se haya modificado en tiempo de ejecución mediante cuadros de diálogo de diseño.

• No mueva los diseños que permiten crear de /etc.

N/A

/libs/settings/cloudconfigs/translation/<vendor>

/apps/settings/cloudconfigs/translation/<vendor>

/conf/global/settings/cloudconfigs/translation/<vendor>

/conf/<tenant>/settings/cloudconfigs/translation/<vendor>

Cualquier nuevo conector de traducción de proveedor de Cloud Services debe migrarse a la nueva ubicación (/apps, /conf/global o /conf/<tenant>).

1. Migre las configuraciones existentes en la ubicación anterior a la nueva ubicación.

   • Cree manualmente configuraciones de Cloud Services del conector de traducción de proveedor a través de la IU de creación de AEM en Herramientas > Cloud Services > Cloud Services de traducción.
     OR
   • Copie cualquier nueva configuración de Cloud Services de Vendor Translation Connector de la ubicación anterior a la nueva ubicación (/apps, /conf/global o /conf/<tenant>).

2. Asocie las configuraciones de AEM aplicables a las jerarquías de contenido de AEM.

   1. Jerarquías de páginas de AEM Sites mediante AEM Sites > Página > Propiedades de página > Pestaña Avanzadas > Configuración de nube.
   2. Jerarquías de fragmentos de experiencias de AEM mediante Fragmentos de experiencias de AEM > Fragmento de experiencias > Propiedades > Pestaña Servicios de nube > Configuración de nube.
   3. Jerarquías de carpetas de fragmentos de experiencias de AEM a través de Fragmentos de experiencias de AEM > Carpeta > Propiedades > Pestaña Servicios de nube > Configuración de nube.
   4. AEM Assets las jerarquías de carpetas mediante AEM Assets > Carpeta > Propiedades de carpeta > Pestaña Cloud Services > Configuración.
   5. Proyectos AEM mediante Proyectos AEM > Proyecto > Propiedades del proyecto > Pestaña Avanzadas > Configuración de nube.

3. Desasocie los servicios de nube de traducción heredados migrados de las jerarquías de contenido de AEM mencionadas anteriormente.

La resolución de los servicios de nube de traducción se produce en el siguiente orden:

1. /conf/<tenant>/settings/cloudconfigs/translations/<vendor>
2. /conf/global/settings/cloudconfigs/translations/<vendor>
3. /apps/settings/cloudconfigs/translations/<vendor>
4. /libs/settings/cloudconfigs/translations/<vendor>

/libs/settings/workflow/notification

/conf/global/settings/workflow/notification

Cualquier plantilla de correo electrónico de notificación de flujo de trabajo modificada debe migrarse a la nueva ubicación (/conf/global).

1. Copie cualquier plantilla de correo electrónico de notificación de flujo de trabajo modificada de la ubicación anterior a la nueva ubicación.
2. Quitar las plantillas de correo electrónico de notificación de flujo de trabajo migradas de la ubicación anterior.

La resolución de la plantilla de correo electrónico de notificación de flujo de trabajo se produce en el siguiente orden:

1. /etc/workflow/notification
2. /conf/global/settings/workflow/notification
3. /libs/settings/workflow/notification

Los paquetes de flujo de trabajo existentes en la ubicación anterior deben migrarse a la nueva ubicación.

1. Elimine cualquier paquete de flujo de trabajo de la ubicación anterior al que no haga referencia otro contenido y que, por lo demás, no sea necesario.
2. Mueva cualquier paquete de flujo de trabajo en la ubicación anterior al que no haga referencia otro contenido pero que sea necesario en la nueva ubicación.
3. Deje los paquetes de flujo de trabajo a los que haga referencia otro contenido en la ubicación anterior.

Los paquetes de flujo de trabajo creados mediante la consola Miscadmin de la IU clásica se mantienen en la ubicación anterior, mientras que todos los demás se mantienen en la nueva ubicación.

Los paquetes de flujo de trabajo almacenados en las ubicaciones anteriores o bajas se pueden administrar mediante la consola Miscadmin de la IU clásica.