DocumentaciónAEM 6.4Guía de desarrollo

Superposiciones overlays

Last update: Fri May 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Developer
CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

AEM (y antes de eso, CQ) ha utilizado durante mucho tiempo el principio de superposiciones para permitirle ampliar y personalizar el consolas y otras funciones (por ejemplo, creación de páginas).

La superposición es un término que se puede utilizar en muchos contextos. En este contexto (ampliación de AEM), una superposición implica tomar la funcionalidad predefinida e imponer sus propias definiciones sobre ella (para personalizar la funcionalidad estándar).

En una instancia estándar, la funcionalidad predefinida se mantiene en /libs y se recomienda definir la superposición (personalizaciones) en la variable /apps rama. AEM utiliza una ruta de búsqueda para encontrar un recurso, buscando primero el /apps y luego la /libs sucursal (la variable la ruta de búsqueda se puede configurar). Este mecanismo significa que la superposición (y las personalizaciones definidas allí) tendrán prioridad.

Desde AEM 6.0, se han realizado cambios en la forma en que se implementan y usan las superposiciones:

  • AEM 6.0 en adelante: para GraniteSuperposiciones relacionadas (es decir, la IU táctil)

    • Método

      • Reconstruya el /libs estructura /apps.

        Esto no requiere una copia 1:1, la variable Fusión de recursos de Sling se utiliza para hacer referencia cruzada a las definiciones originales que son necesarias. La fusión de recursos de Sling proporciona servicios para acceder y fusionar recursos mediante mecanismos de diferenciación (diferenciación).

      • Realice cualquier cambio en /apps.

    • Ventajas

      • Más robusto en /libs.
      • Solo redefina lo que realmente se requiere.

  • Superposiciones y superposiciones no de Granite anteriores a AEM 6.0

    • Método

      • Copiar el contenido de /libs a /apps

        Debe copiar toda la subrama, incluidas las propiedades.

      • Realice cualquier cambio en /apps.

    • Desventajas

      • Aunque los cambios no se perderán cuando algo cambie en /libs, es posible que tenga que volver a crear ciertos cambios que se producen en la superposición en /apps.
CAUTION
La variable Fusión de recursos de Sling y los métodos relacionados solo se pueden usar con Granite. Esto significa que la creación de una superposición con una estructura de esqueletos solo es adecuada para la IU estándar con capacidad táctil.
Las superposiciones de otras áreas (incluida la IU clásica) implican copiar el nodo apropiado y toda la subestructura y, a continuación, realizar los cambios necesarios.

Las superposiciones son el método recomendado para muchos cambios, como configuración de las consolas o creación de la categoría de selección en el navegador de recursos del panel lateral (se utiliza al crear páginas). Son necesarias como:

  • You no debe realice cambios en /libs Rama ​ Cualquier cambio que realice puede perderse, ya que esta rama puede cambiar siempre que:

    • actualizar en su instancia
    • aplicar una corrección
    • instalar un paquete de características

  • Concentran los cambios en un solo lugar; facilitando el seguimiento, la migración, la copia de seguridad o la depuración de los cambios según sea necesario.

Configuración de las rutas de búsqueda configuring-the-search-paths

Para las superposiciones, el recurso enviado es un agregado de los recursos y propiedades recuperados, según las rutas de búsqueda que se puedan definir:

  • El recurso Ruta de búsqueda de resolución tal como se define en la variable Configuración de OSGi para el Fábrica de resolución de recursos de Apache Sling.

    • El orden descendente de las rutas de búsqueda indica sus prioridades respectivas.
    • En una instalación estándar, los valores predeterminados principales son /apps, /libs - así que el contenido de /apps tiene una prioridad mayor que la de /libs (es decir, que superposiciones ).

  • Dos usuarios de servicio necesitan acceso JCR:READ a la ubicación donde se almacenan los scripts. Estos usuarios son: components-search-service (utilizado por los com.day.cq.wcm.coreto access/cache components) y sling-scripting (utilizado por org.apache.sling.servlets.resolver para encontrar servlets).

  • La siguiente configuración también debe configurarse según el lugar donde coloque los scripts (en este ejemplo en /etc, /libs o /apps).

    code language-none 
    PID = org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl
resource.resolver.searchpath=["/etc","/apps","/libs"]
resource.resolver.vanitypath.whitelist=["/etc/","/apps/","/libs/","/content/"]

  • Finalmente, Servlet Resolver también debe estar configurado (en este ejemplo para agregar /etc también)

    code language-none 
    PID = org.apache.sling.servlets.resolver.SlingServletResolver
servletresolver.paths=["/bin/","/libs/","/apps/","/etc/","/system/","/index.servlet","/login.servlet","/services/"]

Ejemplo de uso example-of-usage

Algunos ejemplos se tratan cuando:

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e