Grundlagen zum Authoring für Headless mit AEM author-headless-basics

Die bisherige Entwicklung story-so-far

Zu Beginn der AEM Headless-Inhaltsautoren-Tour wurden in der Einführung die grundlegenden Konzepte und die Terminologie für das Authoring für Headless behandelt.

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

Ziel objective

Grundlegende Handhabung basic-handling

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

Authoring, Vorschau und Veröffentlichung author-preview-publish

Eine AEM-Installation besteht im Allgemeinen aus drei Umgebungen:

Sie melden sich an und verwenden die Autorenumgebung, um Ihre Inhalte zu erzeugen. Wenn Sie fertig sind, veröffentlichen Sie Ihre Inhalte, damit sie allgemein verfügbar werden. 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“.

Von der Inhaltsfragmentkonsole aus können Sie auch an den Vorschau-Service veröffentlichen, um vor der Veröffentlichung zu testen und eine Vorschau anzuzeigen. Siehe „Veröffentlichung und Vorschau eines Fragments“.

Anmeldung signing-in

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

Ihr Konto wurde mit den erforderlichen Berechtigungen konfiguriert. Sollten Sie Probleme haben, empfiehlt Adobe Ihnen, sich an Ihr internes Projektunterstützungs-Team zu wenden.

Navigation navigation

Wenn Sie sich zum ersten Mal anmelden, wird ein kleines Online-Tutorial einige der wichtigsten Funktionen der Benutzeroberfläche vorstellen.

Sie können dann über das Navigationsfenster auf wichtige Bereiche von AEM zugreifen. Für Inhaltsfragmente steht die Inhaltsfragmentkonsole zur Verfügung (für einige Aktionen können Sie auch die Assets-Konsole verwenden).

Das Navigationsfenster kann geöffnet werden, indem Sie links oben auf das Adobe-Symbol und dann auf das kleine Kompasssymbol klicken.

In der Konsole können Sie im linken Bereich Ordner auswählen, um zu Ihrem Inhaltsfragment zu navigieren. Sie können auch danach filtern und/oder suchen.

Aktionen, Auswählen, Anzeigen actions-selecting-viewing

In der Inhaltsfragmentkonsole stehen in der Symbolleiste mehrere Aktionen für Inhaltsfragmente zur Verfügung:

Nach der Auswahl eines Fragments werden alle passenden Aktionen angezeigt:

Erstellung von Inhaltsfragmenten authoring-content-fragments

Das war also eine sehr kurze Einführung in die AEM-Benutzeroberfläche (UI), aber ich hoffe, Sie hatten bereits die Gelegenheit, sie auszuprobieren. Jetzt kommen wir zu Ihrem echten Interesse – Inhaltsfragmente für Headless.

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

Organisieren und Navigieren organizing-and-navigating

Wenn Sie nicht gerade sehr wenige Inhaltsfragmente haben, werden Sie sie organisieren wollen – damit Sie (und andere) sie wiederfinden können.

Erstellen eines Ordners creating-folder

Dazu können Sie im Bereich Dateien der Assets-Konsole Ordner erstellen. Wählen Sie die Option Erstellen (oben rechts), gefolgt von Ordner:

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

Verwenden von Pfaden und Tags zur Beschränkung von Inhaltsfragmentmodellen, die im Ordner verfügbar sind tags-paths-for-models-in-folder

Dieser Abschnitt ist etwas komplexer. Man braucht ihn nicht wirklich, wenn man gerade erst anfängt und Dinge ausprobiert, aber er ist sehr nützlich, wenn man viele Fragmente hat. Also ist es gut, ihn zu kennen – auch wenn man ihn noch nicht wirklich benutzt.

Ihr Inhaltsarchitekt hat alle Inhaltsfragmentmodelle erstellt, die für Ihr aktuelles Projekt erforderlich sind, und möglicherweise auch für 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.

Nach dem Erstellen des Ordners können Sie die Eigenschaften des Ordners ö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 Erzeugen von Fragmenten in diesem Ordner verwendet werden können.

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

Nur für den Fall – Konfiguration von Ordner-Cloud-Services cloud-services-folder

Nur für den Fall…

Sie erhalten wahrscheinlich einen ersten Ordner, unter 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 inn den Cloud-Services des Ordners Eigenschaften überprüfen:

Erstellen eines Inhaltsfragments creating-fragment

In der Konsole Inhaltsfragmente können Sie mit Erstellen das Dialogfeld Neues Inhaltsfragment öffnen:

Geben Sie Folgendes an:

Bestätigen Sie dann Ihre Angaben, indem Sie entweder auf Erstellen oder auf Erstellen und öffnen klicken.

Bearbeiten eines Fragments editing-fragment

Sie können ein Fragment unmittelbar nach seiner Erstellung öffnen oder indem Sie es in der Inhaltsfragmente-Konsole (oder auch in der Assets-Konsole) auswählen.

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

Für ein Fragment kann beispielsweise Folgendes gelten:

Bestätigen Sie Ihre Aktualisierungen mit Speichern oder Speichern und schließen.

Worüber Sie sich (wahrscheinlich) keine Sorgen machen müssen what-you-probably-do-not-need-to-worry-about

OK, dieser Abschnitt mag etwas seltsam erscheinen, aber sobald Sie den Inhaltsfragment-Editor öffnen und mit der Erkundung beginnen, können Sie verschiedene Optionen sehen, die (wahrscheinlich) nicht für Ihre Headless-Inhaltsautoren-Tour relevant sind. Dies ist also nur ein kurzer Hinweis darauf, was man im Headless-Kontext ignorieren kann:

Veröffentlichung publishing

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

Die Veröffentlichungsaktionen sind im Editor verfügbar:

Wie geht es weiter whats-next

Nachdem Sie nun die Grundlagen gelernt haben, lautet der nächste Schritt: Erfahren Sie mehr über Verweise. Darin werden die verschiedenen verfügbaren Verweise vorgestellt und besprochen und die Erstellung von Strukturebenen mit den Fragmentverweisen beschrieben – ein wichtiger Bestandteil des Authoring für Headless.

Zusätzliche Ressourcen additional-resources