Erstellen von Inhaltsfragmenten
In diesem Kapitel erstellen und bearbeiten Sie neue Inhaltsfragmente, die auf den Team- und Person-Inhaltsfragmentmodellen basieren. Diese Inhaltsfragmente sind die Inhalte, die von der React-App unter Verwendung der AEM-Inhaltsfragmentbereitstellung mit OpenAPI-APIs genutzt werden.
Voraussetzungen
Dies ist ein mehrteiliges Tutorial und es wird davon ausgegangen, dass Sie die Schritte, die in Definieren von Inhaltsfragmentmodellen beschrieben sind, abgeschlossen haben.
Ziele
- Erstellen Sie ein Inhaltsfragment basierend auf einem Inhaltsfragmentmodell.
- Erstellen Sie ein Inhaltsfragment.
- Veröffentlichen Sie ein Inhaltsfragment.
Erstellen von Asset-Ordnern für Inhaltsfragmente
Inhaltsfragmente werden in AEM Assets in Ordnern gespeichert. Um Inhaltsfragmente aus den im vorherigen Kapitel erstellten Inhaltsfragmentmodellen zu erstellen, muss ein Ordner vorhanden sein, in dem sie gespeichert werden. Eine Konfiguration des Ordners ist erforderlich, um die Erstellung von Inhaltsfragmenten aus bestimmten Inhaltsfragmentmodellen zu ermöglichen.
AEM unterstützt eine „flache“ Ordnerorganisation, d. h. Inhaltsfragmente verschiedener Inhaltsfragmentmodelle werden in einem Ordner zusammengeführt. In diesem Tutorial wird jedoch eine Ordnerstruktur genutzt, die an den verwendeten Inhaltsfragmentmodellen ausgerichtet ist, zum Teil, um das API Alle Inhaltsfragmente nach Ordner auflisten im nächsten Kapitel zu erkunden. Berücksichtigen Sie bei der Festlegung der Organisation der Inhaltsfragmente sowohl, wie Sie Ihre Inhaltsfragmente erstellen und verwalten möchten, als auch, wie Sie sie über die AEM-Inhaltsfragmentbereitstellung mit OpenAPI-APIs bereitstellen und nutzen.
-
Navigieren Sie im AEM-Start-Bildschirm zu Assets > Dateien.
-
Tippen Sie in der oberen rechten Ecke auf Erstellen und dann auf Ordner. Geben Sie Folgendes ein:
- Titel: Mein Projekt
- Name: my-project
Wählen Sie Erstellen, um den Ordner zu erstellen.
-
Öffnen Sie den neuen Ordner Mein Projekt, und erstellen Sie unter dem neuen Ordner Mein Projekt einen Unterordner mit den folgenden Werten:
- Titel: Englisch
- Name: en
Ein Sprachstamm-Ordner wird erstellt, um das Projekt so zu positionieren, dass es die nativen Lokalisierungsfunktionen von AEM unterstützt. Eine Best Practice ist es, Projekte für mehrsprachigen Support einzurichten, selbst wenn Sie aktuell keine Lokalisierung benötigen. Weitere Informationen finden Sie auf der folgenden Dokumentseite.
-
Erstellen Sie unter dem neuen Ordner Mein Projekt > Englisch zwei Unterordner mit den folgenden Werten:
Einen
teams-Ordner, der die Team-Inhaltsfragmente enthält- Titel: Teams
- Name: Teams
… und einen
people-Ordner, der die Person-Inhaltsfragmente enthält.- Titel: Personen
- Name: Personen
-
Navigieren Sie zurück zum Ordner Mein Projekt > Englisch, und vergewissern Sie sich, dass die beiden neuen Ordner erstellt wurden.
-
Wählen Sie den Teams-Ordner aus, und wählen Sie in der oberen Aktionsleiste Eigenschaften aus.
-
Wählen Sie die Registerkarte Richtlinien aus, und deaktivieren Sie Vererbt von
/content/dam/my-project. -
Wählen Sie auf der Registerkarte Richtlinien das Inhaltsfragmentmodell Team im Feld Zulässige Inhaltsfragmentmodelle nach Pfad aus.
Diese Richtlinien werden automatisch von allen Unterordnern übernommen, können aber überschrieben werden. Inhaltsfragmentmodelle können nach Tags zugelassen werden oder Sie können Inhaltsfragmentmodelle aus anderen Projektkonfigurationen aktivieren. Dieser Mechanismus bietet eine leistungsstarke Möglichkeit, Ihre Inhaltshierarchie zu verwalten.
-
Tippen Sie auf Speichern und schließen, um die Änderungen an den Ordnereigenschaften zu speichern.
-
Aktualisieren Sie die Richtlinien für den Personen-Ordner auf dieselbe Weise, wählen Sie jedoch stattdessen das Person-Inhaltsfragmentmodell aus.
Erstellen eines Personen-Inhaltsfragments
Erstellen Sie Inhaltsfragmente auf Basis des Inhaltsfragmentmodells Person im Ordner Mein Projekt > Englisch > Personen.
-
Tippen Sie im AEM-Startbildschirm auf Inhaltsfragmente, um die Benutzeroberfläche für Inhaltsfragmente zu öffnen.
-
Wählen Sie die Schaltfläche Ordner anzeigen aus, um den Ordner-Browser zu öffnen.
-
Wählen Sie den Ordner Mein Projekt > Englisch > Personen aus.
-
Wählen Sie Erstellen > Inhaltsfragment und geben Sie die folgenden Werte ein:
- Speicherort:
/content/dam/my-project/en/people - Inhaltsfragmentmodell: Person
- Titel: Martin Müller
- Name:
john-doe
Denken Sie daran, dass die Felder Titel, Name und Beschreibung im Dialogfeld Neues Inhaltsfragment als Metadaten zum Inhaltsfragment gespeichert werden und nicht als Teil der Daten des Inhaltsfragments.
- Speicherort:
-
Wählen Sie Erstellen und öffnen aus.
-
Füllen Sie die Felder für das Fragment Martin Müller aus:
- Vollständiger Name: Martin Müller
- Biografie: Martin Müller liebt soziale Medien und reist gerne.
- Profilbild: Wählen Sie ein Bild aus
/content/damaus oder laden Sie ein neues hoch. - Beruf: Influencer, Reisender
Diese Felder und Werte definieren den Inhalt des Inhaltsfragments, der über die Bereitstellung von AEM-Inhaltsfragmenten mit APIs von OpenAPI genutzt wird.
-
Änderungen an Inhaltsfragmenten werden automatisch gespeichert, daher ist keine Schaltfläche Speichern vorhanden.
-
Kehren Sie zur Inhaltsfragmentkonsole zurück und wählen Sie Mein Projekt > Englisch > Person, um Ihr neues Inhaltsfragment anzuzeigen.
Erstellen zusätzlicher Personen-Inhaltsfragmente
Wiederholen Sie die obigen Schritte, um zusätzliche Personen-Fragmente zu erstellen.
-
Erstellen Sie ein Personen-Inhaltsfragment für Alina Schmidt mit den folgenden Eigenschaften:
- Speicherort:
/content/dam/my-project/en/people - Inhaltsfragmentmodell: Person
- Titel: Alina Schmidt
- Name:
alison-smith
Wählen Sie Erstellen und öffnen und geben Sie die folgenden Werte ein:
- Vollständiger Name: Alina Schmidt
- Biografie: Alison ist Fotografin und liebt es, über ihre Reisen zu schreiben.
- Profilbild: Wählen Sie ein Bild aus
/content/damaus oder laden Sie ein neues hoch. - Beruf: Fotografin, Reisende, Autorin.
- Speicherort:
Sie sollten jetzt zwei Inhaltsfragmente im Ordner Mein Projekt > Englisch > Personen haben:
Sie können optional einige weitere Personen-Inhaltsfragmente erstellen, um weitere Personen darzustellen.
Erstellen eines Team-Inhaltsfragments
Erstellen Sie mit demselben Ansatz ein Fragment Team basierend auf dem Inhaltsfragmentmodell Team im Ordner Mein Projekt > Englisch > Teams.
-
Erstellen Sie ein Team-Fragment, das Team Alpha mit den folgenden Eigenschaften darstellt:
- Speicherort:
/content/dam/my-project/en - Inhaltsfragmentmodell: Team
- Titel: Team Alpha
- Name:
team-alpha
Wählen Sie Erstellen und öffnen und geben Sie die folgenden Werte ein:
- Titel: Team Alpha
- Beschreibung: Team Alpha ist ein Reise-Content-Team, das sich auf Fotografie und Reiseberichte spezialisiert hat.
- Team-Mitglieder: Wählen Sie die Inhaltsfragmente Martin Müller und Alina Schmidt aus, um das Feld Team-Mitglieder zu füllen:
- Speicherort:
-
Wählen Sie Erstellen und öffnen, um das Team-Inhaltsfragment zu erstellen.
-
Unter Mein Projekt > Englisch > Team sollte sich ein Inhaltsfragment befinden:
Sie sollten jetzt über ein Inhaltsfragment Team Alpha im Ordner Mein Projekt > Englisch > Teams verfügen:
Erstellen Sie optional ein Team Omega mit einer anderen Personengruppe.
Veröffentlichen von Inhaltsfragmenten
Um Inhaltsfragmente über OpenAPIs verfügbar zu machen, veröffentlichen Sie sie. Die Veröffentlichung ermöglicht den Zugriff auf die Inhaltsfragmente über den:
- Veröffentlichungs-Service – stellt Inhalte für Produktionsanwendungen bereit
- Vorschau-Service – stellt Inhalte für Vorschau-Programme bereit
Normalerweise werden Inhalte zuerst im Vorschau-Service veröffentlicht und in einem Vorschau-Programm überprüft, bevor sie im Veröffentlichungs-Service veröffentlich werden. Beim Veröffentlichen im Veröffentlichungs-Service erfolgt keine gleichzeitige Veröffentlichung im Vorschau-Service. Sie müssen separat im Vorschau-Service veröffentlichen.
In diesem Tutorial veröffentlichen wir im AEM-Veröffentlichungs-Service. Die Verwendung des AEM-Vorschau-Service ist jedoch so einfach wie das Ändern der URL des AEM-Services in der React-App
-
Suchen Sie in der Inhaltsfragmentkonsole den Ordner Mein Projekt > Englisch.
-
Wählen Sie alle Inhaltsfragmente im Ordner Englisch aus, der alle Inhaltsfragmente in allen Unterordnern anzeigt, und wählen Sie in der oberen Aktionsleiste Veröffentlichen > Jetzt aus.
-
Wählen Sie den Veröffentlichungs-Service unter Alle Verweise einschließen aus, wählen Sie Unveröffentlicht und Geändert und anschließend Veröffentlichen aus.
Jetzt werden die Inhaltsfragmente und alle Person-Inhaltsfragmente, auf die die Team-Inhaltsfragmente verweisen, sowie alle referenzierten Assets im Veröffentlichungs-Service veröffentlicht.
Sie können auf die gleiche Weise im Vorschau-Service veröffentlichen.
Herzlichen Glückwunsch!
Herzlichen Glückwunsch! Sie haben erfolgreich Inhaltsfragmente basierend auf Inhaltsfragmentmodellen in AEM erstellt. Sie haben ein Person-Inhaltsfragmentmodell erstellt, mehrere Person-Inhaltsfragmente erstellt und ein Team-Inhaltsfragment erstellt, das auf mehrere Person-Inhaltsfragmente verweist.
Nach der Veröffentlichung der Inhaltsfragmente können Sie jetzt über die AEM-Inhaltsfragmentbereitstellung mit OpenAPI-APIs auf sie zugreifen.
Nächste Schritte
Im nächsten Kapitel Erkunden von OpenAPIs erkunden Sie die AEM-Inhaltsfragmentbereitstellung mit OpenAPI-APIs mithilfe der in der API-Dokumentation integrierten Funktion Jetzt ausprobieren.