Configurazioni e browser di configurazione

Ultimo aggiornamento: 2023-12-04

Le configurazioni dell’AEM servono a gestire le impostazioni nell’AEM e fungono da aree di lavoro.

Cos'è una configurazione?

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

  • Un amministratore utilizza le configurazioni come aree di lavoro all’interno di 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

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

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

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

NOTA

È possibile creare configurazioni utilizzando il Browser configurazioni solo se l’utente ha admin diritti. I diritti di amministratore sono necessari anche per assegnare i diritti di accesso alla configurazione o per modificare in altro modo una configurazione.

Creazione di una configurazione

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

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

  2. Fai clic su 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. Fai clic su Crea.

SUGGERIMENTO

Le configurazioni possono essere nidificate.

Modifica delle configurazioni e dei relativi diritti di accesso

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 a AEM as a Cloud Service e dal menu principale seleziona Strumenti > Generale > Browser configurazioni.

  2. Seleziona la configurazione da modificare, quindi fai clic su Proprietà nella barra degli strumenti.

  3. Selezionate le feature aggiuntive da aggiungere alla configurazione.

    NOTA

    Una volta creata la configurazione, non è possibile deselezionare una feature.

  4. Utilizza il Autorizzazioni effettive per visualizzare una matrice di ruoli e le autorizzazioni attualmente concesse alle configurazioni.
    Finestra Autorizzazioni effettive

  5. Per assegnare nuove autorizzazioni, immetti il nome dell’utente o del gruppo nel Seleziona utente o gruppo campo in Aggiungi nuove autorizzazioni sezione.

    • Il 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. Controlla le opzioni di accesso di cui devono disporre gli utenti o i ruoli selezionati e fai 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. Seleziona Salva e chiudi quando hai finito.

Configurazioni come sviluppatore

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

Anche se il l’amministratore e gli utenti possono considerare le configurazioni come luoghi di lavoro per gestire impostazioni e contenuti diversi, è importante comprendere che le configurazioni e i contenuti vengono memorizzati e gestiti separatamente dall’AEM nell’archivio.

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

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

Esempio

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 tutta la ricerca di configurazione è una risorsa di contenuto, da qualche parte sotto /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 Conf oggetto, è possibile recuperare l'elemento di configurazione specifico desiderato. In questo caso, è dam/imageserver, che è una raccolta di impostazioni relative al imageserver. Il getItem la chiamata restituisce un ValueMap. Poi leggi un bgkcolor stringa e fornire 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, puoi assumere una cartella DAM specifica per WKND qui e una configurazione corrispondente. A partire da quella cartella /content/dam/wknd, è possibile vedere che è presente una proprietà stringa denominata cq:conf che fa riferimento alla configurazione da applicare per la sottostruttura. La proprietà è impostata su jcr:content di una cartella o pagina di risorse. Questi conf I collegamenti sono espliciti, quindi è facile seguirli semplicemente guardando il contenuto in CRXDE.

Salto all'interno /conf, puoi seguire il riferimento e vedere che è presente un’ /conf/wknd nodo. Questa è una configurazione. La ricerca è trasparente per il codice dell’applicazione. Il codice di esempio non ha mai un riferimento dedicato a esso, è nascosto dietro il Conf oggetto. La configurazione applicabile viene controllata tramite il contenuto JCR.

Puoi vedere che la configurazione contiene un settings nodo che contiene gli elementi effettivi, incluso dam/imageserver che ti serve in questo caso. Tale elemento può essere considerato come un "documento delle impostazioni" ed è rappresentato da un cq:Page incluso un jcr:content mantenendo il contenuto effettivo.

Infine, puoi vedere la proprietà bgkcolor il codice di esempio ha bisogno di. Il ValueMap torni da getItem è basato su jcr:content nodo.

Risoluzione configurazione

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 funzione, la ricerca della configurazione nell’AEM dispone di un meccanismo di ereditarietà e fallback nell’ordine di preferenza seguente:

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>
    • Configurazione specifica a cui fa riferimento cq:conf da qualche parte /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 admin ruolo
    • 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

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 nel caso descritto nell’esempio precedente.

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

Console Web di ConfMgr

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

ConfMgr

Fornisci semplicemente:

  • Percorso contenuto
  • Elemento
  • Utente

Per vedere quali configurazioni vengono risolte e ricevere un codice di esempio che le risolve, seleziona Risolvi.

Console Web di configurazione in base al contesto

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

Per recuperare i percorsi e le proprietà di contesto associati per la configurazione selezionata, seleziona Risolvi.

In questa pagina