Uso de la fusión de recursos de Sling en AEM

Función

La fusión de recursos de Sling proporciona servicios para acceder y combinar recursos. Proporciona mecanismos de diferenciación (diferenciación) para ambos:

• Superposiciones de los recursos que utilizan la variable rutas de búsqueda configuradas.

• Anulaciones de los cuadros de diálogo de los componentes para la IU táctil (cq:dialog), utilizando la jerarquía de tipo de recurso (mediante la propiedad ) sling:resourceSuperType).

Con la fusión de recursos de Sling, los recursos o propiedades de superposición/anulación se combinan con los recursos/propiedades originales:

• El contenido de la definición personalizada tiene una prioridad mayor que el del original (es decir, que superposiciones o anulaciones ).

• En su caso, propiedades definida en la personalización, indique cómo se va a utilizar el contenido combinado del original.

Objetivos para AEM

Los objetivos para usar la fusión de recursos de Sling en AEM son:

• asegúrese de que los cambios de personalización no se realicen en /libs.

• reducir la estructura que se replica desde /libs.

  Al utilizar la fusión de recursos de Sling, no se recomienda copiar toda la estructura de /libs ya que esto resultaría en que se mantenga demasiada información en la personalización (normalmente /apps). La duplicación de información aumenta innecesariamente la posibilidad de problemas cuando el sistema se actualiza de alguna manera.

Propiedades

La combinación de recursos proporciona las siguientes propiedades:

• sling:hideProperties ( String o String[])

  Especifica la propiedad, o lista de propiedades, que se va a ocultar.

  El comodín * oculta todo.

• sling:hideResource ( Boolean)

  Indica si los recursos deben estar completamente ocultos, incluidos los elementos secundarios.

• sling:hideChildren ( String o String[])

  Contiene el nodo secundario, o lista de nodos secundarios, que se deben ocultar. Las propiedades del nodo se mantendrán.

  El comodín * oculta todo.

• sling:orderBefore ( String)

  Contiene el nombre del nodo del mismo nivel en el que se debe colocar el nodo actual delante de .

Estas propiedades afectan al modo en que los recursos/propiedades correspondientes/originales (de /libs) se utilizan en la superposición/anulación (a menudo en /apps).

Creación de la estructura

Para crear una superposición o una anulación, debe volver a crear el nodo original, con la estructura equivalente, en el destino (normalmente /apps). Por ejemplo:

• Superposición

  • La definición de la entrada de navegación para la consola Sitios, tal como se muestra en el carril, se define en:

    /libs/cq/core/content/nav/sites/jcr:title

  • Para superponer esto, cree el siguiente nodo:

    /apps/cq/core/content/nav/sites

    A continuación, actualice la propiedad jcr:title según sea necesario.

• Omitir

  • La definición del cuadro de diálogo táctil para la consola Texts se define en:

    /libs/foundation/components/text/cq:dialog

  • Para anular esto, cree el siguiente nodo, por ejemplo:

    /apps/the-project/components/text/cq:dialog

Para crear cualquiera de estos elementos solo es necesario volver a crear la estructura del esqueleto. Para simplificar la recreación de la estructura, todos los nodos intermediarios pueden ser del tipo nt:unstructured (no tienen que reflejar el tipo de nodo original; por ejemplo, en /libs).

Por lo tanto, en el ejemplo de superposición anterior, se necesitan los siguientes nodos:

/apps
  /cq
    /core
      /content
        /nav
          /sites

Casos de uso

Estos, junto con la funcionalidad estándar, permiten:

• Agregar una propiedad

  La propiedad no existe en la variable /libs la definición, pero es necesaria en la variable /apps superposición/anulación.

  1. Cree el nodo correspondiente dentro de /apps
  2. Cree la nueva propiedad en este nodo "

• Redefinir una propiedad (no propiedades creadas automáticamente)

  La propiedad se define en /libs, pero se requiere un nuevo valor en la variable /apps superposición/anulación.

  1. Cree el nodo correspondiente dentro de /apps

  2. Cree la propiedad coincidente en este nodo (en / apps)

     • La propiedad tendrá una prioridad basada en la configuración de Sling Resource Resolver.

     • Se admite el cambio del tipo de propiedad.

       Si utiliza un tipo de propiedad diferente al utilizado en /libs, se utilizará el tipo de propiedad que defina.

  NOTA

  Se admite el cambio del tipo de propiedad.

• Redefinir una propiedad creada automáticamente

  De forma predeterminada, las propiedades creadas automáticamente (por ejemplo, jcr:primaryType) no están sujetos a una superposición o anulación para garantizar que el tipo de nodo que se encuentra actualmente en /libs se respeta. Para imponer una superposición/anulación, debe volver a crear el nodo en /apps, oculte explícitamente la propiedad y vuelva a definirla:

  1. Cree el nodo correspondiente en /apps con el jcr:primaryType

  2. Crear la propiedad sling:hideProperties en ese nodo, con el valor establecido en el de la propiedad creada automáticamente; por ejemplo, jcr:primaryType

     Esta propiedad, definida en /apps, ahora tendrá prioridad sobre el definido en /libs

• Redefinir un nodo y sus elementos secundarios

  El nodo y sus elementos secundarios se definen en /libs, pero se requiere una nueva configuración en la /apps superposición/anulación.

  1. Combinar las acciones de:

     1. Ocultar elementos secundarios de un nodo (conservar las propiedades del nodo)
     2. Redefinir la propiedad o propiedades

• Ocultar una propiedad

  La propiedad se define en /libs, pero no obligatorio en el /apps superposición/anulación.

  1. Cree el nodo correspondiente dentro de /apps

  2. Crear una propiedad sling:hideProperties de tipo String o String[]. Utilice esto para especificar las propiedades que se van a ocultar o ignorar. También se pueden utilizar caracteres comodín. Por ejemplo:

     • *
     • ["*"]
     • jcr:title
     • ["jcr:title", "jcr:description"]

• Ocultar un nodo y sus elementos secundarios

  El nodo y sus elementos secundarios se definen en /libs, pero no obligatorio en el /apps superposición/anulación.

  1. Cree el nodo correspondiente en /apps

  2. Crear una propiedad sling:hideResource

     • type: Boolean
     • value: true

• Ocultar elementos secundarios de un nodo (manteniendo las propiedades del nodo)

  El nodo, sus propiedades y sus elementos secundarios se definen en /libs. El nodo y sus propiedades son necesarios en la variable /apps superposición/anulación, pero algunos o todos los nodos secundarios no son necesarios en la variable /apps superposición/anulación.

  1. Cree el nodo correspondiente en /apps

  2. Crear la propiedad sling:hideChildren:

     • type: String[]
     • valor: una lista de los nodos secundarios (tal como se definen en /libs) para ocultar o ignorar

     El comodín * se puede utilizar para ocultar o ignorar todos los nodos secundarios.

• Reordenar nodos

  El nodo y sus hermanos se definen en /libs. Se requiere una nueva posición para que el nodo se vuelva a crear en la /apps superposición/anulación, donde la nueva posición se define en referencia al nodo del mismo nivel apropiado en /libs.

  • Utilice la variable sling:orderBefore propiedad:

    1. Cree el nodo correspondiente en /apps

    2. Crear la propiedad sling:orderBefore:

       Esto especifica el nodo (como en /libs) que el nodo actual debe colocarse antes de:

       • type: String
       • value: <before-SiblingName>

Invocación de la fusión de recursos de Sling desde el código

La fusión de recursos de Sling incluye dos proveedores de recursos personalizados: uno para superposiciones y otro para anulaciones. Cada una de ellas se puede invocar dentro del código utilizando un punto de montaje:

• Superposición:

  • propósito: combinar recursos en función de su ruta de búsqueda

  • punto de montaje: /mnt/overlay

  • uso: mount point + relative path

  • ejemplo:

    • getResource('/mnt/overlay' + '<relative-path-to-resource>');

• Omitir:

  • propósito: combinar recursos en función de su supertipo

  • punto de montaje: /mnt/overide

  • uso: mount point + absolute path

  • ejemplo:

    • getResource('/mnt/override' + '<absolute-path-to-resource>');

Ejemplo de uso

Se tratan algunos ejemplos:

• Superposición:

  • Personalización de las consolas
  • Personalización de la creación de páginas

• Omitir:

  • Configuración de las propiedades de página

Recursos de Business.Adobe.com

Multichannel Communication Auto Form Fill Cms Cloud Targeted Content Managed Cloud Dynamic Forms