Uso do Sling Resource Merger no AEM as a Cloud Service using-the-sling-resource-merger-in-aem

Sobreposições de recursos usando os caminhos de pesquisa.

Substitui das caixas de diálogo de componente para a interface habilitada para toque (cq:dialog), usando a hierarquia de tipo de recurso (por meio da propriedade sling:resourceSuperType).

O conteúdo da definição personalizada tem uma prioridade mais alta que a do original (ou seja, sobreposições ou substituições).

Quando necessário, as propriedades definidas na personalização indicam como o conteúdo mesclado do original será usado.

verifique se as alterações de personalização não foram feitas em /libs.

reduza a estrutura replicada de /libs.

Ao usar o Sling Resource Merger, não é recomendável copiar toda a estrutura de /libs, pois isso resultaria em muitas informações mantidas na personalização (geralmente /apps). Duplicar informações aumenta desnecessariamente a chance de problemas quando o sistema é atualizado de alguma forma.

sling:hideProperties ( String ou String[])

Especifica a propriedade, ou lista de propriedades, a ser ocultada.

O curinga * oculta tudo.

sling:hideResource ( Boolean)

Indica se os recursos devem ser completamente ocultos, incluindo seus filhos.

sling:hideChildren ( String ou String[])

Contém o nó filho, ou lista de nós filhos, a ser ocultado. As propriedades do nó são mantidas.

O curinga * oculta tudo.

sling:orderBefore ( String)

Contém o nome do nó irmão no qual o nó atual deve ser posicionado.

Sobreposição

• A definição da entrada de navegação do console Sites, como mostrado no painel, é definida em:

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

• Para sobrepor isso, crie o seguinte nó:

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

  Em seguida, atualize a propriedade jcr:title, conforme necessário.

Substituir

• A definição da caixa de diálogo habilitada para toque do console de Textos está definida em:

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

• Para substituir isso, crie o seguinte nó - por exemplo:

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

Adicionar uma propriedade

A propriedade não existe na definição /libs, mas é necessária na sobreposição/substituição /apps.

1. Criar o nó correspondente em /apps
2. Criar a nova propriedade neste nó "

Redefinir uma propriedade (não propriedades criadas automaticamente)

A propriedade está definida em /libs, mas um novo valor é necessário na sobreposição/substituição /apps.

1. Criar o nó correspondente em /apps

2. Criar a propriedade correspondente neste nó (em / apps)

   • A propriedade terá uma prioridade com base na configuração do Sling Resource Resolver.

   • Não há suporte para a alteração do tipo de propriedade.

     Se você usar um tipo de propriedade diferente daquele usado em /libs, o tipo de propriedade definido será usado.

Redefinir uma propriedade criada automaticamente

Por padrão, as propriedades criadas automaticamente (como jcr:primaryType) não estão sujeitas a uma sobreposição/substituição para garantir que o tipo de nó atualmente em /libs seja respeitado. Para impor uma sobreposição/substituição, é necessário recriar o nó em /apps, ocultar explicitamente a propriedade e redefini-la:

1. Crie o nó correspondente em /apps com o jcr:primaryType desejado

2. Crie a propriedade sling:hideProperties nesse nó, com o valor definido como aquele da propriedade criada automaticamente; por exemplo, jcr:primaryType

   Esta propriedade, definida em /apps, terá prioridade sobre aquela definida em /libs

Redefinir um nó e seus filhos

O nó e seus filhos estão definidos em /libs, mas uma nova configuração é necessária na sobreposição/substituição /apps.

1. Combine as ações de:

   1. Ocultar filhos de um nó (mantendo as propriedades do nó)
   2. Redefinir a propriedade/as propriedades

Ocultar uma propriedade

A propriedade está definida em /libs, mas não é necessária na sobreposição/substituição de /apps.

1. Criar o nó correspondente em /apps

2. Crie uma propriedade sling:hideProperties do tipo String ou String[]. Use esta opção para especificar as propriedades que devem ser ocultas/ignoradas. Curingas também podem ser usados. Por exemplo:

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

Ocultar um nó e seus filhos

O nó e seus filhos estão definidos em /libs, mas não são necessários na sobreposição/substituição /apps.

1. Crie o nó correspondente em /apps

2. Criar uma propriedade sling:hideResource

   • tipo: Boolean
   • valor: true

Ocultar filhos de um nó (ao manter as propriedades do nó)

O nó, suas propriedades e seus filhos estão definidos em /libs. O nó e suas propriedades são necessários na sobreposição/substituição /apps, mas alguns ou todos os nós filhos não são necessários na sobreposição/substituição /apps.

1. Criar o nó correspondente em /apps

2. Criar a propriedade sling:hideChildren:

   • tipo: String[]
   • value: uma lista dos nós filhos (conforme definido em /libs) a serem ocultados/ignorados

   O curinga * pode ser usado para ocultar/ignorar todos os nós filhos.

Reordenar nós

O nó e seus irmãos estão definidos em /libs. Uma nova posição é necessária para que o nó seja recriado na sobreposição/substituição /apps, onde a nova posição é definida em referência ao nó irmão apropriado em /libs.

• Usar a propriedade sling:orderBefore:

  1. Criar o nó correspondente em /apps

  2. Criar a propriedade sling:orderBefore:

     Isso especifica o nó (como em /libs) que o nó atual deve ser posicionado antes:

     • tipo: String
     • valor: <before-SiblingName>

Sobreposição:

• finalidade: mesclar recursos com base no caminho de pesquisa

• ponto de montagem: /mnt/overlay

• uso: mount point + relative path

• exemplo:

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

Substituir:

• finalidade: mesclar recursos com base em seu supertipo

• ponto de montagem: /mnt/overide

• uso: mount point + absolute path

• exemplo:

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