Utilizzo di Sling Resource Merger in AEM as a Cloud Service using-the-sling-resource-merger-in-aem

Sovrapposizioni di risorse utilizzando percorsi di ricerca.

Esegue l'override delle finestre di dialogo dei componenti per l'interfaccia utente touch (cq:dialog), utilizzando la gerarchia dei tipi di risorsa (tramite la proprietà sling:resourceSuperType).

Il contenuto della definizione personalizzata ha una priorità più alta di quella dell'originale (ovvero sovrapposizioni o sostituzioni).

Se necessario, proprietà definite nella personalizzazione, indicano come deve essere utilizzato il contenuto unito dall'originale.

assicurarsi che le modifiche di personalizzazione non vengano apportate in /libs.

ridurre la struttura replicata da /libs.

Quando si utilizza Sling Resource Merger, non è consigliabile copiare l'intera struttura da /libs in quanto ciò comporterebbe la memorizzazione di troppe informazioni nella personalizzazione (in genere /apps). La duplicazione delle informazioni aumenta inutilmente la possibilità di problemi quando il sistema viene aggiornato in qualsiasi modo.

sling:hideProperties ( String o String[])

Specifica la proprietà o l'elenco di proprietà da nascondere.

Il carattere jolly * nasconde tutto.

sling:hideResource ( Boolean)

Indica se le risorse devono essere completamente nascoste, inclusi i relativi elementi secondari.

sling:hideChildren ( String o String[])

Contiene il nodo figlio, o elenco di nodi figlio, da nascondere. Le proprietà del nodo vengono mantenute.

Il carattere jolly * nasconde tutto.

sling:orderBefore ( String)

Contiene il nome del nodo di pari livello che deve essere posizionato davanti al nodo corrente.

Sovrapposizione

• La definizione della voce di navigazione per la console Sites, come mostrato nella barra, è definita in:

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

• Per sovrapporsi, crea il seguente nodo:

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

  Quindi aggiornare la proprietà jcr:title come richiesto.

Sostituisci

• La definizione della finestra di dialogo touch per la console Testi è definita in:

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

• Per evitare questo problema, crea il seguente nodo, ad esempio:

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

Aggiungi una proprietà

La proprietà non esiste nella definizione /libs, ma è obbligatoria nella sovrapposizione/sostituzione /apps.

1. Crea il nodo corrispondente in /apps
2. Crea la nuova proprietà su questo nodo "

Ridefinire una proprietà (proprietà non create automaticamente)

La proprietà è definita in /libs, ma è necessario un nuovo valore nella sovrapposizione/sostituzione /apps.

1. Crea il nodo corrispondente in /apps

2. Crea la proprietà corrispondente su questo nodo (in / apps)

   • La proprietà avrà una priorità in base alla configurazione di Sling Resource Resolver.

   • È supportata la modifica del tipo di proprietà.

     Se si utilizza un tipo di proprietà diverso da quello utilizzato in /libs, verrà utilizzato il tipo di proprietà definito.

Ridefinire una proprietà creata automaticamente

Per impostazione predefinita, le proprietà create automaticamente (come jcr:primaryType) non sono soggette a sovrapposizione/sostituzione per garantire che il tipo di nodo attualmente in /libs sia rispettato. Per imporre una sovrapposizione/sostituzione è necessario ricreare il nodo in /apps, nascondere esplicitamente la proprietà e ridefinirla:

1. Crea il nodo corrispondente in /apps con jcr:primaryType desiderato

2. Creare la proprietà sling:hideProperties su tale nodo, con il valore impostato su quello della proprietà creata automaticamente, ad esempio jcr:primaryType

   Questa proprietà, definita in /apps, avrà ora la priorità rispetto a quella definita in /libs

Ridefinire un nodo e i relativi elementi secondari

Il nodo e i relativi nodi secondari sono definiti in /libs, ma è necessaria una nuova configurazione nella sovrapposizione/esclusione di /apps.

1. Combina le azioni di:

   1. Nascondi elementi figlio di un nodo (mantenendo le proprietà del nodo)
   2. Ridefinisci la/le proprietà

Nascondi una proprietà

La proprietà è definita in /libs, ma non è richiesta nella sostituzione/sovrapposizione di /apps.

1. Crea il nodo corrispondente in /apps

2. Creare una proprietà sling:hideProperties di tipo String o String[]. Utilizzare questa opzione per specificare le proprietà da nascondere/ignorare. È inoltre possibile utilizzare i caratteri jolly. Ad esempio:

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

Nascondi un nodo e i relativi elementi secondari

Il nodo e i relativi nodi secondari sono definiti in /libs, ma non sono obbligatori nella sovrapposizione/esclusione di /apps.

1. Crea il nodo corrispondente in /apps

2. Crea una proprietà sling:hideResource

   • tipo: Boolean
   • valore: true

Nascondi elementi figlio di un nodo (mantenendo le proprietà del nodo)

Il nodo, le relative proprietà e i relativi elementi figlio sono definiti in /libs. Il nodo e le relative proprietà sono obbligatori nella sovrapposizione/sostituzione /apps, ma alcuni o tutti i nodi figlio non sono obbligatori nella sovrapposizione/sostituzione /apps.

1. Crea il nodo corrispondente in /apps

2. Creare la proprietà sling:hideChildren:

   • tipo: String[]
   • valore: elenco dei nodi figlio (come definiti in /libs) da nascondere/ignorare

   Il carattere jolly * può essere utilizzato per nascondere/ignorare tutti i nodi figlio.

Riordina nodi

Nodo e relativi elementi di pari livello definiti in /libs. È necessaria una nuova posizione in modo che il nodo venga ricreato nella sovrapposizione/sostituzione /apps, dove la nuova posizione viene definita in riferimento al nodo di pari livello appropriato in /libs.

• Utilizzare la proprietà sling:orderBefore:

  1. Crea il nodo corrispondente in /apps

  2. Creare la proprietà sling:orderBefore:

     Specifica il nodo (come in /libs) in cui posizionare il nodo corrente prima di:

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

Sovrapposizione:

• finalità: unire le risorse in base al relativo percorso di ricerca

• punto di montaggio: /mnt/overlay

• utilizzo: mount point + relative path

• esempio:

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

Sostituisci:

• finalità: unire le risorse in base al loro super tipo

• punto di montaggio: /mnt/overide

• utilizzo: mount point + absolute path

• esempio:

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