Configuraties en de Configuratiebrowser configuration-browser

AEM configuraties dienen om instellingen in AEM te beheren en dienen als werkruimten.

Wat is een Configuratie? what-is-a-configuration

Een configuratie kan vanuit twee verschillende gezichtspunten worden overwogen.

Samenvattend: vanuit het standpunt van een beheerder, zijn de configuraties hoe u werkruimten creeert om montages in AEM te beheren, terwijl de ontwikkelaar zou moeten begrijpen hoe AEM deze configuraties binnen de bewaarplaats gebruikt en beheert.

Configuraties hebben, ongeacht uw perspectief, twee hoofddoelen in AEM:

Configuraties als beheerder configurations-administrator

De AEM beheerder en auteurs kunnen configuraties als werkruimten beschouwen. Deze werkruimten kunnen worden gebruikt om groepen instellingen en de bijbehorende inhoud voor organisatorische doeleinden te verzamelen door toegangsrechten voor die functies te implementeren.

Configuraties kunnen worden gemaakt voor vele verschillende functies in AEM.

Voorbeeld administrator-example

Een beheerder kan bijvoorbeeld twee configuraties voor bewerkbare sjablonen maken.

De beheerder kan algemene paginasjablonen dan maken met behulp van de WKND-Algemene configuratie en vervolgens sjablonen die specifiek zijn voor het tijdschrift onder WKND-Magazine.

De beheerder kan vervolgens de WKND-General koppelen aan alle inhoud van de WKND-site. Nochtans zou de configuratie WKND-Magazine slechts met de tijdschriftplaats worden geassocieerd.

Op deze manier:

De gelijkaardige montages zijn mogelijk niet alleen voor Bewerkbare Malplaatjes maar ook voor de Configuraties van de Wolk, Segmenten ContextHub, en Modellen van het Fragment van de Inhoud.

De configuratiebrowser gebruiken using-configuration-browser

Browser van de Configuratie staat een beheerder toe om, toegangsrechten aan configuraties in AEM gemakkelijk tot stand te brengen te beheren en te vormen.

Een configuratie maken creating-a-configuration

Het is zeer eenvoudig om een nieuwe configuratie in AEM tot stand te brengen door Browser van de Configuratie te gebruiken.

Configuraties en hun toegangsrechten bewerken access-rights

Als u configuraties als werkruimten beschouwt, kunnen de toegangsrechten op die configuraties worden geplaatst om af te dwingen wie tot die werkruimten kan en mag toegang hebben.

Configuraties als ontwikkelaar configurations-developer

Als ontwikkelaar, is het belangrijk om te weten hoe AEM as a Cloud Service met configuraties werkt en hoe het configuratieresolutie verwerkt.

Scheiding van configuratie en inhoud separation-of-config-and-content

Hoewel de beheerders en gebruikers kunnen configuraties als werkplekken zien om verschillende instellingen en inhoud te beheren is het belangrijk te begrijpen dat configuraties en inhoud afzonderlijk worden opgeslagen en beheerd door AEM in de opslagplaats.

Content verwijst naar de bijbehorende configuratie via een cq:conf eigenschap. AEM voert een zoekopdracht uit op basis van de inhoud en het is contextueel cq:conf eigenschap om de juiste configuratie te vinden.

Voorbeeld developer-example

Voor dit voorbeeld, veronderstellen wij u één of andere toepassingscode hebt die in montages DAM geinteresseerd is.

Conf conf = resource.adaptTo(Conf.class);
ValueMap imageServerSettings = conf.getItem("dam/imageserver");
String bgkcolor = imageServerSettings.get("bgkcolor", "FFFFFF");

Het uitgangspunt van alle configuratieraadpleging is een inhoudsmiddel, gewoonlijk ergens onder /content. Dit kan een pagina zijn, een component in een pagina, een element of een DAM-map. Dit is de inhoud waarvoor we op zoek zijn naar de juiste configuratie die in deze context van toepassing is.

Nu met de Conf -object in hand, kunnen we het specifieke configuratieitem ophalen waarin we geïnteresseerd zijn. In dit geval is dam/imageserver, dat een verzameling instellingen is die betrekking hebben op de imageserver. De getItem call retourneert een ValueMap. Daarna lezen we een bgkcolor string bezit en verstrekken een standaardwaarde van "FFFFFF"voor het geval dat het bezit (of het volledige config punt) niet aanwezig is.

Nu een blik op de overeenkomstige inhoud JCR:

/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 dit voorbeeld nemen we hier een WKND-specifieke DAM-map en een bijbehorende configuratie aan. Vanaf die map /content/dam/wknd, zullen wij zien dat er een koordbezit genoemd is cq:conf dat verwijst naar de configuratie die voor de substructuur zou moeten van toepassing zijn. De eigenschap wordt meestal ingesteld op de knop jcr:content van een elementmap of -pagina. Deze conf De verbindingen zijn uitdrukkelijk, zodat is het gemakkelijk om hen te volgen door de inhoud in CRXDE te bekijken.

Binnenin pompen /conf, volgen we de referentie en zien we dat er een /conf/wknd knooppunt. Dit is een configuratie. De zoekopdracht is volledig transparant voor de toepassingscode. De voorbeeldcode heeft er nooit een specifieke referentie naar, maar is verborgen achter het Conf object. Welke configuratie van toepassing is, wordt volledig gecontroleerd door de inhoud JCR.

We zien dat de configuratie een vaste naam bevat settings knooppunt dat de werkelijke items bevat, inclusief de dam/imageserver in ons geval is dat nodig . Een dergelijk item kan worden beschouwd als een "instellingendocument" en wordt gewoonlijk aangeduid met een cq:Page met inbegrip van jcr:content de feitelijke inhoud bezitten.

Tot slot zien we de eigenschap bgkcolor dat onze voorbeeldcode nodig heeft. De ValueMap we komen terug van getItem is gebaseerd op de pagina's jcr:content knooppunt.

Configuratieresolutie configuration-resolution

Het basisvoorbeeld hierboven toonde één enkele configuratie. Maar er zijn veel gevallen waarin u verschillende configuraties wilt hebben, zoals een standaard globale configuratie, een andere configuratie voor elk merk en misschien een specifieke configuratie voor uw subprojecten.

Om dit te steunen heeft de configuratieraadpleging in AEM overerving en fallback mechanisme in de volgende orde van voorkeur:

Configuraties gebruiken using-configurations

Configuraties in AEM zijn gebaseerd op Sling Context-Aware Configurations. De bundels van de Verkoop verstrekken de dienst API die kan worden gebruikt om context-bewuste configuraties te krijgen. Contextbewuste configuraties zijn configuraties die verwant zijn aan een inhoudsmiddel of een middelboom zoals was beschreven in het vorige voorbeeld.

Voor meer informatie over Context-Aware Configuraties, voorbeelden, en hoe te om hen te gebruiken, zie de documentatie van het Verkopen.

ConfMgr-webconsole confmgr-web-console

Voor foutopsporing- en testdoeleinden is er een ConfMgr webconsole op https://<host>:<port>/system/console/conf, die configuraties voor een bepaald pad/item kan weergeven.

Verstrek eenvoudig:

Klikken Oplossen om te zien welke configuraties worden opgelost en steekproefcode te ontvangen die die configuraties zal oplossen.

Contextbewuste configuratie webconsole context-aware-web-console

Voor foutopsporing- en testdoeleinden is er een Contextbewuste configuratie webconsole op https://<host>:<port>/system/console/slingcaconfig, waarmee u contextbewuste configuraties in de opslagplaats kunt opvragen en hun eigenschappen kunt bekijken.

Verstrek eenvoudig:

Klikken Oplossen om de bijbehorende contextwegen en eigenschappen voor de geselecteerde configuratie terug te winnen.