Configurazioni e browser di configurazione configuration-browser

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

Cos'è una configurazione? what-is-a-configuration

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

In sintesi: dal punto di vista di un 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 queste configurazioni all'interno dell'archivio.

Indipendentemente dal tuo punto di vista, le configurazioni hanno due scopi principali in AEM:

Configurazioni come amministratore configurations-administrator

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

È possibile creare configurazioni per molte funzioni diverse all’interno di AEM.

Esempio administrator-example

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

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 tutti i contenuti del sito WKND. Tuttavia, la configurazione WKND-Magazine verrebbe associata solo al sito della rivista.

Facendo questo:

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 using-configuration-browser

Il Browser configurazioni consente a un amministratore di creare, gestire e configurare facilmente i diritti di accesso alle configurazioni in AEM.

Creazione di una configurazione creating-a-configuration

È molto semplice creare una nuova configurazione in AEM utilizzando il Browser configurazioni.

Modifica delle configurazioni e relativi diritti di accesso access-rights

Se si considerano le configurazioni come aree di lavoro, è possibile impostare i diritti di accesso a tali configurazioni in modo da imporre a chi può accedere o meno a tali aree di lavoro.

Configurazioni come sviluppatore configurations-developer

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

Separazione della configurazione e del contenuto separation-of-config-and-content

Anche se la amministratori e utenti possono considerare le 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 nell’archivio.

Il contenuto fa riferimento alla configurazione associata tramite una cq:conf proprietà. AEM esegue una ricerca basata sul contenuto ed è contestuale cq:conf per trovare la configurazione appropriata.

Esempio developer-example

Per questo esempio, supponiamo che tu disponga di un codice applicazione interessato alle impostazioni DAM.

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

Il punto iniziale di tutte le ricerche di configurazione è una risorsa di contenuto, di solito in un punto qualsiasi sotto /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 corretta che si applica in questo contesto.

Ora con il Conf oggetto in mano, possiamo recuperare l'elemento di configurazione specifico che ci interessa. In questo caso è dam/imageserver, che è una raccolta di impostazioni relative al imageserver. La getItem la chiamata restituisce un ValueMap. Poi abbiamo letto un bgkcolor proprietà stringa e fornire un valore predefinito di "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 WKND qui e una configurazione corrispondente. Avvio da quella cartella /content/dam/wknd, viene visualizzata una proprietà stringa denominata cq:conf che fa riferimento alla configurazione da applicare alla sottostruttura. La proprietà viene in genere impostata sul jcr:content di una cartella di risorse o di una pagina. Tali conf i collegamenti sono espliciti, quindi è facile seguirli semplicemente guardando il contenuto in CRXDE.

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

Viene visualizzata la configurazione contenente un nome fisso settings che contiene gli elementi effettivi, tra cui dam/imageserver abbiamo bisogno nel nostro caso. Tale elemento può essere considerato come un "documento delle impostazioni" ed è solitamente rappresentato da un cq:Page compreso un jcr:content contenente il contenuto effettivo.

Infine, vediamo la proprietà bgkcolor di cui il nostro codice di esempio ha bisogno. La ValueMap torniamo da getItem è basato sul jcr:content nodo.

Risoluzione della configurazione configuration-resolution

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

Per supportare questo, la ricerca di configurazione in AEM dispone di un meccanismo di ereditarietà e fallback nell’ordine di preferenza seguente:

Utilizzo delle configurazioni using-configurations

Le configurazioni in AEM si basano su configurazioni in base al contesto Sling. I bundle Sling forniscono un'API di servizio che può essere utilizzata per ottenere configurazioni basate sul contesto. Le configurazioni in base al contesto sono configurazioni correlate a una risorsa di contenuto o a una struttura di risorse, così come era descritto nell'esempio precedente.

Per ulteriori dettagli sulle configurazioni in base al contesto, sugli esempi e su come utilizzarle, consulta la documentazione Sling .

Console Web ConfMgr confmgr-web-console

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

Fornisci semplicemente:

Fai clic su Risolvi per vedere quali configurazioni vengono risolte e ricevere un codice di esempio che risolva tali configurazioni.

Console Web di configurazione in base al contesto context-aware-web-console

A scopo di debug e test, è disponibile un Configurazione in base al contesto console web 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à.

Fornisci semplicemente:

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