Grundläggande om redigering för Headless med AEM author-headless-basics

Story hittills story-so-far

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.

Syfte objective

  • Målgrupp: Nybörjare

  • Syfte: Introducing the basics of Headless CMS Authoring:

    • Introduktion till utveckling med AEMaaCS
    • Introduktion till innehållsfragment

Grundläggande hantering basic-handling

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.

Skapa, förhandsgranska och publicera author-preview-publish

En AEM brukar bestå av tre miljöer:

  • Författare
  • Publicera
  • Förhandsgranska

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.

Från Innehållsfragment konsolen kan du även publicera på Förhandsgranskningstjänst, för testning och förhandsgranskning, före publicering. Se Publicera och förhandsgranska ett fragment.

Loggar in signing-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 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 Innehållsfragment konsol (för vissa åtgärder använder du även Resurser konsol).

Du kan öppna navigeringspanelen genom att markera ikonen Adobe i det övre vänstra hörnet följt av den lilla kompasikonen.

NOTE
Även om innehållsfragment är en funktion i AEM Webbplatser, sparas de som Resurser. 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 i den vänstra panelen för att navigera till ditt innehållsfragment. Du kan också filtrera och/eller söka.

Konsol för innehållsfragment

funktionsmakron, markera, visa actions-selecting-viewing

I Innehållsfragment konsol: en rad åtgärder är tillgängliga för dina innehållsfragment från verktygsfältet:

  • Öppna i resurser
  • Skapa
  • The Refererad av -kolumnen innehåller också en direkt länk för att visa alla överordnade referenser till det fragmentet, inklusive referenser till innehållsfragment, Experience Fragments och pages.
  • Vid hovring över mappnamnet visas JCR-sökvägen.

När du har valt fragmentet är alla lämpliga åtgärder tillgängliga:

  • Öppna
  • Publicera (och Avpublicera)
  • Kopiera
  • Flytta
  • Byt namn
  • Ta bort
NOTE
Åtgärder som Publicera, Avpublicera, Ta bort, Flytta, Byt namn, Kopiera, utlöser ett asynkront jobb. Jobbets förlopp kan övervakas via gränssnittet AEM asynkrona jobb.

Skapa innehållsfragment authoring-content-fragments

Det var en mycket snabb introduktion till AEM användargränssnitt, men du har förhoppningsvis haft en chans att testa 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 organizing-and-navigating

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

Du kan göra detta genom att skapa en serie mappar i Filer i Resurser konsol. 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 antalet modeller för innehållsfragment i mappen tags-paths-for-models-in-folder

Det här avsnittet är något mer avancerat. Du behöver det inte riktigt 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

NOTE
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 cloud-services-folder

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:

Skapa mappegenskaper - Konfiguration

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

Skapa ett innehållsfragment creating-fragment

I Innehållsfragment konsol du kan använda Skapa för att öppna Nytt innehållsfragment dialog:

Konsol för innehållsfragment - Skapa ett nytt fragment

Ange:

  • Plats
  • Modell för innehållsfragment
  • Titel
  • Namn
  • Beskrivning

Bekräfta sedan med antingen Skapa eller Skapa och öppna.

Redigera ett fragment editing-fragment

Du kan öppna ett fragment omedelbart efter att du har skapat det, eller genom att välja det från konsolen för innehållsfragment (även från konsolen Resurser).

NOTE
Innehållsfragment är en webbplatsfunktion, men lagras som Resurser.
Det finns två redigerare för att skapa innehållsfragment.
  • Den nya redigeraren, som huvudsakligen kommer från Innehållsfragment konsol.
  • Den ursprungliga redigeraren, som du i första hand kommer åt från Resurser konsol.

När redigeraren öppnas ser du:

  • övre verktygsfältet: för nyckelinformation och åtgärder

    • en länk till konsolen för innehållsfragment (hemikonen)
    • information om modellen och mappen
    • länkar till förhandsgranskning, om standardmönstret för URL för förhandsgranskning har konfigurerats för modellen
    • Åtgärder för publicering och avpublicering
    • ett alternativ för att visa alla Överordnade referenser (länkikon)
    • fragmentet Status och senast sparad information
    • växla till den ursprungliga (resursbaserade) redigeraren
  • vänster panel: visar Variationer för innehållsfragmentet och dess Fält:

    • dessa länkar kan användas för att navigera i strukturen för innehållsfragment
  • höger panel: visar flikar med egenskaper (metadata) och taggar, information om versionshistorik och information om språkkopior

    • i Egenskaper kan du uppdatera Titel och Beskrivning för fragmentet, eller Variation
  • central panel: visar de faktiska fälten och innehållet i den valda varianten

    • gör att du kan redigera innehållet
    • if Platshållare för flik fält definieras i den modell de visas här och kan användas för navigering

Ett fragment kan till exempel:

  • Kräver flera uppgifter, andra med en viss typ. För rubrikfritt innehåll är referenser viktiga (du lär dig mer om dem senare under din resa).

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

Content Fragment Editor - Alaska Spirits

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

NOTE
Mer information finns i Variationer - Skapa innehållsfragment.

Det du (antagligen) inte behöver oroa dig för what-you-probably-do-not-need-to-worry-about

OK, det kan verka lite konstigt, men så fort du öppnar Content Fragment Editor och börjar utforska kan du se 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

    Du kan se namnet på modellen för innehållsfragment på den högra panelen i redigeraren. 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.

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

Publicering publishing

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:

Content Fragment Editor - My Fragment

NOTE
Du kan även publicera ditt fragment från någon av Resurser eller Innehållsfragment konsol.

What's Next whats-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 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab