Configurazioni e browser di configurazione configuration-browser

Le configurazioni di Adobe Experience Manager (AEM) servono per gestire le impostazioni nell’AEM e fungono da aree di lavoro.

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

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

In sintesi: dal punto di vista di un amministratore, per configurazioni si intende il modo in cui si creano le aree di lavoro per gestire le impostazioni in AEM; lo sviluppatore deve invece comprendere in che modo AEM utilizza e gestisce queste configurazioni all’interno dell’archivio.

Indipendentemente dal tuo punto di vista, le configurazioni servono a 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 gruppi di impostazioni e i relativi contenuti associati a scopo organizzativo implementando i diritti di accesso per tali funzioni.

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

Esempio administrator-example

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

L’amministratore può quindi creare modelli di pagina generali utilizzando la configurazione WKND-General e quindi modelli specifici per la rivista in 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:

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

Utilizzo del browser configurazioni using-configuration-browser

Il browser di configurazioni consente all’amministratore di creare, gestire e configurare facilmente i diritti di accesso alle configurazioni in AEM.

Creazione di una configurazione creating-a-configuration

È semplice creare una configurazione in AEM utilizzando Configuration Browser.

Modifica delle configurazioni e dei relativi diritti di accesso access-rights

Se consideri le configurazioni come aree di lavoro, puoi impostare i diritti di accesso su tali configurazioni per imporre a chi può o meno accedere a tali aree di lavoro.

Configurazioni come sviluppatore configurations-developer

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

Separazione di configurazione e contenuto separation-of-config-and-content

Anche se l'amministratore e gli utenti possono considerare le configurazioni come aree di lavoro per gestire impostazioni e contenuti diversi, è importante comprendere che le configurazioni e i contenuti sono archiviati e gestiti separatamente dall'AEM nell'archivio.

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

Esempio developer-example

Per questo esempio, supponiamo che tu disponga di un codice dell’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 in /content. Potrebbe trattarsi di una pagina, di un componente all’interno di una pagina, di una risorsa o di una cartella DAM. Si tratta del contenuto effettivo per il quale stai cercando la configurazione corretta che si applica in questo contesto.

Ora con l'oggetto Conf a portata di mano, puoi recuperare l'elemento di configurazione specifico che ti interessa. In questo caso è dam/imageserver, ovvero una raccolta di impostazioni relative a imageserver. La chiamata getItem restituisce un ValueMap. Quindi leggi una proprietà stringa bgkcolor e fornisci 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/wknd
    + settings
      + dam
        + imageserver [cq:Page]
          + jcr:content
            - bgkcolor = "FF0000"

In questo esempio, puoi assumere una cartella DAM specifica per WKND qui e una configurazione corrispondente. A partire dalla cartella /content/dam/wknd, è possibile vedere che esiste una proprietà stringa denominata cq:conf che fa riferimento alla configurazione applicata alla sottostruttura. La proprietà è impostata su jcr:content di una cartella risorse o di una pagina. Questi collegamenti conf sono espliciti, quindi è facile seguirli semplicemente guardando il contenuto in CRXDE.

Saltando all'interno di /conf, seguire il riferimento e verificare che sia presente un nodo /conf/wknd. Questa è una configurazione. La ricerca è trasparente per il codice dell’applicazione. Il codice di esempio non dispone mai di un riferimento dedicato, ma è nascosto dietro l'oggetto Conf. La configurazione applicabile viene controllata tramite il contenuto JCR.

La configurazione contiene un nodo settings a nome fisso che contiene gli elementi effettivi, inclusi dam/imageserver necessari in questo caso. Tale elemento può essere considerato come un "documento impostazioni" ed è rappresentato da un cq:Page che include un jcr:content che contiene il contenuto effettivo.

Viene infine visualizzata la proprietà bgkcolor necessaria per questo codice di esempio. Il ValueMap recuperato da getItem si basa sul nodo jcr:content della pagina.

Risoluzione configurazione configuration-resolution

L’esempio di base precedente mostrava una singola configurazione. Tuttavia, in molti casi è necessario disporre di configurazioni diverse, ad esempio una configurazione globale predefinita, una diversa per ogni marchio e forse una specifica per i sottoprogetti.

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

Utilizzo delle configurazioni using-configurations

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

Per ulteriori dettagli su configurazioni in base al contesto, esempi e modalità di utilizzo, consulta la documentazione di Sling..

Console Web di ConfMgr confmgr-web-console

A scopo di debug e test, è disponibile una console Web ConfMgr in 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 ottenere esempi di codice utili per risolverle.

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

A scopo di debug e test, è disponibile una console Web Configurazione in base al contesto in 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 e le proprietà di contesto associati per la configurazione selezionata.