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.

  • Un amministratore utilizza le configurazioni come aree di lavoro in AEM per definire e gestire gruppi di impostazioni.
  • Uno sviluppatore utilizza il meccanismo di configurazione sottostante che implementa le configurazioni per mantenere e cercare le impostazioni nell'AEM.

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:

  • Le configurazioni abilitano determinate funzioni per determinati gruppi di utenti.
  • Le configurazioni definiscono i diritti di accesso per tali funzioni.

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.

  • 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 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:

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

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.

NOTE
È possibile creare configurazioni utilizzando il Browser configurazioni solo se l'utente dispone dei diritti admin. Tali diritti admin sono necessari anche per assegnare diritti di accesso alla configurazione o per modificare in altro modo una configurazione.

Creazione di una configurazione creating-a-configuration

È semplice creare una configurazione in AEM utilizzando Configuration Browser.

  1. Accedi ad AEM as a Cloud Service e dal menu principale seleziona Strumenti > Generale > Browser configurazioni.

  2. Seleziona Crea.

  3. Specifica il titolo e il nome da assegnare alla configurazione.

    Crea configurazione

    • Il titolo deve essere descrittivo.

    • Il nome diventa il nome del nodo nell’archivio.

  4. Controlla il tipo di configurazioni che desideri consentire.

  5. Seleziona Crea.

TIP
Le configurazioni possono essere nidificate.

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.

  1. Accedi ad AEM as a Cloud Service e dal menu principale seleziona Strumenti > Generale > Browser configurazioni.

  2. Selezionare la configurazione da modificare, quindi selezionare Proprietà nella barra degli strumenti.

  3. Selezionate le feature aggiuntive da aggiungere alla configurazione.

    note note
    NOTE
    Una volta creata la configurazione, non è possibile deselezionare una feature.
  4. Utilizza il pulsante Autorizzazioni effettive per visualizzare una matrice di ruoli e le autorizzazioni attualmente concesse alle configurazioni.
    Finestra autorizzazioni effettive

  5. Per assegnare nuove autorizzazioni, immettere il nome dell'utente o del gruppo nel campo Seleziona utente o gruppo della sezione Aggiungi nuove autorizzazioni.

    • Il campo Seleziona utente o gruppo offre il completamento automatico in base agli utenti e ai ruoli esistenti.
  6. Selezionare l'utente o il ruolo appropriato dai risultati di completamento automatico.

    • È possibile selezionare più utenti o ruoli.
  7. Verificare le opzioni di accesso che uno o più utenti o ruoli selezionati devono avere e fare clic su Aggiungi.
    Aggiungere diritti di accesso a una configurazione

  8. Ripeti i passaggi in modo da poter selezionare utenti o ruoli e assegnare diritti di accesso aggiuntivi in base alle esigenze.

  9. Al termine, seleziona Salva e chiudi.

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.

  • /content è la home page di tutti i contenuti.
  • /conf è la home di tutte le configurazioni.

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:

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>

    • Configurazione specifica a cui si fa riferimento da cq:conf in /content
    • La gerarchia è arbitraria e può essere progettata proprio come la struttura del sito, questo non è l'attività del codice dell'applicazione
    • Modificabile in fase di runtime da utenti con privilegi di configurazione
  2. /conf/<siteconfig>/<parentconfig>

    • Esamina i padri per le configurazioni di fallback
    • Modificabile in fase di runtime da utenti con privilegi di configurazione
  3. /conf/<siteconfig>

    • Esamina i padri per le configurazioni di fallback
    • Modificabile in fase di runtime da utenti con privilegi di configurazione
  4. /conf/global

    • Impostazioni globali del sistema
    • Valori predefiniti globali per l'installazione
    • Impostato da un ruolo admin
    • Modificabile in fase di runtime da utenti con privilegi di configurazione
  5. /apps

    • Valori predefiniti applicazione
    • Risolto con l’implementazione dell’applicazione
    • Sola lettura in fase di runtime
  6. /libs

    • Valori predefiniti dei prodotti AEM
    • Modificabile solo da Adobe, accesso al progetto non consentito
    • Risolto con l’implementazione dell’applicazione
    • Sola lettura in fase di runtime

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.

ConfMgr

Fornisci semplicemente:

  • Percorso contenuto
  • Elemento
  • Utente

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à.

Console Web di configurazione in base al contesto

Fornisci semplicemente:

  • Percorso contenuto
  • Nome configurazione

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab