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 Journey innehöll Introduction grundläggande begrepp och terminologi som är relevant för redigering utan rubrik.

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

  • Mål: Introducera grunderna för Headless CMS-redigering:

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

Författare, Förhandsgranska och Publish author-preview-publish

En AEM brukar bestå av tre miljöer:

  • Författare
  • Publish
  • 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 konsolen Innehållsfragment kan du även publicera till förhandsgranskningstjänsten, för testning och förhandsgranskning, före Publish. 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 konsolen Innehållsfragment (för vissa åtgärder använder du även konsolen Assets).

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

NOTE
Innehållsfragment är en funktion i AEM Webbplatser, men de sparas som Assets. 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.

Konsolen för innehållsfragment

funktionsmakron, markera, visa actions-selecting-viewing

I konsolen Innehållsfragment finns ett antal åtgärder tillgängliga för dina innehållsfragment från verktygsfältet:

  • Öppna i Assets
  • Skapa
  • Kolumnen Refererad av innehåller också en direktlänk som visar alla överordnade referenser till det fragmentet, inklusive referenser till innehållsfragment, Experience Fragments och sidor.
  • Vid hovring över mappnamnet visas JCR-sökvägen.

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

  • Öppna
  • Publish (och Avpublicera)
  • Kopiera
  • Flytta
  • Byt namn
  • Ta bort
NOTE
Åtgärder som Publish, Unpublish, Delete, Move, Rename, Copy, trigger an asynchronous job. 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 avsnittet Filer i Assets-konsolen. Välj alternativet Skapa (överst till höger) följt av Mapp:

Alternativet Skapa mapp

En dialogruta öppnas där du kan ange informationen 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 egentligen inte om du just har börjat och försöker saker, men det är mycket 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 mappen Egenskaper. Här finns olika flikar med information och konfigurationsinformation om mappen. Särskilt för innehållsfragment kan du använda fliken Profiler för att 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 din Assets-mapp.

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. Detta 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 din Assets-mapp.

Skapa ett innehållsfragment creating-fragment

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

Konsolen för innehållsfragment - Skapar 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 Assets-konsolen).

NOTE
Innehållsfragment är en webbplatsfunktion, men lagras som Assets.
Det finns två redigerare för att skapa innehållsfragment.
  • Den nya redigeraren, som huvudsakligen nås från konsolen Innehållsfragment .
  • Den ursprungliga redigeraren, som främst nås från Assets-konsolen.

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
    • Publish och Unpublish actions
    • ett alternativ för att visa alla överordnade referenser (länkikon)
    • fragmentet Status och den senast sparade informationen
    • växla till den ursprungliga (Assets-baserade) 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

    • på fliken Egenskaper kan du uppdatera Title och Description 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
    • om platshållarfä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 uppdateringarna med 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 har slutfört fragmentet kan du Publish så att det blir tillgängligt för de headless-program som använder det.

Publiceringsåtgärderna är tillgängliga i redigeraren:

Innehållsfragmentredigeraren - Mitt fragment

NOTE
Du kan också publicera ditt fragment från konsolen Assets eller Innehållsfragment .

What's Next whats-next

Nu när du har lärt dig grunderna är nästa steg att Lär dig 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