Konfigurationer och Configuration Browser configuration-browser

AEM konfigurationer används för att hantera inställningar i AEM och fungerar som arbetsytor.

Vad är en konfiguration? what-is-a-configuration

En konfiguration kan övervägas från två olika vypunkter.

Sammanfattningsvis: ur administratörens synvinkel är konfigurationer hur du skapar arbetsytor för att hantera inställningar i AEM, medan utvecklaren bör förstå hur AEM använder och hanterar dessa konfigurationer i databasen.

Oavsett perspektiv har konfigurationerna två huvudsyften AEM:

Konfigurationer som administratör configurations-administrator

AEM administratör och författare kan betrakta konfigurationer som arbetsytor. De här arbetsytorna kan användas för att samla in grupper med inställningar och tillhörande innehåll för organisatoriska syften genom att implementera åtkomsträttigheter för dessa funktioner.

Du kan skapa konfigurationer för många olika funktioner i AEM.

Exempel administrator-example

En administratör kan till exempel skapa två konfigurationer för redigerbara mallar.

Administratören kan sedan skapa allmänna sidmallar med WKND-General-konfigurationen och sedan använda mallar som är specifika för tidskriften under WKND-Magazine.

Administratören kan sedan koppla WKND-general till allt innehåll på WKND-webbplatsen. Konfigurationen av WKND-Magazine skulle bara kopplas till tidskriftswebbplatsen.

Genom att göra detta:

Liknande inställningar kan göras inte bara för redigerbara mallar utan även för molnkonfigurationer, ContextHub-segment och Content Fragment-modeller.

Använda Konfigurationsläsaren using-configuration-browser

Med Configuration Browser kan en administratör enkelt skapa, hantera och konfigurera åtkomsträttigheter för konfigurationer i AEM.

Skapa en konfiguration creating-a-configuration

Det är enkelt att skapa en konfiguration i AEM med hjälp av Configuration Browser.

Redigera konfigurationer och deras åtkomsträttigheter access-rights

Om du tänker på konfigurationer som arbetsytor kan åtkomsträttigheter anges för dessa konfigurationer för att framtvinga vem som får och inte får tillgång till dessa arbetsytor.

Konfigurationer som utvecklare configurations-developer

Som utvecklare är det viktigt att du vet hur AEM as a Cloud Service fungerar med konfigurationer och hur det hanterar konfigurationsupplösning.

Separation av konfiguration och innehåll separation-of-config-and-content

Även om administratören och användarna kanske tänker på konfigurationer som arbetsplatser för att hantera olika inställningar och innehåll, är det viktigt att förstå att konfigurationer och innehåll lagras och hanteras separat av AEM i databasen.

Innehållet refererar till den associerade konfigurationen via en cq:conf-egenskap. AEM utför en sökning baserat på innehållet och dess sammanhangsberoende cq:conf-egenskap för att hitta rätt konfiguration.

Exempel developer-example

I det här exemplet antar vi att du har programkod som är intresserad av DAM-inställningar.

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

Startpunkten för all konfigurationssökning är en innehållsresurs, någonstans under /content. Det kan vara en sida, en komponent på en sida, en resurs eller en DAM-mapp. Det här är det innehåll som du letar efter rätt konfiguration för i det här sammanhanget.

Med objektet Conf kan du nu hämta det specifika konfigurationsobjekt som du är intresserad av. I det här fallet är det dam/imageserver, som är en samling inställningar som är relaterade till imageserver. Anropet getItem returnerar ValueMap. Du läser sedan en bgkcolor-strängegenskap och anger standardvärdet FFFFFF om egenskapen (eller hela config-objektet) inte finns.

Nu ska vi titta på motsvarande JCR-innehåll:

/content/dam/wknd
    + jcr:content
      - cq:conf = "/conf/wknd"
    + image.png [dam:Asset]

/conf/wkns
    + settings
      + dam
        + imageserver [cq:Page]
          + jcr:content
            - bgkcolor = "FF0000"

I det här exemplet kan du anta en WKND-specifik DAM-mapp här och en motsvarande konfiguration. Från och med den mappen /content/dam/wknd kan du se att det finns en strängegenskap med namnet cq:conf som refererar till konfigurationen som ska användas för underträdet. Egenskapen anges för jcr:content för en resursmapp eller -sida. Dessa conf länkar är explicita, så det är enkelt att följa dem genom att bara titta på innehållet i CRXDE.

Om du hoppar i /conf kan du följa referensen och se att det finns en /conf/wknd-nod. Detta är en konfiguration. Dess sökning är genomskinlig för programkoden. Exempelkoden har aldrig någon dedikerad referens till den, den är dold bakom objektet Conf. Vilken konfiguration som tillämpas styrs via JCR-innehållet.

Du kan se att konfigurationen innehåller en fast namngiven settings-nod som innehåller de faktiska objekten, inklusive dam/imageserver som du behöver i det här fallet. Ett sådant objekt kan betraktas som ett inställningsdokument och representeras av en cq:Page som innehåller det faktiska innehållet. jcr:content

Slutligen kan du se egenskapen bgkcolor som exempelkoden behöver. ValueMap som du kommer tillbaka från getItem baseras på sidans jcr:content-nod.

Konfigurationsupplösning configuration-resolution

I det grundläggande exemplet ovan visades en enda konfiguration. Men det finns många fall där du vill ha olika konfigurationer, till exempel en global standardkonfiguration, en som skiljer sig åt för varje varumärke och kanske en som är specifik för dina delprojekt.

För att detta ska fungera har konfigurationssökningen i AEM en arv- och reservmekanism i följande prioritetsordning:

Använda konfigurationer using-configurations

Konfigurationer i AEM baseras på Sling Context-Aware Configurations. Sling-paketen innehåller ett tjänst-API som kan användas för att få kontextmedvetna konfigurationer. Kontextmedvetna konfigurationer är konfigurationer som är relaterade till en innehållsresurs eller ett resursträd, vilket beskrivs i föregående exempel.

Mer information om kontextmedvetna konfigurationer, exempel och hur du använder dem finns i Sling-dokumentationen.

ConfMgr-webbkonsol confmgr-web-console

För felsökning och testning finns en ConfMgr-webbkonsol på https://<host>:<port>/system/console/conf som kan visa konfigurationer för en viss sökväg/ett visst objekt.

Ange bara:

Välj Lös om du vill se vilka konfigurationer som är lösta och få en exempelkod som löser dessa konfigurationer.

Kontextmedveten webbkonsol för konfiguration context-aware-web-console

För felsökning och testning finns en kontextmedveten konfiguration på https://<host>:<port>/system/console/slingcaconfig som gör det möjligt att fråga efter kontextmedvetna konfigurationer i databasen och visa deras egenskaper.

Ange bara:

Om du vill hämta associerade kontextsökvägar och egenskaper för den valda konfigurationen väljer du Lös.