Configurazioni e browser di configurazione

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

Cos'è una configurazione?

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

  • Amministratore utilizza le configurazioni come aree di lavoro all’interno di AEM per definire e gestire gruppi di impostazioni.
  • Sviluppatore utilizza il meccanismo di configurazione sottostante che implementa le configurazioni per mantenere e cercare le impostazioni in AEM.

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:

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

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

Ad esempio, un amministratore può creare due configurazioni per 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 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:

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

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

Il Browser configurazioni consente a un 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 dispone di admin diritti. admin sono inoltre necessari diritti per assegnare diritti di accesso alla configurazione o modificare in altro modo una configurazione.

Creazione di una configurazione

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

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

  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 relativi diritti di accesso

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.

  1. Accedi AEM as a Cloud Service e seleziona dal menu principale Strumenti -> Generale -> Browser di configurazione.
  2. Seleziona la configurazione da modificare, quindi tocca o fai clic su Proprietà nella barra degli strumenti.
  3. Seleziona le funzionalità aggiuntive da aggiungere alla configurazione
    NOTA

    Non è possibile deselezionare una funzione una volta creata la configurazione.

    1. Utilizza la **Autorizzazioni effettive** per visualizzare una matrice di ruoli e le autorizzazioni attualmente concesse alle configurazioni. ![Finestra delle autorizzazioni valide](/docs/experience-manager-cloud-service/assets/configuration-effective-permissions.png?lang=it)
  4. Per assegnare nuove autorizzazioni, immetti il nome utente o del gruppo nel Seleziona utente o gruppo nel campo Aggiungi nuove autorizzazioni sezione .
    • La Seleziona utente o gruppo offre il completamento automatico in base agli utenti e ai ruoli esistenti.
  5. Seleziona l’utente o il ruolo appropriato dai risultati di completamento automatico.
    • È possibile selezionare più utenti o ruoli.
  6. Controlla le opzioni di accesso che gli utenti o i ruoli selezionati devono avere e fai clic su Aggiungi.
    Aggiungere diritti di accesso a una configurazione
  7. Ripeti i passaggi per selezionare utenti o ruoli e assegnare eventuali diritti di accesso aggiuntivi.
  8. Tocca o fai clic su Salva e chiudi una volta finito.

Configurazioni come sviluppatore

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

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.

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

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

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

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:

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>
    • Configurazione specifica a cui si fa riferimento da cq:conf da qualche parte /content
    • La gerarchia è arbitraria e può essere progettata proprio come la struttura del sito, non è compito del codice dell'applicazione sapere questo
    • Modificabile in fase di esecuzione da parte degli utenti con privilegi di configurazione
  2. /conf/<siteconfig>/<parentconfig>
    • Genitori ambulanti per configurazioni di fallback
    • Modificabile in fase di esecuzione da parte degli utenti con privilegi di configurazione
  3. /conf/<siteconfig>
    • Genitori ambulanti per configurazioni di fallback
    • Modificabile in fase di esecuzione da parte degli utenti con privilegi di configurazione
  4. /conf/global
    • Impostazioni globali del sistema
    • Valori predefiniti globali di solito per l'installazione
    • Impostato da un admin ruolo
    • Modificabile in fase di esecuzione da parte degli utenti con privilegi di configurazione
  5. /apps
    • Valori predefiniti dell'applicazione
    • Risolto con l’implementazione dell’applicazione
    • Sola lettura in fase di runtime
  6. /libs
    • Valori predefiniti del prodotto AEM
    • Solo modificabile dall’Adobe, accesso al progetto non consentito
    • Risolto con l’implementazione dell’applicazione
    • Sola lettura in fase di runtime

Utilizzo delle configurazioni

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

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.

ConfMgr

Fornisci semplicemente:

  • Percorso contenuto
  • Elemento
  • User

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

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

Console web di configurazione in base al contesto

Fornisci semplicemente:

  • Percorso contenuto
  • Nome configurazione

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

In questa pagina