Ein Überblick über das Arbeiten mit Inhaltsfragmenten overview-working-with-content-fragments
In Adobe Experience Manager (AEM) as a Cloud Service können Sie mit Inhaltsfragmenten seitenunabhängige Inhalte entwerfen, erstellen, kuratieren und veröffentlichen. Sie ermöglichen es Ihnen, Inhalte so vorzubereiten, dass sie an mehreren Orten und über mehrere Kanäle verwendet werden können, ideal für die Headless-Bereitstellung und das Verfassen von Seiten.
- Verwendung der Assets-Konsole für die Verwaltung von Inhaltsfragmenten,
- Verwendung des originalen Inhaltsfragmenteditors,
- Verwendung von Inhaltsfragmenten für die Seitenerstellung.
Inhaltsfragmente enthalten strukturierte Inhalte:
-
Jedes Fragment basiert auf einem Inhaltsfragmentmodell.
- Das Inhaltsfragmentmodell definiert die Struktur des resultierenden Fragments.
-
Jedes Fragment besteht aus:
-
Die Struktur kann variieren:
-
Einfach
- Beispiel: ein einzelnes, mehrzeiliges Textfeld.
- Kann verwendet werden, um einfache Inhalte für die Verwendung bei der Seitenerstellung vorzubereiten.
- Kann auch für die Headless-Bereitstellung an Ihre Anwendung verwendet werden.
-
Komplex
- Eine Kombination aus vielen Feldern mit unterschiedlichen Datentypen, darunter Text, Zahlen, boolesche Werte, Datum und Uhrzeit, um nur einige zu nennen.
- Kann entweder zur Vorbereitung von strukturierteren Inhalten für die Seitenerstellung oder zur Headless-Bereitstellung für Ihr Programm verwendet werden.
-
Verschachtelt
- Mit den verfügbaren Referenzdatentypen können Sie Ihre Inhalte verschachteln.
- Wird in der Regel für die Headless-Bereitstellung an Ihre Anwendung verwendet.
-
Mit der Sling Model (JSON)-Exportfunktion der AEM-Kernkomponenten können Inhaltsfragmente auch im JSON-Format bereitgestellt werden. Diese Form der Bereitstellung:
- bietet Ihnen die Möglichkeit, mithilfe der Komponente zu bestimmen, welche Fragmentelemente bereitgestellt werden sollen
- ermöglicht durch das Hinzufügen mehrerer Inhaltsfragment-Kernkomponenten auf der für die API-Bereitstellung verwendeten Seite eine Bereitstellung in größerem Umfang
Die Anzahl der Kommunikationskanäle nimmt jährlich zu. Typischerweise beziehen sich Kanäle auf den Bereitstellungsmechanismus, und zwar wie folgt:
- Physischer Kanal; z. B. Desktop, Mobilgerät.
- Form der Bereitstellung in einem physischen Kanal; z. B. die Produktdetailseite, die Produktkategorieseite für Desktops oder „mobiles Web“, „Mobile App“ für Mobilgeräte.
Sie möchten jedoch (wahrscheinlich) nicht den exakt gleichen Inhalt für alle Kanäle verwenden – Sie müssen Ihre Inhalte entsprechend dem jeweiligen Kanal optimieren.
Inhaltsfragmente ermöglichen Ihnen Folgendes:
- Erwägen, wie sich Zielgruppen effizient kanalübergreifend erreichen lassen
- Kanalneutrale redaktionelle Inhalte erstellen und verwalten
- Inhaltspools für mehrere Kanäle erstellen
- Inhaltsvarianten für bestimmte Kanäle entwerfen
- Hinzufügen von Bildern durch Einfügen von Assets zu Texten
- Erstellen Sie verschachtelte Inhalte, um die Komplexität Ihrer Daten widerzuspiegeln.
Diese Inhaltsfragmente können dann zusammengestellt werden, um Erlebnisse über verschiedene Kanäle bereitzustellen.
- Inhaltsfragmente sind redaktionelle Inhalte mit Definition und Struktur, aber ohne zusätzliches visuelles Design und/oder Layout. Sie können unter anderem für den Zugriff auf strukturierte Daten wie Texte, Zahlen und Datumsangaben verwendet werden.
- Experience Fragments sind vollständig gestaltete Inhalte und stellen Teile von Web-Seiten dar.
Hier und auf den folgenden Seiten werden die Aufgaben zum Erstellen, Konfigurieren, Verwalten und Verwenden von Inhaltsfragmenten beschrieben:
- Aktivieren der Funktionen für Inhaltsfragmente für Ihre Instanz
- Inhaltsfragmentmodelle: Aktivieren, Erstellen und Definieren Ihrer Modelle
- Erstellen von Inhaltsfragmenten (mithilfe der Inhaltsfragmentkonsole)
Nachdem das Fragment erstellt wurde, können Sie Folgendes tun:
- Verwenden der Inhaltsfragmentkonsole: Um auf Ihre Fragmente zuzugreifen, sie zu veröffentlichen (als Vorschau oder in der Produktion) und auf sie zu verweisen.
- Verwenden des Inhaltsfragmenteditors: Um Ihre Fragmente zu bearbeiten, sie zu veröffentlichen (als Vorschau oder in der Produktion) und auf sie zu verweisen.
- Analysieren der Struktur Ihres Inhaltsfragments mithilfe des Editors
- Zugreifen auf Ihre Fragmente mit GraphQL, für eine Headless-Bereitstellung an Ihre Anwendungen
- Oder Verwenden Ihrer Fragmente für die Seitenerstellung
- Anpassen und Erweitern von Inhaltsfragmenten
- Inhaltsfragmente, die Komponenten für die Wiedergabe konfigurieren
- Unterstützung von Inhaltsfragmenten in der AEM Assets-HTTP-API
- AEM GraphQL-API zur Verwendung mit Inhaltsfragmenten
- Seitenbearbeitung mit Inhaltsfragmenten.
- Die OpenAPIs für Inhaltsfragmente und Inhaltsfragmentmodelle sind ebenfalls verfügbar.
Hauptteil und Varianten main-and-variations
Varianten sind eine wichtige Funktion von AEM-Inhaltsfragmenten. Sie können damit Kopien des Haupt-Inhalts erstellen und bearbeiten, um sie in bestimmten Kanälen und Szenarien zu verwenden. Dadurch wird die Bereitstellung von Headless-Inhalten und die Seitenbearbeitung noch flexibler.
-
Allgemein
-
Der Hauptteil ist keine Variante an sich, sondern die Grundlage aller Varianten.
-
Integraler Bestandteil des Fragments:
- Jedes Inhaltsfragment hat eine Hauptteil-Instanz.
- Der Hauptteil kann nicht gelöscht werden.
-
Der Hauptteil ist im Fragmenteditor unter Varianten zugänglich.
note note NOTE Im Editor, der über die Assets-Konsole verfügbar ist, ist der Hauptteil als Primär gekennzeichnet. -
-
Varianten
- Ausgabedarstellungen von Fragmenttext, eigens zu redaktionellen Zwecken. Diese können mit einem Kanal verbunden sein, doch ist dies nicht obligatorisch; auch für lokale Ad-hoc-Änderungen geeignet;
- Werden als Kopien des Hauptteils erstellt, können dann aber nach Bedarf bearbeitet werden, wobei es oft inhaltliche Überschneidungen zwischen den Varianten selbst gibt.
- Können während der Erstellung von Fragmenten über das linke Bedienfeld definiert werden.
- Werden im Fragment gespeichert, um zu vermeiden, dass Inhaltskopien verstreut werden.
- Varianten können mit dem Hauptteil verglichen und synchronisiert werden.
Inhaltsfragmente und Content Services content-fragments-and-content-services
Mit den AEM Content Services können die Beschreibung und Bereitstellung von Inhalten in/über AEM über einen Fokus auf Web-Seiten hinweg generalisiert werden.
Sie ermöglichen die Bereitstellung von Inhalten in Kanälen, die keine traditionellen AEM-Web-Seiten sind, und nutzen standardisierte Methoden, die von allen Clients genutzt werden können. Diese Kanäle können Folgendes sein:
- Single Page Applications (SPA)
- native Mobile Apps
- weitere AEM-externe Kanäle und Touchpoints
Der Versand erfolgt im JSON-Format mit dem JSON-Exporter.
AEM-Inhaltsfragmente können zur Beschreibung und Verwaltung strukturierter Inhalte verwendet werden. Strukturierter Inhalt wird in Modellen definiert, die eine Vielzahl von Inhaltstypen enthalten können, darunter Text, numerische Daten, boolesche Ausdrücke, Datum und Uhrzeit und mehr.
Zusammen mit der JSON-Exportfunktion der AEM-Kernkomponenten kann dieser strukturierte Inhalt dann zur Bereitstellung von AEM-Inhalten auf anderen Kanälen als AEM-Seiten verwendet werden.
Inhaltstyp content-type
Inhaltsfragmente werden:
-
eine Sites-Funktion.
-
als Assets gespeichert:
- Inhaltsfragmente (und deren Varianten) können in der Inhaltsfragmentkonsole erstellt und verwaltet werden.
- Erstellt und bearbeitet im Inhaltsfragmenteditor.
-
Zugänglich für die Bereitstellung von Inhalten über die AEM GraphQL-API.
-
Verfügbar im Seiteneditor unter Verwendung der Inhaltsfragmentkomponente (Verweiskomponente):
- Die Inhaltsfragment-Kernkomponente steht für Autorinnen und Autoren der Seite zur Verfügung. Sie ermöglicht das Verweisen und Bereitstellen des erforderlichen Inhaltsfragments im HTML- oder JSON-Format.
Inhaltsfragmente sind eine Inhaltsstruktur mit folgenden Eigenschaften:
- Sie weisen kein Layout oder Design auf (Textformatierung ist in Textfeldern möglich).
- Sie sind unabhängig vom Bereitstellungsmechanismus (z. B. Seite oder Kanal).
- Enthalten mindestens einen Bestandteil.
- Kann Bilder enthalten oder mit Bildern verbunden sein.
Fragmente mit visuellen Assets fragments-with-visual-assets
Um Autorinnen und Autoren eine bessere Kontrolle über eigene Inhalte zu ermöglichen, können zu einem Inhaltsfragment Bilder hinzugefügt und/oder darin integriert werden.
Assets können auf verschiedene Weise mit einem Inhaltsfragment verwendet werden; jede hat ihre eigenen Vorteile:
- als Inhaltsverweis
- innerhalb eines mehrzeiligen Textfelds
Bestandteile von Inhaltsfragmenten constituent-parts-of-a-content-fragment
Inhaltsfragment-Assets setzen sich aus folgenden Teilen zusammen (entweder direkt oder indirekt):
-
Fragmentelementen
- Elemente korrelieren mit den Datenfeldern, die Inhalte enthalten.
- Verwenden Sie ein Inhaltsfragmentmodell, um das Inhaltsfragment zu erstellen. Die im Modell angegebenen Elemente (Felder) definieren die Struktur des Fragments. Bei diesen Elementen (Feldern) gibt es verschiedene Datentypen.
-
Fragmentabsätze
-
Textblöcke, häufig mehrzeilig, die als einzelne Entitäten getrennt sind.
-
Aktivieren Sie die Inhaltskontrolle während der Seitenerstellung.
-
-
Fragmentmetadaten
-
Verwendung der Assets-Metadatenschemata
-
Tag-Erstellung möglich:
- Beim Erstellen und Bearbeiten des Fragments
- Oder später, wenn Sie im Fragmenteditor die Eigenschaften anzeigen oder bearbeiten
note caution CAUTION Profile für die Metadatenverarbeitung sind nicht für Inhaltsfragmente geeignet. note caution CAUTION In einem Inhaltsfragmentmodell werden häufig Datenfelder mit den Namen Titel und Beschreibung definiert. Wenn diese beiden Felder vorhanden sind, handelt es sich um benutzerdefinierte Felder, die im Inhaltsbereich des Editors aktualisiert werden können. Das Inhaltsfragment und seine Variationen verfügen auch über Metadatenfelder (Eigenschaftsfelder) namens Titel und Beschreibung. Diese beiden Metadatenfelder sind integraler Bestandteil jedes Inhaltsfragments und jeder Variation und werden bei der Erstellung des Fragments definiert. Sie können im Bereich „Eigenschaften/Metadaten“ des Editors aktualisiert werden. -
Voraussetzungen für Fragmente required-by-fragments
Um Inhaltsfragmente zu erstellen, benötigen Sie:
-
Inhaltsmodelle
- Werden mithilfe des Konfigurations-Browsers aktiviert.
- Werden mithilfe von Tools erstellt.
- Erforderlich zum Erstellen eines Fragments.
- Definiert die Struktur eines Fragments (Titel, Inhaltselemente, Tag-Definitionen).
- Definitionen von Inhaltsfragmentmodellen erfordern einen Titel und ein Datenelement. Alle weiteren Elemente sind optional.
- Das Modell kann Standardinhalte definieren, sofern anwendbar.
- Autorinnen und Autoren können die definierte Struktur beim Bearbeiten von Fragmentinhalten nicht ändern. Sie können jedoch den Modelleditor über den Fragmenteditor öffnen.
- Änderungen, die nach dem Erstellen von abhängigen Inhaltsfragmenten an einem Modell vorgenommen wurden, können sich auf diese Inhaltsfragmente auswirken.
Um Ihre Inhaltsfragmente für die Bereitstellung von Headless-Inhalten zu verwenden, benötigen Sie außerdem:
-
Eine GraphQL-Abfrage zur Abfrage des gewünschten Inhalts.
-
Diese Inhalte können dann zur Entwicklung Ihrer eigenen SPA für AEM verwendet werden. Weitere Informationen finden Sie in den folgenden Dokumenten:
Um Ihre Inhaltsfragmente zum Erstellen von Seiten zu verwenden, benötigen Sie außerdem Folgendes:
-
Eine Inhaltsfragmentkomponente
- Hilft bei der Bereitstellung des Fragments im HTML- und/oder JSON-Format.
- Erforderlich zum Referenzieren des Fragments auf einer Seite.
- Zuständig für das Layout und die Bereitstellung eines Fragments, z. B. Kanäle.
- Fragmente benötigen eine oder mehrere dedizierte Komponenten zur Definition des Layouts sowie zur Bereitstellung einiger oder aller Elemente/Varianten und zugehörigen Inhalte.
- Durch Ziehen eines Fragments auf eine Seite während der Bearbeitung wird die erforderliche Komponente automatisch zugewiesen.
- Siehe Inhaltsfragment-Kernkomponente.
Anwendungsbeispiel example-usage
Ein Fragment samt seinen Elementen und Varianten kann zur Erstellung von kohärentem Inhalt für verschiedene Kanäle verwendet werden. Beim Entwurf eines Fragments muss berücksichtigt werden, welche Elemente wo verwendet werden.
WKND-Beispiel wknd-sample
Die Beispiele der WKND-Site und WKND Shared helfen Ihnen dabei, mehr über AEM as a Cloud Service zu erfahren.
Das WKND-Projekt umfasst:
-
Inhaltsfragmentmodelle verfügbar unter:
-
.../libs/dam/cfm/models/console/content/models.html/conf/wknd -
.../ui#/aem/libs/dam/cfm/models/console/content/models.html/conf/wknd-shared
-
-
Inhaltsfragmente (und anderere Inhalte) verfügbar unter:
.../assets.html/content/dam/wknd/en