Configurazioni e browser di configurazione

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 nuova pagina per la rivista, può scegliere tra modelli generali (WKND-General) o modelli di rivista (WKND-Magazine).
  • Quando un autore di contenuti crea una nuova 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. admin sono necessari anche diritti per assegnare diritti di accesso alla configurazione o per modificare in altro modo una configurazione.

Creazione di una configurazione

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

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

  2. Tocca o fai clic su Crea.

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

    Creare la configurazione

    • Il titolo deve essere descrittivo.
    • Il nome diventerà il nome del nodo nell’archivio.
  4. Controlla il tipo di configurazioni che desideri consentire.

  5. Tocca o 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 al fine di stabilire 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 tocca o fai clic su Proprietà nella barra degli strumenti.
  3. Seleziona le funzioni aggiuntive da aggiungere alla configurazione
    NOTA

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

    1. Utilizza il **Autorizzazioni effettive** per visualizzare una matrice di ruoli e le autorizzazioni attualmente concesse alle configurazioni. ![Finestra Autorizzazioni effettive](/docs/experience-manager-65/assets/configuration-effective-permissions.png?lang=it)
  4. 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.
  5. Selezionare l'utente o il ruolo appropriato dai risultati di completamento automatico.
    • È possibile selezionare più utenti o ruoli.
  6. 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
  7. Ripeti i passaggi per selezionare utenti o ruoli e assegnare diritti di accesso aggiuntivi, in base alle esigenze.
  8. Tocca o fai clic su Salva e chiudi al termine.

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à. AEM esegue una ricerca in base al contenuto ed è contestuale 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 tutte le ricerche di configurazione è una risorsa di contenuto, in genere posizionata sotto /content. Potrebbe 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 Conf oggetto, possiamo recuperare l’elemento di configurazione specifico che ci interessa. In questo caso è dam/imageserver, che è una raccolta di impostazioni relative al imageserver. Il getItem la chiamata restituisce un ValueMap. Quindi leggiamo 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, si assume qui una cartella DAM specifica per WKND e una configurazione corrispondente. A partire da quella cartella /content/dam/wknd, verrà visualizzata una proprietà stringa denominata cq:conf che fa riferimento alla configurazione da applicare per la sottostruttura. La proprietà viene in genere 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, 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 applicabile è completamente controllata tramite il contenuto JCR.

Vediamo che la configurazione contiene un settings nodo che contiene gli elementi effettivi, incluso dam/imageserver nel nostro caso abbiamo bisogno. Un elemento di questo tipo può essere considerato come un "documento impostazioni" e in genere è rappresentato da un cq:Page incluso un jcr:content mantenendo il contenuto effettivo.

Infine, vediamo la proprietà bgkcolor di cui il nostro codice di esempio ha bisogno. Il ValueMap torniamo 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 in AEM ha 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
    • Di solito impostazioni 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
  • User

Clic Risolvi per vedere quali configurazioni vengono risolte e ricevere il codice di esempio che le risolverà.

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

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

In questa pagina