I början av AEM Headless Content Author Trney 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.
Innan du får grepp om innehållsfragment finns det en (mycket) snabb introduktion till AEM…men ingenting ersätter faktiskt upplevelsen av att logga in och försöka använda systemet.
En AEM består vanligtvis av minst två miljöer:
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.
Precis som med de flesta system måste du logga in. Som författare får du:
Ditt konto har konfigurerats med de privilegier du behöver. Om du har några problem rekommenderar Adobe 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:
Även om 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.
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:
Verktygsfältet Åtgärder ger tillgång till alla de åtgärder som gäller för det aktuella scenariot. Vilka åtgärder som är tillgängliga kan ändras, till exempel beroende på var du befinner dig eller om du har valt flera resurser:
Du kan välja format för att visa dina resurser med vyväljaren:
Du kan visa ytterligare information om objekt med hjälp av Rail Selector. Detta ger även tillgång till ytterligare åtgärder.
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.
Om du inte har ett fåtal innehållsfragment vill du ordna dem så att du (och andra) kan hitta dem igen.
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:
En dialogruta öppnas där du kan ange information och sedan bekräfta med Skapa:
Det här avsnittet är något mer avancerat. Du behöver det inte riktigt om du bara börjar och försöker saker, men det är mest 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.
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.
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 Service i mappen Egenskaper:
Du kan läsa mer under Använd konfigurationen i resursmappen.
Att skapa ett innehållsfragment är mycket likt - du använder bara Innehållsfragment i stället:
Den här gången öppnas en guide. Det första steget är att välja den innehållsfragmentmodell som fragmentet ska baseras på:
Efter att du fortsätter med Nästa du kan ange information (Grundläggande och Avancerat) för ditt fragment:
Bekräfta med Skapa så kan du Öppna ditt fragment i redigeraren.
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.
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 även öppna enskilda textfält i en helskärmsredigerare (med den lilla skärmliknande ikonen till höger)
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.
Mer information finns i Variationer - Skapa innehållsfragment.
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.
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.
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):
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.
Grundläggande hantering - den här sidan är huvudsakligen baserad på Webbplatser konsol, men många/de flesta funktioner är också relevanta för redigering Innehållsfragment under Resurser konsol.
Komma igång-guider