Inhaltsfragmentmodelle

CAUTION

Die AEM GraphQL API für Content Fragment Versand wird Anfang 2021 veröffentlicht.

Die entsprechende Dokumentation steht bereits zur Vorschau zur Verfügung.

Inhaltsfragmentmodelle definieren die Struktur des Inhalts für Ihre Inhaltsfragmente.

So verwenden Sie Inhaltsfragmentmodelle:

  1. Funktionalität des Inhaltsfragmentmodells für Ihre Instanz aktivieren
  2. Erstellen und konfigurieren Sie Ihre Inhaltsfragmentmodelle
  3. Inhaltsfragmentmodelle zur Verwendung beim Erstellen von Inhaltsfragmenten zur Verwendung beim Erstellen von Inhaltsfragmenten aktivieren

Erstellen eines Inhaltsfragmentmodells

  1. Navigieren Sie zu Tools > Assets und öffnen Sie dann Inhaltsfragmentmodelle.

  2. Navigieren Sie zu dem entsprechenden Ordner für Ihre Konfiguration.

  3. Öffnen Sie den Assistenten über Erstellen.

    CAUTION

    Wenn die Verwendung von Inhaltsfragmentmodellen nicht aktiviert wurde, ist die Option Erstellen nicht verfügbar.

  4. Geben Sie den Modelltitel an. Sie können bei Bedarf auch Tags und eine Beschreibung hinzufügen.

    Titel und Beschreibung

  5. Speichern Sie das leere Modell über Erstellen. Eine Benachrichtigung zeigt an, dass der Vorgang erfolgreich abgeschlossen wurde. Daraufhin können Sie das Modell über die Option Öffnen direkt bearbeiten oder über Fertig zur Konsole zurückkehren.

Definieren des Inhaltsfragmentmodells

Das Inhaltsfragmentmodell definiert die Struktur der resultierenden Inhaltsfragmente effektiv mithilfe einer Auswahl von Datentypen. Mithilfe des Modelleditors können Sie Instanzen der Datentypen hinzufügen und diese dann so konfigurieren, dass die erforderlichen Felder erstellt werden:

CAUTION

Die Bearbeitung eines vorhandenen Inhaltsfragmentmodells kann sich auf abhängige Fragmente auswirken.

  1. Navigieren Sie zu Tools > Assets und öffnen Sie dann Inhaltsfragmentmodelle.

  2. Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.

  3. Öffnen Sie das zu bearbeitende Modell; nutzen Sie dazu entweder die entsprechende Schnellaktion oder wählen Sie das Modell und anschließend die Aktion aus der Anwendungssymbolleiste aus.

    Wenn das Modell geöffnet ist, finden Sie Folgendes im Editor:

    • Links: bereits definierte Felder
    • Rechts: verfügbare Datentypen für das Erstellen von Feldern (und Eigenschaften, die für erstellte Felder verwendet werden können)
    NOTE

    Wenn ein Feld ein Pflichtfeld ist, wird die Bezeichnung im linken Bereich mit einem Stern markiert (*).

  4. So fügen Sie ein Feld hinzu

    • Ziehen Sie einen erforderlichen Datentyp an die entsprechende Stelle für ein Feld.

    • Wenn ein Feld zum Modell hinzugefügt wurde, werden im rechten Fenster die Eigenschaften angezeigt, die für diesen speziellen Datentyp definiert werden können. Hier können Sie festlegen, was für dieses Feld erforderlich ist.
      Viele Eigenschaften sind selbsterklärend. Weitere Informationen finden Sie unter Eigenschaften.

  5. So entfernen Sie ein Feld

    Wählen Sie das entsprechende Feld aus und klicken/tippen Sie auf das Papierkorb-Symbol. Sie werden aufgefordert, den Vorgang zu bestätigen.

  6. hinzufügen Sie alle erforderlichen Felder und definieren Sie die entsprechenden Eigenschaften nach Bedarf.

  7. Wählen Sie Speichern, um die Definition beizubehalten.

Datentypen

Eine Auswahl an Datentypen steht zur Definition Ihres Modells zur Verfügung:

  • Einzeilentext
    • hinzufügen eines oder mehrere Felder einer einzelnen Textzeile; die maximale Länge kann definiert werden
  • Mehrzeilentext
    • Ein Textbereich, bei dem es sich um Rich Text, Nur-Text oder Markierungen handeln kann
  • Zahl
    • hinzufügen eines oder mehrere numerische Felder
  • Boolesch
    • hinzufügen eines booleschen Kontrollkästchens
  • Datum und Uhrzeit
    • Datum und/oder Uhrzeit Hinzufügen
  • Aufzählung
    • hinzufügen einer Reihe von Kontrollkästchen, Optionsfeldern oder Dropdown-Feldern
  • Tags
    • Ermöglicht Fragmentautoren den Zugriff auf und die Auswahl von Bereichen von Tags
  • Inhaltsreferenz

Eigenschaften

Viele Eigenschaften sind selbsterklärend. Für bestimmte Eigenschaften sind folgende weitere Details verfügbar:

  • Rendern
    alsDie verschiedenen Optionen zum Realisieren/Rendern des Felds in einem Fragment. Auf diese Weise können Sie häufig festlegen, ob dem Autor eine einzelne Instanz des Felds angezeigt wird oder ob mehrere Instanzen erstellt werden dürfen.

  • Feldbeschriftung
    Eingeben eines
    Feldbezeichnungen generieren automatisch einen Eigenschaftsnamen, der bei Bedarf manuell aktualisiert werden kann.

  • Die
    ValidationBasic-Validierung steht für Mechanismen wie die ​Requiredproperty zur Verfügung. Einige Datentypen verfügen über zusätzliche Überprüfungsfelder. Weitere Informationen finden Sie unter Validierung.

  • Beim Datentyp Mehrzeilentext können Sie den Standardtyp folgendermaßen definieren:

    • Rich-Text
    • Markdown
    • Nur Text

    Wenn Sie keinen Typ angeben, wird der Standardwert Rich-Text in diesem Feld verwendet.

    Änderungen am Standardtyp in einem Fragmentmodell werden erst dann auf vorhandene, zugehörige Inhaltsfragmente angewendet, wenn das Fragment im Editor geöffnet und gespeichert wurde.

Validierung

Verschiedene Datentypen bieten jetzt die Möglichkeit, Prüfanforderungen für den Zeitpunkt zu definieren, an dem Inhalt in das resultierende Fragment eingegeben wird:

  • Einzeilentext
    • Vergleichen Sie mit einem vordefinierten Regex.
  • Zahl
    • Suchen Sie nach bestimmten Werten.

Aktivieren oder Deaktivieren eines Inhaltsfragmentmodells

Zur vollständigen Kontrolle über die Verwendung Ihrer Inhaltsfragmentmodelle haben sie einen Status, den Sie festlegen können.

Aktivieren eines Inhaltsfragmentmodells

Nachdem ein Modell erstellt wurde, muss es aktiviert werden, damit es:

  • Ist zur Auswahl verfügbar, wenn ein neues Inhaltsfragment erstellt wird.
  • Kann in einem Inhaltsfragmentmodell referenziert werden.
  • ist für GraphQL verfügbar; damit das Schema generiert wird.

So aktivieren Sie ein Modell, das entweder als

  • Entwurf : mew (nie aktiviert).
  • Deaktiviert : speziell deaktiviert wurde.

Sie verwenden die Option Aktivieren aus einem der folgenden Schritte:

  • Die obere Symbolleiste, wenn das gewünschte Modell ausgewählt ist.
  • Die entsprechende Schnellaktion (Bewegen Sie den Mauszeiger über das gewünschte Modell).

Entwurf oder deaktiviertes Modell aktivieren

Deaktivieren eines Inhaltsfragmentmodells

Ein Modell kann auch deaktiviert werden, sodass:

  • Das Modell ist nicht mehr als Grundlage für die Erstellung von Inhaltsfragmenten verfügbar.**
  • However:
    • 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 unberührt 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 entweder:

  • Die obere Symbolleiste, wenn das gewünschte Modell ausgewählt ist.
  • Die entsprechende Schnellaktion (Bewegen Sie den Mauszeiger über das gewünschte Modell).

Ein aktiviertes Modell deaktivieren

Löschen eines Inhaltsfragmentmodells

CAUTION

Das Löschen eines Inhaltsfragmentmodells wirkt sich unter Umständen auf abhängige Fragmente aus.

So löschen Sie ein Inhaltsfragmentmodell:

  1. Navigieren Sie zu Tools > Assets und öffnen Sie dann Inhaltsfragmentmodelle.

  2. Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.

  3. Wählen Sie Ihr Modell und anschließend die Option Löschen aus der Anwendungssymbolleiste aus.

    NOTE

    Wenn es Verweise auf das Modell gibt, wird Ihnen ein Warnhinweis angezeigt. Ergreifen Sie die entsprechenden Maßnahmen.

Veröffentlichen eines Inhaltsfragmentmodells

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 Tools > Assets und öffnen Sie dann Inhaltsfragmentmodelle.

  2. Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.

  3. Wählen Sie Ihr Modell und anschließen die Option Löschen aus der Anwendungssymbolleiste aus.
    Der veröffentlichte Status wird in der Konsole angezeigt.

    NOTE

    Wenn Sie Inhaltsfragmente veröffentlichen, deren Modell noch nicht veröffentlicht wurde, wird dies in der Auswahlliste angezeigt und das Modell wird mit dem Fragment veröffentlicht.

Rückgängigmachen der Veröffentlichung eines Inhaltsfragmentmodells

Die Veröffentlichung von Inhaltsfragmentmodellen kann rückgängig gemacht werden, wenn sie nicht von Fragmenten referenziert werden.

So machen Sie die Veröffentlichung eines Inhaltsfragmentmodells rückgängig:

  1. Navigieren Sie zu Tools > Assets und öffnen Sie dann Inhaltsfragmentmodelle.

  2. Navigieren Sie zu dem Ordner, der Ihr Inhaltsfragmentmodell enthält.

  3. Wählen Sie Ihr Modell aus, gefolgt von Veröffentlichung rückgängig machen aus der Symbolleiste.
    Der veröffentlichte Status wird in der Konsole angezeigt.

Auf dieser Seite