DokumentationAEM as a Cloud ServiceBenutzerhandbuch

Verwalten von Inhaltsfragmentmodellen managing-content-fragment-models

Last update: Tue May 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Benutzende
  • Entwickler

In der Inhaltsfragmentkonsole können Sie Ihre Inhaltsfragmentmodelle verwalten und dann den Editor öffnen, um die Struktur zu definieren.

In Inhaltsfragmentmodellen in Adobe Experience Manager (AEM) as a Cloud Service wird die Struktur des Inhalts Ihrer Inhaltsfragmente definiert. Diese Fragmente können anschließnd als Grundlage für Ihren Headless-Inhalt oder für die Seitenbearbeitung verwendet werden.

NOTE
Diese Seite enthält den Abschnitt der Konsole, in dem (nur) Inhaltsfragmentmodelle angezeigt werden. Für andere Panels siehe:
NOTE
Inhaltsfragmente werden als Assets gespeichert. Inhaltsfragmentmodelle werden hauptsächlich über die Konsole Inhaltsfragmente verwaltet, können jedoch auch über die Konsole Assets sowie die Option Inhaltsfragmentmodelle verwaltet werden, die unter Tools – Allgemein verfügbar ist.

Arbeiten mit Inhaltsfragmentmodellen how-to-work-with-content-fragment-models

Ein schneller Überblick über die Arbeit mit Inhaltsfragmentmodellen:

  1. Aktivieren Sie die Funktion für Inhaltsfragmentmodelle für Ihre Instanz.
  2. Erstellen Sie Ihr Inhaltsfragmentmodell.
    • An dieser Stelle können Sie auch das Modell aktivieren (zur Verwendung beim Erstellen von Inhaltsfragmenten).
  3. Definieren Sie die Struktur Ihres Modells.
  4. Aktivieren Sie Ihr Inhaltsfragmentmodell, falls noch nicht geschehen.
  5. Lassen Sie Ihre Inhaltsfragmentmodelle in den erforderlichen Asset-Ordnern zu, indem Sie Richtlinien konfigurieren.

Grundlegende Struktur und Handhabung von Inhaltsfragmenten in der Konsole basic-structure-handling-content-fragment-models-console

Sie können in der Inhaltsfragmentkonsole im Panel ganz links Inhaltsfragmenmodelle als Ressourcentyp auswählen, um Folgendes anzuzeigen, zu durchsuchen und zu verwalten:

Inhaltsfragmentkonsole – Navigation

Dadurch wird die Ansicht für Inhaltsfragmentmodelle geöffnet:

Inhaltsfragmentkonsole – Verwalten von Inhaltsfragmentmodellen

Hier können Sie sehen, dass es drei Hauptbereiche gibt:

  • Die obere Symbolleiste

    • Bietet die standardmäßigen AEM-Funktionen
    • Zeigt auch Ihre IMS-Organisation an
    • Bietet verschiedene Aktionen

  • Das linke Panel

    • Zeigt die Pfade zu allen Konfigurationen aufgeführt als Ordner an
    • Hier können Sie die Ordnerstruktur ein- oder ausblenden
    • Sie können einen bestimmten Ordner des Baums auswählen
    • Die Größe kann geändert werden, um verschachtelte Ordner (Unterkonfigurationen) anzuzeigen
    • Neben Inhaltsfragmentmodellen können Sie auch Inhaltsfragmente oder Assets anzeigen und Sie können auch Links zu den Panels komprimieren oder erweitern

  • Das Haupt-/rechte Panel – von hier aus können Sie:

    • Eine Liste aller Inhaltsfragmentmodelle im ausgewählten Ordner anzeigen:

      • Es werden die Inhaltsfragmentmodelle aus dem ausgewählten Ordner und dazu alle Unterordner angezeigt:

        • Der Speicherort wird durch die Breadcrumbs angegeben. Diese können auch verwendet werden, um den Speicherort zu ändern:

      • Es werden Informationen zu den einzelnen Modellen angezeigt

      • Verschiedene Informationsfelder zu einem Inhaltsfragmentmodell stellen Links bereit. Je nach Feld können diese:

        • Das entsprechende Modell im Editor öffnen
        • Informationen über den Pfad zur Konfiguration anzeigen
        • Informationen zum Status des Modells anzeigen

      • Bestimmte andere Informationsfelder über ein Inhaltsfragmentmodell können für Schnelles Filtern verwendet werden:

        • Auswählen eines Wertes in der Spalte, der sofort als Filter angewendet wird
        • Schnelles Filtern wird nur für die Spalten Geändert von, Veröffentlicht von und Status unterstützt.

      • Wenn Sie den Mauszeiger über die Spaltenüberschriften bewegen, werden ein Selektor der Dropdown-Aktionen und ein Breitenregler angezeigt. Diese ermöglichen Ihnen Folgendes:

        • Sortieren – Wählen Sie die entsprechende Aktion für aufsteigende bzw. absteigende Darstellung aus.
          Dadurch wird die gesamte Tabelle nach dieser Spalte sortiert. Die Sortierung ist nur für die entsprechenden Spalten verfügbar.
        • Ändern Sie die Größe der Spalte – entweder mithilfe der Aktion oder der Breitenregler

      • Wählen Sie ein oder mehrere Fragmente für weitere Aktionen aus

    • Öffnen des Filterbereichs

    • In dieser Konsole stehen verschiedene Tastaturbefehle zur Verfügung

Die bereitgestellten Informationen zu Ihren Inhaltsfragmentmodellen information-content-fragment-models

Das Haupt-/rechte Panel (Tabellenansicht) der Konsole enthält eine Reihe von Informationen zu Ihren Inhaltsfragmentmodellen. Einige Elemente bieten auch direkte Links zu weiteren Aktionen und/oder Informationen:

  • Name

    • Stellt einen Link zum Öffnen des Modells im Editor bereit.

  • Gesperrt (Schlosssymbol)

    • Wenn das Modell gesperrt ist, wird dies durch ein Schlosssymbol angezeigt.

  • Pfad

    • Stellt den Pfad als Link zum Öffnen der Konfiguration in der Konsole bereit.
      Wenn Sie den Mauszeiger über einen Ordnernamen bewegen, wird der JCR-Pfad angezeigt.

  • Status

  • Geändert

    • Nur Informationen.

  • Geändert von

  • Tags

    • Nur Informationen.
    • Zeigt alle Tags an, die sich auf das Modell beziehen.
    • Kann für Schnelles Filtern verwendet werden.

  • Veröffentlicht um

    • Nur Informationen.

  • Herausgeber

Modelleigenschaften model-properties

Wenn Sie ein bestimmtes Modell auswählen, werden die Eigenschaften dieses Modells angezeigt (wie beim Erstellen des Modells definiert). Wenn das Modell nicht gesperrt ist, können einige Elemente aktualisiert werden. Sie können auch das Informationssymbol (neben dem Modell Titel) verwenden, um das Panel „Informationen“ zu öffnen und zu schließen.

Inhaltsfragmentkonsole – Informationen für ein ausgewähltes Inhaltsfragmentmodell

  • Pfad

  • Status

  • Titel

  • Tags

  • Beschreibung

  • Muster für URL-Vorschau

    Inhaltsfragmentmodelle ermöglichen es Autorinnen und Autoren, ihren Inhalt in einer externen Frontend-Anwendung in der Vorschau anzuzeigen. Sobald der Vorschau-Service konfiguriert ist, können Sie die URL für die Frontend-Anwendung hinzufügen.

    Die Vorschau-URL sollte diesem Muster entsprechen:
    https://<preview_url>?param=${expression}

    Verfügbare Ausdrücke sind:

    • ${contentFragment.path}
    • ${contentFragment.model.path}
    • ${contentFragment.model.name}
    • ${contentFragment.variation}
    • ${contentFragment.id}

Aktionen actions

Nachdem Sie einen Ordner ausgewählt haben (im linken Panel), gibt es eine Reihe von Aktionen, die Sie entweder direkt oder nach Auswahl eines bestimmten Modells verwenden können:

Aktionen (nicht ausgewählt) actions-unselected

Bestimmte Aktionen sind über die Konsole verfügbar, nachdem Sie einen Ordner, aber kein bestimmtes Inhaltsfragmentmodell ausgewählt haben:

Aktionen für ein Inhaltsfragmentmodell in der Inhaltsfragmentkonsole actions-selected-content-fragment-models

Wenn Sie ein bestimmtes Modell auswählen, wird eine Symbolleiste geöffnet, die die verfügbaren Aktionen für dieses Modell anzeigt. Sie können auch mehrere Modelle auswählen. Die Auswahl der verfügbaren Aktionen wird dann entsprechend angepasst.

  • Bearbeiten, um Ihr Inhaltsfragmentmodell zu definieren.
  • Veröffentlichen entweder auf der Veröffentlichungs- oder der Vorschau-Ebene.
  • Sperren/Entsperren, um zu steuern, ob eine Person zum Ändern des Modells berechtigt ist.
  • Aktivieren/Deaktivieren, um zu steuern, ob eine Person Inhaltsfragmente auf Grundlage dieses Modells erstellen darf.

Wenn Sie ein einzelnes Modell auswählen, werden im rechten Panel auch die Modelleigenschaften angezeigt.

Auswählen der Spalten, die in der Konsole angezeigt werden select-columns-console

Wie bei anderen Konsolen können Sie konfigurieren, welche Spalten sichtbar und für eine Aktion verfügbar sind:

Inhaltsfragmentkonsole – Spaltenkonfiguration

Daraufhin wird eine Liste von Spalten angezeigt, die Sie ausblenden oder anzeigen können:

Inhaltsfragmentkonsole – Spaltenkonfiguration

Filtern von Inhaltsfragmentmodellen filter-content-fragment-models

Der Panel zum Filtern bietet folgende Optionen:

  • eine Auswahl von Prädikaten;

    • einschließlich Statusfeldern, Tags, Benutzenden usw.
    • es kann ein Prädikat ausgewählt oder auch mehrere kombiniert werden, um den Filter zu erstellen

Nach der Auswahl werden die Optionen zum Filtern nach angezeigt (oben im Haupt-Panel). Sie können von dort aus abgewählt werden. Zum Beispiel:

Inhaltsfragmentkonsole – Filtern von Inhaltsfragmentmodellen

Schnelles Filtern fast-filtering

Sie können auch ein Prädikat auswählen, indem Sie auf einen bestimmten Spaltenwert in der Liste klicken. Sie können einen oder mehrere Werte auswählen, um Eigenschaften zu kombinieren.

Wählen Sie zum Beispiel Aktiviert in der Spalte Status aus. Nach der Auswahl wird dies als Filtereigenschaft angezeigt und die Liste entsprechend gefiltert.

NOTE
Schnelles Filtern wird nur für die Spalten Status, Geändert von, Tags und Veröffentlicht von unterstützt.
NOTE
Schnelles Filtern funktioniert auf dieselbe Weise wie Inhaltsfragmente in der Konsole.

Erstellen eines Inhaltsfragmentmodells creating-a-content-fragment-model

  1. Navigieren Sie zu dem Ordner, der Ihrer Konfiguration oder Unterkonfiguration entspricht.

  2. Verwenden Sie Erstellen, um das Dialogfeld zu öffnen.

    note caution
    CAUTION
    Die Option Erstellen ist nur in folgenden Fällen verfügbar:

  3. Wählen Sie den Pfad zur Konfiguration aus und geben Sie den Namen an.

    note note
    NOTE
    Die Konfiguration wird automatisch mit der aktuellen Konfiguration ausgefüllt (der Ordner, in dem Sie sich derzeit befinden).
    Sie können die Konfiguration auch ändern, indem Sie auf das Ordnersymbol klicken.

    Sie können auch verschiedene Eigenschaften definieren:

    • Titel
      Wenn Sie zuerst den Titel eingeben, wird der Name daraus generiert.
    • eine Beschreibung
    • Modell aktivieren, um das Modell zu aktivieren
    note note
    NOTE
    Weitere Informationen finden Sie unter Inhaltsfragmentmodell – Eigenschaften.

    Titel und Beschreibung

  4. Wählen Sie Erstellen aus, um das leere Modell zu speichern, oder verwenden Sie Erstellen und öffnen.

Aktivieren eines Inhaltsfragmentmodells enabling-a-content-fragment-model

Nachdem ein Modell erstellt wurde, muss es aus folgenden Gründen aktiviert werden:

  • Damit es zur Auswahl steht, wenn ein neues Inhaltsfragment erstellt wird.
  • Damit es in einem Inhaltsfragmentmodell referenziert werden kann.
  • Damit es für GraphQL verfügbar ist, sodass das Schema generiert wird.

Sie können ein Modell in folgenden Fällen aktivieren:

  • Wenn ein neues Modell erstellt wird
    • Eine entsprechende Option wird im Dialogfeld angezeigt.
  • Wenn ein Modell explizit deaktiviert wurde
    • Wenn das gewünschte Modell ausgewählt ist, ist die Aktion Aktivieren in der oberen Symbolleiste verfügbar.

Deaktivieren eines Inhaltsfragmentmodells disabling-a-content-fragment-model

Ein Modell lässt sich auch aus folgenden Gründen deaktivieren:

  • Das Modell ist nicht mehr als Grundlage für die Erstellung neuer Inhaltsfragmente verfügbar.

  • Beachten Sie jedoch Folgendes:

    • Das GraphQL-Schema wird weiterhin generiert und kann weiterhin abgefragt werden (um eine Beeinträchtigung der JSON-API zu vermeiden).
    • Inhaltsfragmente, die auf dem Modell basieren, können weiterhin abgefragt und vom GraphQL-Endpunkt zurückgegeben werden.

  • Das Modell kann nicht mehr referenziert werden. Vorhandene Referenzen bleiben jedoch unverändert und können weiterhin abgefragt und vom GraphQL-Endpunkt zurückgegeben werden.

Um ein Modell zu deaktivieren, das als Aktiviert gekennzeichnet ist, verwenden Sie die Option Deaktivieren über:

  • Die obere Symbolleiste, wenn das erforderliche Modell ausgewählt ist.

Zulassen von Inhaltsfragmentmodellen im Asset-Ordner allowing-content-fragment-models-assets-folder

Zur Implementierung der Inhaltsverwaltung können Sie Richtlinien im Asset-Ordner konfigurieren, um zu steuern, welche Inhaltsfragmentmodelle für die Fragmenterstellung in diesem Ordner zulässig sind.

NOTE
Der Mechanismus ähnelt dem Zulassen von Seitenvorlagen für eine Seite und deren untergeordnete Elemente in den erweiterten Eigenschaften einer Seite.

So konfigurieren Sie die Richtlinien für Zulässige Inhaltsfragmentmodelle:

  1. Navigieren Sie zum gewünschten Asset-Ordner und öffnen Sie Eigenschaften.

  2. Öffnen Sie die Registerkarte Richtlinien, in der Sie Folgendes konfigurieren können:

    • Vererbt von<folder>

      Richtlinien werden beim Erstellen untergeordneter Ordner automatisch übernommen. Die Richtlinie kann neu konfiguriert (und die Vererbung aufgehoben) werden, wenn für Unterordner Modelle zugelassen werden müssen, die vom übergeordneten Ordner abweichen.

    • Zugelassene Inhaltsfragmentmodelle nach Pfad

      Es können mehrere Modelle zugelassen werden.

    • Zugelassene Inhaltsfragmentmodelle nach Tag

      Es können mehrere Modelle zugelassen werden.

    Richtlinie für Inhaltsfragmentmodell

  3. Speichern Sie die Änderungen.

Die für einen Ordner zulässigen Inhaltsfragmentmodelle werden wie folgt aufgelöst:

  • Die Richtlinien für Zulässige Inhaltsfragmentmodelle.
  • Falls leer, versuchen Sie, die Richtlinie mithilfe der Vererbungsregeln zu bestimmen.
  • Wenn die Vererbungskette kein Ergebnis liefert, prüfen Sie die Cloud Services-Konfiguration für diesen Ordner (auch zuerst direkt und dann über Vererbung).
  • Wenn keines der oben genannten Verfahren Ergebnisse liefert, gibt es keine zulässigen Modelle für diesen Ordner.

Veröffentlichen eines Inhaltsfragmentmodells publishing-a-content-fragment-model

Inhaltsfragmentmodelle müssen zeitgleich mit oder im Vorfeld der Veröffentlichung abhängiger Inhaltsfragmente veröffentlicht werden.

So veröffentlichen Sie ein Inhaltsfragmentmodell:

  1. Navigieren Sie zu Ihrem Inhaltsfragmentmodell und wählen Sie dieses aus. Sie können mehrere Modelle auswählen.

  2. Wählen Sie in der Symbolleiste die Option Veröffentlichen aus.

  3. Wählen Sie im Dialogfeld „Veröffentlichen“ das Ziel aus:

    • Veröffentlichungs-Service
    • Vorschau-Service

  4. Der Workflow zum Veröffentlichen der ausgewählten Modelle und ihrer Referenzen wird gestartet. Der Status „Veröffentlicht“ wird daraufhin in der Konsole angezeigt.

Gesperrte Inhaltsfragmentmodelle locked-content-fragment-models

Mit dieser Funktion können Sie steuern, ob ein Modell aktualisiert werden kann. Sie bietet aber auch Governance für Inhaltsfragmentmodelle, die veröffentlicht wurden.

Die Herausforderung the-challenge

  • Inhaltsfragmentmodelle bestimmen das Schema für GraphQL-Abfragen in AEM.

    • AEM GraphQL-Schemas werden erstellt, sobald ein Inhaltsfragmentmodell erstellt wird, und sie können in der Autoren- und Veröffentlichungsumgebung vorhanden sein.

    • Schemas in der Veröffentlichungsinstanz sind die wichtigsten, da sie die Grundlage für die Live-Bereitstellung von Inhaltsfragmentinhalten im JSON-Format bieten.

  • Probleme können auftreten, wenn Inhaltsfragmentmodelle geändert oder bearbeitet werden. Das bedeutet, dass sich das Schema ändert, was wiederum vorhandene GraphQL-Abfragen beeinflussen kann.

  • Das Hinzufügen neuer Felder zu einem Inhaltsfragmentmodell sollte (in der Regel) keine schädlichen Auswirkungen haben. Wenn Sie jedoch vorhandene Datenfelder (z. B. deren Namen) ändern oder Felddefinitionen löschen, werden vorhandene GraphQL-Abfragen bei der Anforderung dieser Felder beschädigt.

Die Voraussetzungen the-requirements

  • Anwender wurden auf die Risiken aufmerksam gemacht, die bei der Bearbeitung von Modellen auftreten, die bereits für die Bereitstellung von Live-Inhalten verwendet werden (d. h. von Modellen, die veröffentlicht wurden).

  • Außerdem die Vermeidung von unbeabsichtigten Änderungen.

In beiden Fällen können Abfragen beschädigt werden, wenn die geänderten Modelle erneut veröffentlicht werden.

Die Lösung the-solution

Um diese Probleme zu lösen, werden die Inhaltsfragmentmodelle in der Autorenumgebung durch einen SCHREIBGESCHÜTZTEN Modus gesperrt, sobald sie veröffentlicht wurden. Dieser Status wird durch Gesperrt angezeigt.

Wenn das Modell Gesperrt ist (im schreibgeschützten Modus), können Sie die Inhalte und die Struktur der Modelle anzeigen, sie jedoch nicht bearbeiten.

Sie können Gesperrte Modelle entweder aus der Konsole heraus oder im Modell-Editor verwalten:

  • Konsole

    In der Konsole können Sie den SCHREIBGESCHÜTZTEN Modus mit den Aktionen Entsperren und Sperren in der Symbolleiste verwalten.

    • Sie können ein Modell zum Aktivieren von Bearbeitungen entsperren.

      Wenn Sie Entsperren auswählen, wird eine Warnung angezeigt und Sie müssen die Aktion Entsperren bestätigen.

      Anschließend können Sie das Modell zum Bearbeiten öffnen.

    • Sie können das Modell anschließend auch wieder Sperren.

    • Wenn Sie das Modell erneut veröffentlichen, wird es sofort wieder in den Modus Gesperrt (SCHREIBGESCHÜTZT) zurückgesetzt.

  • Modell-Editor

    • Wenn Sie ein gesperrtes Modell öffnen, werden Sie gewarnt und es werden drei Aktionen angezeigt: Abbrechen, Anzeigen (schreibgeschützt) und Bearbeiten.

    • Wenn Sie Anzeigen (schreibgeschützt) auswählen, können Sie den Inhalt und die Struktur des Modells sehen.

    • Wenn Sie Bearbeiten auswählen, können Sie Ihre Änderungen bearbeiten und speichern:

      Bearbeiten – gesperrtes Inhaltsfragmentmodell

      note note
      NOTE
      Oben kann noch eine Warnung angezeigt werden. In diesem Fall wird das Modell jedoch bereits von vorhandenen Inhaltsfragmenten verwendet.

    • Mit Abbrechen kehren Sie zur Konsole zurück.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab