Grundläggande om redigering för Headless med AEM

Story hittills

I början av AEM Headless Content Author Journey den Introduktion har omfattat de grundläggande begrepp och termer som är relevanta för utvecklingen av headless.

Den här artikeln bygger vidare på dessa artiklar så att du förstår hur du skapar ditt eget innehåll för AEM headless-projekt.

Syfte

  • Målgrupp: Nybörjare
  • Syfte: Introducing the basics of Headless CMS Authoring:
    • Introduktion till utveckling med AEMaaCS
    • Introduktion till innehållsfragment

Grundläggande hantering

Innan du får grepp om innehållsfragment finns det en (mycket) snabb introduktion till att använda AEM…men ingenting ersätter faktiskt upplevelsen av att logga in och försöka använda systemet.

Skapa och publicera

En AEM består vanligtvis av minst två miljöer:

  • Författare
  • Publicera

Du loggar in på och använder redigeringsmiljön för att generera ditt innehåll. När det är klart publicerar du sedan innehållet så att det blir allmänt tillgängligt. För hemlösa är detta för andra program, för webbsidor är det för läsare på webben.

Mer information finns i Authoring Concepts.

Loggar in

Precis som med de flesta system måste du logga in. Som författare får du:

  • Användarnamn (konto)
  • Lösenord
  • Länk till inloggningsskärmen

Ditt konto har konfigurerats med de privilegier du behöver. Om du har problem rekommenderar vi att du kontaktar ditt interna projektsupportteam.

Första gången du loggar in i en liten onlinekurs kommer några av huvudfunktionerna i användargränssnittet att markeras.

Du kan sedan använda navigeringspanelen för att komma åt AEM nyckelområden. För innehållsfragment använder du Resurskonsol.

Du kan öppna navigeringspanelen genom att välja ikonen Adobe längst upp till vänster, följt av den lilla kompassikonen:

Navigeringspanelen

OBSERVERA

Innehållsfragment är en funktion i AEM Webbplatser finns de i Resurser konsol. Detta är en teknisk detalj som inte bör påverka dig, men som kan vara användbar att känna till.

I konsolen kan du välja mappar för att navigera till ditt innehållsfragment, eller de synliga mapparna (i sidhuvudet) för att gå tillbaka till trädet.

Breadcrumbs

funktionsmakron, markera, visa

The Resurser konsolen har dedikerat Åtgärdsverktygsfält och Snabbåtgärder som du kan använda när du har valt en resurs (till exempel en mapp eller ett innehållsfragment).

Snabbåtgärder är tillgängliga för en enskild resurs, se Basel i exemplet nedan:

Snabbåtgärder

Verktygsfältet Åtgärder ger tillgång till alla de åtgärder som gäller för det aktuella scenariot. De tillgängliga åtgärderna kan ändras. beroende på var du befinner dig, eller om du har valt flera resurser:

Verktygsfältet Åtgärd

Du kan välja format för att visa dina resurser med vyväljaren:

Visa väljare

Du kan visa ytterligare information om objekt med hjälp av Rail Selector. Detta ger även tillgång till ytterligare åtgärder.

Vänster linje

Skapa innehållsfragment

Det var en mycket snabb introduktion till AEM användargränssnitt, men du har förhoppningsvis haft en chans att prova det. Nu kommer vi till ditt verkliga intresse - innehållsfragment för Headless.

Vi måste gå igenom allt från början till slut, men din instans kanske redan har mappar och/eller fragment skapade, och dessa kan finnas på olika platser. Principerna är desamma.

Ordna och navigera

Om du inte har ett fåtal innehållsfragment vill du ordna dem så att du (och andra) kan hitta dem igen.

Skapa en mapp

Du kan göra detta genom att skapa en serie mappar i Filer i Assets-konsolen. Välj Skapa alternativ (överst till höger), följt av Mapp:

Alternativet Skapa mapp

En dialogruta öppnas där du kan ange information och sedan bekräfta med Skapa:

Dialogrutan Skapa mapp

Använda banor och taggar för att begränsa vilka modeller för innehållsfragment som finns i mappen

Det här avsnittet är något mer avancerat. Du behöver det inte om du bara börjar och provar saker, men det är mycket är användbart när du har många fragment. Så det är bra att veta om - även om du inte använder det helt än.

Din innehållsarkitekt har skapat alla innehållsfragmentmodeller som krävs för ditt aktuella projekt, och kanske även några andra projekt. För att göra det enklare för dig själv och andra författare kan du begränsa listan med modeller som är tillgängliga för en viss mapp.

När du har skapat mappen kan du öppna den Egenskaper. Här finns olika flikar med information och konfigurationsinformation om mappen. Du kan använda kommandot Profiler om du vill definiera specifika sökvägar och/eller taggar för den här mappen. Detta begränsar vilka modeller för innehållsfragment som är tillgängliga för användning i mappen, eftersom det innebär att modeller för innehållsfragment måste uppfylla dessa krav innan de kan användas för att generera fragment i den här mappen.

Skapa mappegenskaper - principer

OBSERVERA

Du kan läsa mer under Modeller för innehållsfragment - Tillåt modeller för innehållsfragment i resursmappen.

Du navigerar sedan genom de här mapparna för att skapa och redigera dina innehållsfragment.

Precis in case - konfiguration av mappkonfiguration

Bara om…

Du kommer antagligen att få en inledande mapp där du kan skapa dina mappar. Detta beror på att viss konfigurationsinformation måste tillämpas (vanligtvis av en utvecklare eller systemadministratör) på rotmappen. Det här intresserar dig förmodligen inte, men om det behövs kan du kontrollera Konfiguration i Cloud Services i mappen Egenskaper:

Skapa mappegenskaper - Konfiguration

OBSERVERA

Du kan läsa mer under Använd konfigurationen i resursmappen.

Skapa ett innehållsfragment

Att skapa ett innehållsfragment är mycket likt - du använder bara Innehållsfragment i stället:

Alternativet Skapa innehållsfragment

Den här gången öppnas en guide. Det första steget är att välja den innehållsfragmentmodell som fragmentet ska baseras på:

Skapa innehållsfragment - välj modell

Efter att du fortsätter med Nästa du kan ange information (Grundläggande och Avancerat) för ditt fragment:

Skapa innehållsfragment - ange namn

Bekräfta med Skapa så kan du Öppna ditt fragment i redigeraren.

Redigera ett fragment

Du kan öppna ett fragment omedelbart efter att du har skapat det, eller genom att välja det från resurskonsolen.

När redigeraren öppnas ser du:

  • En lista med ikoner till vänster - det ger dig tillgång till olika funktionsområden. Redigeraren öppnas i Variationer är det här den mesta redigeringen görs. Du kan också vara intresserad av Anteckningar och Metadata -tabbar.

  • En rubrik med information om fragmentet och åtkomst till olika åtgärder.

  • Huvudområdet för redigering - det beror på vilken modell som används för att skapa fragmentet.

Exempel:

  • Ett fragment som bara kräver flera informationsdelar, vissa med en viss typ. För headless-innehåll är referenser viktiga och du kommer att lära dig mer om dem senare under din resa.

    Content Fragment Editor - My Fragment

  • Ett fragment som gör att du kan skriva ett långt textavsnitt. Här finns ytterligare alternativ för att hantera och formatera texten. Du kan till och med öppna de enskilda textfälten i en helskärmsredigerare (med den lilla skärmliknande ikonen till höger)

    Content Fragment Editor - Alaska Spirits

OBSERVERA

Projektspecifik dokumentation kan behövas för att hjälpa författare med detaljer om hur vissa fält kan fyllas i.

Se Modeller för innehållsfragment - Datatyper och egenskaper för allmän information.

Bekräfta dina uppdateringar med antingen Spara eller Spara och stäng.

OBSERVERA

Mer information finns i Variationer - Skapa innehållsfragment.

Det du (antagligen) inte behöver oroa dig för

OK, det här kan verka lite konstigt, men när du väl har öppnat Content Fragment Editor och börjat utforska ser du olika alternativ som (förmodligen) inte gäller för din resa som innehållsförfattare. Så det här är bara en snabbtitt på vad du bör ignorera i det headlesssammanhanget:

  • Modeller för innehållsfragment

    Namnet på innehållsfragmentmodellen visas längst upp i redigeraren, direkt under fragmentnamnet. Det här är också en länk som tar dig till modellredigeraren.
    Modeller för innehållsfragment är faktiskt viktiga för dina innehållsfragment när de definierar den struktur som du använder. Men att skapa och redigera dem är (vanligtvis) en annan persons ansvar, innehållsarkitekten.

    OBSERVERA

    Om du vill veta mer kan du läsa den AEM Headless Content Architect Journey.

  • Associerat innehåll

    Den här är ganska självklar eftersom den är en flik i redigeraren.

    Innehållsfragment har varit tillgängliga i AEM i ganska många versioner. Ursprungligen var de tillgängliga för"traditionell" användning vid redigering av sidor…och de används fortfarande i detta sammanhang. Detta kan innebära att resurser (till exempel bilder) som inte är inbäddade i fragmentet måste vara tillgängliga för författaren när sidan redigeras.

  • Förhandsgranska

    Det här är en annan flik i redigeraren och ger en teknisk vy som främst är avsedd för utvecklare.

  • Uppdatera sidreferenser

    Den här åtgärden är tillgänglig från (ellipser) listruta. Det är inte intressant för skribenter utan rubrik när det gäller att skapa sidor.

Publicering

När du är klar med fragmentet kan du Publicera så att den blir tillgänglig för headless-applikationer.

Publiceringsåtgärderna är tillgängliga i redigeraren (eller från verktygsfältet i Resurser konsol):

Content Fragment Editor - My Fragment

What's Next

Nu när du har lärt dig grunderna är nästa steg att Läs mer om referenser. Här presenteras och diskuteras de olika referenser som finns tillgängliga och hur du skapar strukturnivåer med Fragment References - en viktig del i utvecklingen för headless.

Ytterligare resurser

På denna sida