Configurazioni e browser di configurazione

AEM configurazioni servono a gestire le impostazioni in AEM e fungono da aree di lavoro.

Cos'è una configurazione?

Una configurazione può essere considerata da due diversi punti di vista.

• Un amministratore utilizza le configurazioni come aree di lavoro all’interno di AEM per definire e gestire i gruppi di impostazioni.
• Uno sviluppo utilizza il meccanismo di configurazione sottostante che implementa le configurazioni per mantenere e cercare le impostazioni in AEM.

In sintesi: dal punto di vista dell'amministratore, le configurazioni sono il modo in cui si creano le aree di lavoro per gestire le impostazioni in AEM, mentre lo sviluppatore deve comprendere come AEM utilizza e gestisce tali configurazioni all'interno del repository.

Indipendentemente dal vostro punto di vista, le configurazioni servono a due scopi principali in AEM:

• Le configurazioni attivano alcune funzioni per alcuni gruppi di utenti.
• Le configurazioni definiscono i diritti di accesso per tali funzioni.

Configurazioni come amministratore

Sia l’amministratore AEM che gli autori possono considerare le configurazioni come aree di lavoro. Tali aree di lavoro possono essere utilizzate per raccogliere insieme gruppi di impostazioni e il relativo contenuto a scopo organizzativo, implementando i diritti di accesso per tali funzioni.

Le configurazioni possono essere create per molte funzioni diverse all'interno di AEM.

• Configurazioni cloud
• Segmenti di Context Hub
• Modelli per frammenti di contenuto
• Modelli modificabili

Esempio

Ad esempio, un amministratore può creare due configurazioni per Modelli modificabili.

• WKND - Generale
• WKND-Magazine

L’amministratore può quindi creare modelli di pagina generali utilizzando la configurazione WKND-General e quindi modelli specifici per la rivista sotto WKND-Magazine.

L’amministratore può quindi associare il WKND-General a tutto il contenuto del sito WKND. Tuttavia, la configurazione WKND-Magazine sarebbe associata solo al sito della rivista.

In questo modo:

• Quando un autore crea una nuova pagina per la rivista, può scegliere tra modelli generali (WKND-General) o modelli di rivista (WKND-Magazine).
• Quando un autore crea una nuova pagina per un’altra parte del sito che non è la rivista, può scegliere solo tra i modelli generali (WKND-General).

Impostazioni simili sono possibili non solo per i modelli modificabili, ma anche per le configurazioni cloud, i segmenti ContextHub e i modelli di frammenti di contenuto.

Utilizzo del browser di configurazione

Il Browser di configurazione consente agli amministratori di creare, gestire e configurare facilmente i diritti di accesso alle configurazioni in AEM.

Creazione di una configurazione

È molto semplice creare una nuova configurazione in AEM utilizzando il browser di configurazione.

1. Accedete AEM come Cloud Service e dal menu principale selezionate Strumenti -> Generale -> Browser di configurazione.

2. Tocca o fai clic su Crea.

3. Specificare un Titolo e un Nome per la configurazione.

   

   • Il Titolo deve essere descrittivo.
   • Il Nome diventerà il nome del nodo nella directory archivio.
     • Verrà generato automaticamente in base al titolo e verrà modificato in base alle convenzioni di denominazione AEM.
     • Può essere regolato se necessario.

4. Verificare il tipo di configurazioni che si desidera consentire.

   • Configurazioni cloud
   • Segmenti di Context Hub
   • Modelli per frammenti di contenuto
   • Modelli modificabili

5. Tocca o fai clic su Crea.

Modifica delle configurazioni e relativi diritti di accesso

Se si considerano le configurazioni come aree di lavoro, è possibile impostare i diritti di accesso su tali configurazioni per applicare a chi potrebbero accedere o meno tali aree di lavoro.

1. Accedete AEM come Cloud Service e dal menu principale selezionate Strumenti -> Generale -> Browser di configurazione.
2. Selezionate la configurazione da modificare, quindi toccate o fate clic su Proprietà nella barra degli strumenti.
3. Selezionare le funzioni aggiuntive da aggiungere alla configurazione
   NOTA

   Non è possibile deselezionare una funzione dopo la creazione della configurazione.

   1. Utilizzate il pulsante **Autorizzazioni effettive** per visualizzare una matrice di ruoli e quali autorizzazioni sono attualmente concesse alle configurazioni. 
4. Per assegnare nuove autorizzazioni, immettete il nome utente o del gruppo nel campo Seleziona utente o gruppo nella sezione Aggiungi nuove autorizzazioni.
   • Il campo Seleziona utente o gruppo offre il completamento automatico in base agli utenti e ai ruoli esistenti.
5. Selezionate l’utente o il ruolo appropriato dai risultati di completamento automatico.
   • Potete selezionare più utenti o ruoli.
6. Verificare le opzioni di accesso che devono essere disponibili per gli utenti o i ruoli selezionati e fare clic su Aggiungi.
   
7. Ripetete i passaggi per selezionare utenti o ruoli e assegnare diritti di accesso aggiuntivi, a seconda delle necessità.
8. Toccate o fate clic su Salva e chiudi al termine.

Configurazioni come sviluppatore

In qualità di sviluppatore, è importante sapere come AEM come Cloud Service funziona con le configurazioni e come elabora la risoluzione della configurazione.

Separazione di configurazione e contenuto

Sebbene l'amministratore e gli utenti di possano pensare alle configurazioni come luoghi di lavoro per gestire diverse impostazioni e contenuti, è importante comprendere che le configurazioni e i contenuti sono memorizzati e gestiti separatamente da AEM nella directory archivio.

• /content è la pagina principale di tutti i contenuti.
• /conf è la casa di tutte le configurazioni.

Il contenuto fa riferimento alla configurazione associata tramite una proprietà cq:conf. AEM eseguire una ricerca in base al contenuto ed è una proprietà contestuale cq:conf per trovare la configurazione appropriata.

Esempio

Per questo esempio, supponiamo che tu abbia del codice applicativo interessato alle impostazioni DAM.

Conf conf = resource.adaptTo(Conf.class);
ValueMap imageServerSettings = conf.getItem("dam/imageserver");
String bgkcolor = imageServerSettings.get("bgkcolor", "FFFFFF");

Il punto di partenza di tutte le ricerche di configurazione è una risorsa di contenuto, in genere in un punto /content. Può trattarsi di una pagina, di un componente all’interno di una pagina, di una risorsa o di una cartella DAM. Questo è il contenuto effettivo per il quale stiamo cercando la configurazione giusta che si applica in questo contesto.

Ora con l'oggetto Conf in mano, possiamo recuperare l'elemento di configurazione specifico a cui siamo interessati. In questo caso è dam/imageserver, ovvero una raccolta di impostazioni relative alla imageserver. La chiamata getItem restituisce un elemento ValueMap. Quindi si legge una proprietà stringa bgkcolor e si fornisce il valore predefinito "FFFFFF" nel caso in cui la proprietà (o l'intero elemento di configurazione) non sia presente.

Ora diamo un'occhiata al contenuto JCR corrispondente:

/content/dam/wknd
    + jcr:content
      - cq:conf = "/conf/wknd"
    + image.png [dam:Asset]

/conf/wkns
    + settings
      + dam
        + imageserver [cq:Page]
          + jcr:content
            - bgkcolor = "FF0000"

In questo esempio, si presuppone una cartella DAM specifica per WKND e una configurazione corrispondente. A partire da tale cartella /content/dam/wknd, verrà visualizzata una proprietà stringa denominata cq:conf che fa riferimento alla configurazione da applicare alla sottostruttura. La proprietà viene in genere impostata su jcr:content di una cartella di risorse o di una pagina. Questi collegamenti conf sono espliciti, quindi è facile seguirli semplicemente guardando il contenuto in CRXDE.

Saltando all'interno di /conf, seguiamo il riferimento e vediamo che c'è un nodo /conf/wknd. Questa è una configurazione. La ricerca è completamente trasparente per il codice dell'applicazione. Il codice di esempio non ha mai un riferimento dedicato ad esso, è nascosto dietro l'oggetto Conf. La configurazione applicata è completamente controllata attraverso il contenuto JCR.

La configurazione contiene un nodo settings con nome fisso che contiene gli elementi effettivi, incluso il dam/imageserver di cui abbiamo bisogno nel nostro caso. Tale elemento può essere considerato come un "documento delle impostazioni" ed è in genere rappresentato da un cq:Page che include un jcr:content contenente il contenuto effettivo.

Infine, viene visualizzata la proprietà bgkcolor necessaria per il codice di esempio. Il ValueMap che recuperiamo da getItem è basato sul nodo jcr:content della pagina.

Risoluzione di configurazione

L'esempio di base sopra mostrava una singola configurazione. Ma ci sono molti casi in cui si desidera avere configurazioni diverse, come una configurazione globale predefinita, una diversa per ogni marchio e forse una specifica per i sottoprogetti.

Per supportare questo, la ricerca di configurazione in AEM ha meccanismi di ereditarietà e fallback nell'ordine di preferenza seguente:

1. /conf/<siteconfig>/<parentconfig>/<myconfig>
   • Configurazione specifica di cui si fa riferimento da cq:conf in un punto qualsiasi di /content
   • La gerarchia è arbitraria e può essere progettata proprio come la struttura del sito, non è compito del codice applicazione sapere questo
   • Modificabile in fase di esecuzione dagli utenti con privilegi di configurazione
2. /conf/<siteconfig>/<parentconfig>
   • Traversare i genitori per le configurazioni di fallback
   • Modificabile in fase di esecuzione dagli utenti con privilegi di configurazione
3. /conf/<siteconfig>
   • Traversare i genitori per le configurazioni di fallback
   • Modificabile in fase di esecuzione dagli utenti con privilegi di configurazione
4. /conf/global
   • Impostazioni globali del sistema
   • Generalmente, impostazioni predefinite globali per l’installazione
   • Impostato da un ruolo admin
   • Modificabile in fase di esecuzione dagli utenti con privilegi di configurazione
5. /apps
   • Impostazioni predefinite applicazione
   • Problema risolto con la distribuzione dell’applicazione
   • Sola lettura in fase di esecuzione
6. /libs
   • AEM predefiniti del prodotto
   • Modificabile solo da Adobe, accesso al progetto non consentito
   • Problema risolto con la distribuzione dell’applicazione
   • Sola lettura in fase di esecuzione

Utilizzo delle configurazioni

Le configurazioni in AEM si basano sulle configurazioni Sling Context-Aware. I bundle Sling forniscono un'API di servizio che può essere utilizzata per ottenere configurazioni basate sul contesto. Per configurazioni basate sul contesto si intendono le configurazioni correlate a una risorsa di contenuto o a una struttura di risorse, come descritto nell'esempio precedente.🔗

Per ulteriori dettagli sulle configurazioni, gli esempi e le modalità di utilizzo in base al contesto, consultare la documentazione Sling.🔗

Console Web di ConfMgr

A scopo di debug e test, è disponibile una ConfMgr console Web all'indirizzo https://<host>:<port>/system/console/conf, che può mostrare le configurazioni per un determinato percorso/elemento.

È sufficiente fornire:

• Percorso contenuto
• Elemento
• User

Fare clic su Risolvi per vedere quali configurazioni vengono risolte e ricevere il codice di esempio che risolverà tali configurazioni.

Console Web di configurazione in base al contesto

A scopo di debug e test, è disponibile una console di configurazione in base al contesto all'indirizzo https://<host>:<port>/system/console/slingcaconfig, che consente di eseguire query sulle configurazioni in base al contesto nell'archivio e di visualizzarne le proprietà.

È sufficiente fornire:

• Percorso contenuto
• Nome configurazione

Fare clic su Risolvi per recuperare i percorsi contestuali associati e le proprietà per la configurazione selezionata.