Authoring Grundlagen für Headless mit AEM

Die Geschichte so weit

Zu Beginn der AEM Headless Content Author-Journey hat die Einführung die grundlegenden Konzepte und Terminologie für die Headless-Bearbeitung behandelt.

Dieser Artikel baut auf diesen auf, damit Sie verstehen, wie Sie eigene Inhalte für Ihr AEM Headless-Projekt erstellen können.

Ziele

  • Zielgruppe: Anfänger
  • Zielsetzung: Einführung in die Grundlagen der Headless-CMS-Bearbeitung:
    • Einführung in das Authoring mit AEMaaCS
    • Einführung in Inhaltsfragmente

Grundlegende Handhabung

Bevor Sie mit Inhaltsfragmenten umgehen, hier eine (sehr) kurze Einführung in die Verwendung von AEM…aber nichts ersetzt die Erfahrung, sich anzumelden und zu versuchen, das System zu verwenden.

Authoring und Veröffentlichen

Eine AEM-Installation besteht im Allgemeinen aus mindestens zwei Umgebungen:

  • Autor
  • Veröffentlichung

Sie melden sich an und verwenden die Autorenumgebung, um Ihren Inhalt zu generieren. Wenn Sie bereit sind, veröffentlichen Sie Ihren Inhalt, damit er allgemein verfügbar wird. Für Headless wäre dies für andere Anwendungen, für Web-Seiten wäre dies für Leser im Internet.

Weitere Informationen finden Sie unter Authoring - Konzepte .

Anmeldung

Wie bei den meisten Systemen müssen Sie sich anmelden. Als Autor erhalten Sie Folgendes:

  • Name des Benutzers (Konto)
  • Passwort
  • Link zum Zugriff auf den Anmeldebildschirm

Ihr Konto wurde mit den erforderlichen Berechtigungen konfiguriert. Sollten Sie Probleme haben, empfehlen wir Ihnen, sich an Ihr internes Projektunterstützungsteam zu wenden.

Wenn Sie sich zum ersten Mal in einem kleinen Online-Tutorial anmelden, werden einige der wichtigsten Funktionen der Benutzeroberfläche hervorgehoben.

Sie können dann über das Navigationsfenster auf wichtige Bereiche von AEM zugreifen. Für Inhaltsfragmente verwenden Sie die Konsole "Assets".

Das Navigationsfenster kann geöffnet werden, indem Sie links oben das Symbol Adobe und dann das kleine Kompasssymbol auswählen:

Navigationsfenster

HINWEIS

Inhaltsfragmente sind zwar eine Funktion von AEM Sites, sie befinden sich jedoch in der Konsole Assets. Dies ist ein technisches Detail, das sich nicht auf Sie auswirken sollte, das jedoch nützlich sein könnte, um es zu erfahren.

In der Konsole können Sie Ordner auswählen, um zu Ihrem Inhaltsfragment zu navigieren, oder die Breadcrumbs (in der Kopfzeile), um in der Baumstruktur nach oben zu navigieren.

Breadcrumb

Aktionen, Auswählen, Anzeigen

Die Konsole Assets enthält dedizierte Action Toolbars und Schnellaktionen, die Sie verwenden können, nachdem Sie eine Ressource ausgewählt haben (z. B. einen Ordner oder ein Inhaltsfragment).

Die Schnellaktionen sind für eine einzelne Ressource verfügbar. Siehe Basel im folgenden Beispiel:

Schnellaktionen

Die Symbolleiste "Aktionen"bietet Zugriff auf alle Aktionen, die für das aktuelle Szenario gelten. Die verfügbaren Aktionen können sich ändern. zum Beispiel abhängig von Ihrem Standort oder davon, ob Sie mehrere Ressourcen ausgewählt haben:

Aktionssymbolleiste

Mit der Ansichtauswahl können Sie das Format für die Anzeige Ihrer Ressourcen auswählen:

Ansichtselektor

Mit der Schienenauswahl können Sie zusätzliche Informationen zu Elementen anzeigen. Dadurch erhalten Sie auch Zugriff auf zusätzliche Aktionen.

Linke Leiste

Erstellen von Inhaltsfragmenten

Das war eine sehr schnelle Einführung in die AEM Benutzeroberfläche, aber hoffentlich hatten Sie die Möglichkeit, es auszuprobieren. Jetzt kommen wir zu Ihrem echten Interesse - Inhaltsfragmente für Headless.

Wir müssen die Dinge von Anfang bis Ende durchgehen, aber Ihre Instanz hat möglicherweise bereits Ordner und/oder Fragmente erstellt, die sich an verschiedenen Stellen befinden. Die Prinzipien sind dieselben.

Organisieren und Navigieren

Wenn Sie nicht über sehr wenige Inhaltsfragmente verfügen, sollten Sie diese organisieren, damit Sie (und andere) sie erneut finden können.

Erstellen eines Ordners

Erstellen Sie dazu eine Reihe von Ordnern im Abschnitt Dateien der Assets-Konsole. Wählen Sie die Option Erstellen (oben rechts), gefolgt von Ordner:

Option "Ordner erstellen"

Daraufhin wird ein Dialogfeld geöffnet, in dem Sie die Details eingeben und dann mit Erstellen bestätigen können:

Dialogfeld "Ordner erstellen"

Verwenden von Pfaden und Tags zur Beschränkung von Inhaltsfragmentmodellen, die im Ordner verfügbar sind

Dieser Abschnitt ist etwas erweiterter. Sie benötigen es nicht wirklich, wenn Sie gerade erst anfangen und Dinge ausprobieren, aber es ist sehr nützlich, wenn Sie viele Fragmente haben. Also ist es gut, darüber zu wissen - auch wenn man es noch nicht ganz benutzt.

Ihr Inhaltsarchitekt hat alle Inhaltsfragmentmodelle erstellt, die für Ihr aktuelles Projekt erforderlich sind, und möglicherweise auch einige andere Projekte. Um Ihnen und anderen Autoren die Arbeit zu erleichtern, können Sie die Liste der für einen bestimmten Ordner verfügbaren Modelle einschränken.

Nachdem Sie Ihren Ordner erstellt haben, können Sie den Ordner Eigenschaften öffnen. Hier finden Sie verschiedene Registerkarten mit Informationen und Konfigurationsdetails zum Ordner. Insbesondere für Inhaltsfragmente können Sie die Registerkarte Richtlinien verwenden, um bestimmte Pfade und/oder Tags für diesen Ordner zu definieren. Dadurch werden die für die Verwendung im Ordner verfügbaren Inhaltsfragmentmodelle eingeschränkt, da dies bedeutet, dass Inhaltsfragmentmodelle diese Anforderungen erfüllen müssen, bevor sie zum Generieren von Fragmenten in diesem Ordner verwendet werden können.

Erstellen von Ordnereigenschaften - Richtlinien

HINWEIS

Weitere Informationen finden Sie unter Inhaltsfragmentmodelle - Zulassen von Inhaltsfragmentmodellen für Ihren Assets-Ordner.

Navigieren Sie dann durch diese Ordner, um Ihre Inhaltsfragmente zu erstellen und zu bearbeiten.

Just in case - Konfiguration von Folder Cloud Services

Nur für den Fall…

Sie erhalten wahrscheinlich einen ersten Ordner, in dem Sie Ihre Ordner erstellen können. Dies liegt daran, dass einige Konfigurationsdetails (normalerweise von einem Entwickler oder Systemadministrator) auf den Stammordner angewendet werden müssen. Dies wird Sie wahrscheinlich nicht interessieren, aber bei Bedarf können Sie die Konfiguration in den Cloud Services des Ordners Eigenschaften überprüfen:

Erstellen von Ordnereigenschaften - Konfiguration

HINWEIS

Weitere Informationen finden Sie unter Anwenden der Konfiguration auf Ihren Assets-Ordner .

Erstellen eines Inhaltsfragments

Das Erstellen eines Inhaltsfragments ist sehr ähnlich. Verwenden Sie stattdessen einfach die Option Inhaltsfragment :

Option "Inhaltsfragment erstellen"

Dieses Mal öffnet sich ein Assistent. Der erste Schritt besteht darin, das Inhaltsfragmentmodell auszuwählen, auf dem Ihr Fragment basieren soll:

Inhaltsfragment erstellen - Modell auswählen

Nachdem Sie mit Next fortfahren, können Sie die Details (Basic und Advanced) für Ihr Fragment angeben:

Inhaltsfragment erstellen - Name angeben

Bestätigen Sie die Auswahl mit Erstellen und Sie können Ihr Fragment im Editor öffnen.

Bearbeiten eines Fragments

Sie können ein Fragment unmittelbar nach seiner Erstellung öffnen oder indem Sie es in der Konsole "Assets"auswählen.

Wenn der Editor zum ersten Mal geöffnet wird, sehen Sie Folgendes:

  • Eine Liste von Symbolen auf der linken Seite - bietet Ihnen Zugriff auf verschiedene Funktionsbereiche. Der Editor wird auf der Registerkarte Varianten geöffnet. Hier erfolgt der Großteil der Bearbeitung. Möglicherweise sind auch die Tabs Anmerkungen und Metadaten von Interesse.

  • Eine Kopfzeile mit Informationen zum Fragment und Zugriff auf verschiedene Aktionen.

  • Hauptbearbeitungsbereich - dies hängt von dem Modell ab, das zum Erstellen des Fragments verwendet wird.

Beispiele:

  • Ein Fragment, für das nur mehrere Informationen erforderlich sind, von denen einige einen bestimmten Typ aufweisen. Für Headless-Inhalte sind Verweise von zentraler Bedeutung. Sie werden später in Ihrer Journey darüber erfahren.

    Inhaltsfragmente-Editor - Mein Fragment

  • Ein Fragment, mit dem Sie einen langen Abschnitt mit Text schreiben können. Hier finden Sie zusätzliche Optionen zum Verwalten und Formatieren des Textes. Sie können die einzelnen Textfelder auch in einem Vollbild-Editor öffnen (mithilfe des kleinen Bildschirmähnlichen Symbols auf der rechten Seite)

    Inhaltsfragmente-Editor - Alaska-Spirituosen

HINWEIS

Möglicherweise ist eine projektspezifische Dokumentation erforderlich, um Autoren dabei zu helfen, einige Felder erfolgreich auszufüllen.

Allgemeine Informationen finden Sie unter Inhaltsfragmentmodelle - Datentypen und Eigenschaften .

Bestätigen Sie Ihre Aktualisierungen mit Save oder Save & close.

HINWEIS

Weitere Informationen finden Sie unter Varianten - Inhaltsfragmente erstellen .

Was Sie (wahrscheinlich) nicht benötigen

OK, dies mag ein etwas seltsamer Abschnitt sein, aber sobald Sie den Inhaltsfragment-Editor öffnen und mit der Untersuchung beginnen, sehen Sie verschiedene Optionen, die (wahrscheinlich) nicht für Ihre Headless-Journey als Inhaltsautor gelten. Das ist also nur ein kurzer Sprung nach dem, was man im Headless-Kontext ignorieren kann:

  • Inhaltsfragmentmodelle

    Der Name des Inhaltsfragmentmodells wird oben im Editor angezeigt - direkt unter dem Fragmentnamen. Dies ist auch ein Link, über den Sie zum Modell-Editor gelangen.
    Inhaltsfragmentmodelle sind für Ihre Inhaltsfragmente von entscheidender Bedeutung, da sie die von Ihnen verwendete Struktur definieren. Für die Erstellung und Bearbeitung ist jedoch (in der Regel) eine andere Person, der Inhaltsarchitekte, verantwortlich.

    HINWEIS

    Wenn Sie mehr erfahren möchten, können Sie die Journey AEM Headless Content Architect lesen.

  • Zugehörige Inhalte

    Das ist ganz offensichtlich, da es sich um einen Tab im Editor handelt.

    Inhaltsfragmente sind in AEM seit einigen Versionen verfügbar. Ursprünglich wurden sie für die "traditionelle"Verwendung bei der Seitenbearbeitung zur Verfügung gestellt…und werden weiterhin in diesem Zusammenhang verwendet. Dazu kann es gehören, Assets (z. B. Bilder) zuzuordnen, die zwar nicht in das Fragment eingebettet sind, aber für den Autor beim Erstellen einer Seite verfügbar sein müssen.

  • Vorschau

    Dies ist eine weitere Registerkarte im Editor und bietet eine technische Ansicht, die hauptsächlich für Entwickler gedacht ist.

  • Seitenverweise aktualisieren

    Diese Aktion ist über verfügbar… (Ellipsen). Es ist für Headless-Autoren nicht interessant, da es sich auf die Seitenbearbeitung bezieht.

Veröffentlichung

Nachdem Sie Ihr Fragment fertig gestellt haben, können Sie es veröffentlichen, damit es für Headless-Anwendungen verfügbar ist.

Die Veröffentlichungsaktionen sind im Editor verfügbar (oder in der Symbolleiste der Konsole Assets ):

Inhaltsfragmente-Editor - Mein Fragment

Wie geht es weiter

Nachdem Sie die Grundlagen gelernt haben, ist der nächste Schritt Erfahren Sie mehr über Verweise. Dadurch werden die verschiedenen verfügbaren Verweise vorgestellt und besprochen und die Erstellung von Strukturelementen mit den Fragmentverweisen beschrieben - ein wichtiger Bestandteil der Headless-Bearbeitung.

Zusätzliche Ressourcen

Auf dieser Seite