Grundlagen der Content-Modellierung

Wenn Sie sich zum ersten Mal bei Contentful anmelden und Ihren ersten Space erstellen, werden Sie aufgefordert, Ihr Content-Modell einzurichten. Vielleicht denken Sie: „Mein Content – wirklich?“ Wenn Sie neu bei Contentful sind, sind Sie vielleicht noch nicht mit der Welt der Content-Modellierung vertraut.

Ein solides Content-Modell ist die Grundlage jedes großen digitalen Projekts. Ihr Modell ist das Rückgrat Ihres Projekts. Es teilt unseren APIs mit, welche Art von Content an Ihre Endanwendung gesendet werden soll.

In diesem Leitfaden werden wir die Prinzipien der Content-Modellierung und die Einrichtung Ihres Modells mit Contentful erläutern. Am Ende sind Sie bereit für Ihre Contentful-Reise!

Kurz gesagt, ein Content-Modell gibt Ihrem Inhalt Struktur und Organisation. Innerhalb Ihres gesamten Content-Modells haben Sie individuelle Contenttypen. Sie können sich jeden Contenttyp als Gliederung für Ihren Content vorstellen. Er sagt Ihnen, welche Daten in jedem einzelnen Eintrag enthalten sein werden. Sie können sich den Contenttyp auch als „Schablone“ für die „Zeichnung“ vorstellen, die Ihr Eintrag sein wird.

Jeder Contenttyp besteht aus Feldern, die die Art der Daten bezeichnen, die in den Eintrag aufgenommen werden. Beispielsweise hätte der Titel einer Webseite oder eines Nachrichtenartikels ein eigenes Textfeld, der Textkörper ein anderes, und es gäbe auch Felder, um beliebige Mediendateien einzuschließen. Auf diese Weise verwandeln Sie Ihre Website oder App – wie unsere Freundin Karen McGrane es ausdrückt – von einem großen „Klecks“ von Inhalten in modulare „Brocken“ oder strukturierten Content.

Die Gestaltung Ihres Content-Modells ist ein entscheidender Schritt beim Aufbau einer soliden, effizienten und zukunftssicheren Anwendung mit Contentful. Ziel ist es, ein Modell zu erstellen, das die Bedürfnisse Ihres gesamten Teams unterstützt, von den Content-Ersteller*innen über die Designer bis hin zu den Entwickler*innen. Aus diesem Grund empfehlen wir immer, eine Sitzung mit jedem Team abzuhalten, um herauszufinden, was sie von unserer Composable-Content-Plattform erwarten, und Ihren Content entsprechend zu strukturieren.

Bevor Sie mit der Erstellung Ihres Contentful-Content-Modells beginnen, sollten Sie tief durchatmen und sich bereit für etwas Neues machen. Vergessen Sie, was Sie über traditionelle Content-Management-Systeme wissen, die Ihre Modellierung auf vordefinierte Contenttypen beschränken. Lassen Sie die Idee, Inhalte in Form von einzelnen Textzeichenfolgen zu betrachten, beiseite. Die Content-Modellierung in Contentful funktioniert ein bisschen anders – wir würden sagen, besser.

Mit Contentful müssen Ihre Inhalte nicht in unser Modell passen – stattdessen passen Sie das Modell an Ihren Content an. Sie können ein völlig einzigartiges Content-Modell definieren, entweder über unsere Web-App oder unsere Content Management API, die Sie an Ihr Projekt anpassen. Versuchen Sie, die Content-Modellierung aus der Perspektive der Anforderungen Ihres Projekts in Bezug auf Design und Funktion zu betrachten. Wenn Ihr Blog Metadaten zu den Beiträgen anzeigen muss, achten Sie darauf, dass Sie Felder dafür hinzufügen. Wenn dieser Beitrag eine „Behind the Scenes“-Funktion benötigt, z. B. die Option, hervorgehoben zu werden, müssen Sie ein Feld hinzufügen, um dies zu steuern. Bleiben Sie flexibel und lassen Sie Contentful für sich arbeiten!

Die Modellierung in Contentful unterscheidet sich auch von der traditionellen Datenbankarchitektur. Wenn Sie jemals Content-Modelle mit einer Tabelle wie Excel oder Google Sheets eingerichtet haben, haben Sie wahrscheinlich vom untergeordneten Element zum übergeordneten Element modelliert. Bei Contentful nutzen wir gerne natürliche Annahmen und modellieren unsere Inhalte von übergeordnet zu untergeordnet. So können Sie alle Anforderungen an die Anzeige frühzeitig in Ihrem Modellierungsprozess berücksichtigen.

Beginnen Sie mit den grundsätzlichen Fragen: Was muss die Endanwendung tun und welche Informationen müssen unseren Nutzer*innen angezeigt werden?

Mit diesen beiden Fragen im Hinterkopf können Sie darüber nachdenken, wie Sie Ihr Content-Modell tatsächlich strukturieren. Wie bereits erwähnt, besteht Ihr Gesamtmodell aus einzelnen Contenttypen. Jeder Contenttyp stellt eine einzelne Einheit oder ein einzelnes Modul von Content in Ihrer Endanwendung dar. Aber wo endet ein Contenttyp und wo beginnt ein anderer?

Die Antwort auf diese Frage hängt davon ab, wie strukturiert oder flexibel Ihr Content-Modell sein muss. Werden Ihre Content-Strateg*innen immer die gleichen Arten von Daten eingeben? Oder ändert sich das je nach bestimmten Kriterien? Für vorhersehbare Content-Elemente, wie ein Adressbuch, können Sie wahrscheinlich nur einen Contenttyp verwenden, um alle Informationen zu speichern. Ein Adressbucheintrag benötigt immer einen Namen, eine E-Mail-Adresse, eine Telefonnummer usw.

Die Portfolio-Website eines Designers/einer Designerin benötigt jedoch möglicherweise ein flexibleres Modell, das verschiedene Arten von Content aufnehmen kann. Einer Ihrer Beiträge könnte ein Bild sein, aber der nächste ist vielleicht ein Video, und jeder Medientyp erfordert unterschiedliche Metadaten. In diesem Fall sollten Sie zwei separate Contenttypen erstellen – einen für Bilder und einen für Videos – und sie nach Bedarf mit Ihrem Beitrag verknüpfen.

Es ist auch gut, wiederverwendbare Content-Elemente zu identifizieren. Ein klassisches Beispiel ist die Biografie eines Autors/einer Autorin. Anstatt den Autorennamen und den Biografie-Text in jeden Artikel einzugeben, können Sie einen wiederverwendbaren Contentteil mit den Autoreninformationen erstellen, der immer wieder verwendet werden kann. Die Wiederverwendung von Content kann Ihren Workflow zur Contenterstellung erheblich vereinfachen.

Sobald Sie eine Vorstellung davon haben, was Ihr Content-Modell erreichen muss, ist es an der Zeit, es in Contentful zu erstellen! Für die Zwecke dieses Leitfadens werden wir über die Modellierung in unserer Web-App sprechen. Es gibt verschiedene Möglichkeiten, wie Sie dies tun können: entweder visuell und kollaborativ mit unserem Visual Modeler oder über die Benutzeroberfläche des Contenttyp-Editors auf der Registerkarte „Content-Modell“.

Natürlich können Sie Ihr Content-Modell auch programmgesteuert einrichten – mit der Content Management API.

Wenn Sie ganz neu bei Contentful sind, ist es eine gute Idee, einen kurzen Blick in unsere 5-Minuten-Anleitung für den Einstieg zu werfen, damit Sie mit der Sprache unserer Plattform vertraut sind.

Bei der Arbeit an einem Content-Modell arbeiten Teams zusammen, um sicherzugehen, dass es für alle funktioniert und seinen Zweck erfüllt. Entwickler*innen entwerfen das Content-Modell, während Editor*innen die Endnutzer*innen sind. Es ist wichtig, dass das Content-Modell für alle geeignet ist – es muss sowohl den Anforderungen der Editor*innen als auch der Einrichtung der Frontend-Anwendung entsprechen.

Um ein Content-Modell zu erstellen, das wirklich robust und skalierbar ist, würde ein Team Wiederholungen durchführen – Entwickler*innen planen und bauen, während ihre nicht-technischen Kolleg*innen testen und Feedback geben. Mit unserem Visual Modeler können Sie Feedback zu Ihrem Content-Modell entwerfen, visualisieren, teilen und sammeln – alles im Kontext der Contentful-Web-App.

Sobald Sie sich in der Web-App befinden, erstellen Sie zunächst die Spaces für Ihr Content-Modell. Jeder Space stellt eine separate Datenbank mit Content dar und enthält eindeutige Contenttypen, Einträge und Assets sowie eindeutige Nutzermitgliedschaften und API-Schlüssel. Im Allgemeinen empfehlen wir Ihnen, Ihren gesamten Content in einem Space zu speichern, obwohl es einige Situationen gibt, in denen die Verwendung mehrerer Spaces sinnvoll ist. Hier sind einige Richtlinien für die Arbeit mit Spaces:

Wann mehrere Spaces verwendet werden sollten:

• Für die Arbeit mit separaten Projekten, z. B. Kundenarbeit oder Multi-Stakeholder-Projekte.

• Um einen „Spielplatz“ zum Testen zu erstellen, z. B. um Funktionen und Einstellungen mit Mock-Content auszuprobieren, wenn Sie Contentful zum ersten Mal erkunden.

Wann NICHT mehrere Spaces verwendet werden sollten:

• Für das Workflow-Management, z. B. um die Veröffentlichungsberechtigungen einzuschränken.

• Um mehrere Staging-Umgebungen zu erstellen (die Content Preview API sollte zum Testen von Entwurfsinhalten verwendet werden).

Contentful verwendet Referenzfelder, um Beziehungen zwischen Contenttypen zu erstellen. Ein grundlegendes Beispiel für die Verwendung eines Referenzfelds ist die Verknüpfung eines Beitrags mit seinem/seiner Autor*in. Sie beginnen mit zwei Contenttypen: einen für den Beitrag und einen für den/die Autor*in. Innerhalb des Beitrags fügen Sie die erforderlichen Felder hinzu: einen Titel, einen Platz für den Text des Beitrags und alle anderen Metadaten. Der Contenttyp „Autor*in“ kann Felder für den Namen des Autors/der Autorin, eine kurze Biografie und ein Foto enthalten. Sobald Sie beide Contenttypen eingerichtet haben, müssen Sie nur noch den Beitrags-Contenttyp erneut öffnen und ein neues Referenzfeld hinzufügen. Geben Sie ihm einen beschreibenden Namen wie „Autoreninfo“ und Sie sind fertig! Jetzt enthalten die Beitragseinträge immer ein Feld, um den/die Autor*in zu verlinken.

Contenttyp „Beitrag“ (links) und ein Eintrag dieses Typs im Editor (rechts).

Dies ist ein sehr einfaches Beispiel für die Erstellung einer hierarchischen Beziehung, aber Referenzfelder können auch für weitaus komplexere Modellierungen verwendet werden. In unserem Blogbeitrag über die Erstellung eines digitalen Lookbooks haben wir gezeigt, wie Sie mehrere Contenttypen und Referenzfelder verwenden können, um Container zu erstellen, die Ihr Modell flexibel und modular halten. Unser Blogbeitrag über den Aufbau flexibler Content-Modelle beschreibt hingegen einen Kunden, der Referenzfelder und „Container“-Contenttypen verwendet, um ein anpassbares Content-Modell für die Erstellung von Zielseiten zu erstellen.

Ein Beispiel für die kreative Verwendung von Referenzfeldern ist eine geordnete Liste verknüpfter Inhalte. Indem Sie zuerst einen Contenttyp erstellen, der als Container fungiert, können Sie ein Feld für verknüpfte Elemente hinzufügen, das als Drag-and-Drop-Liste im Eintragseditor fungiert. Dies funktioniert sowohl für Referenzfelder als auch für Medienfelder. Neben der Bequemlichkeit einer leicht sortierbaren Liste können Sie so auch alle referenzierten Inhalte in einem API-Aufruf abrufen.

Referenzfeld mit der Bezeichnung „Einträge“, um eine sortierbare Liste zu erstellen.

Denken Sie immer daran, dass Contentful flexibel ist. Ihnen stehen viele Möglichkeiten offen, die von Ihrer Content-Strategie, Ihrem Content-Ökosystem und Ihren einzigartigen Content-Anforderungen bestimmt werden. Wenn Sie nicht sofort erkennen, wie Sie etwas modellieren können, geben Sie nicht auf! Senden Sie uns eine Nachricht und wir helfen Ihnen gerne, es herauszufinden.

Jeder Feldtyp verfügt über eine Vielzahl von Einstellungen, die Sie konfigurieren können, einschließlich Anzeige- und Validierungsoptionen. Alle Einstellungen können später geändert werden, mit Ausnahme des Feldtyps und der ID.

Die Registerkarte „Validierungen“

Auf der Registerkarte „Validierungen“ können Sie in den Einstellungen Ihres Feldes Spezifikationen und Anforderungen festlegen. Müssen Sie sicherstellen, dass der Titel Ihres Blogbeitrags immer zu 100 % ausgefüllt ist? Markieren Sie einfach das Feld als erforderlich und Sie müssen nicht mehr darüber nachdenken.

Je nach Feldtyp können Sie weitere Validierungen festlegen, z. B. die Angabe einer erforderlichen Anzahl von Zeichen oder die Festlegung vordefinierter Werte. Eine der nützlichen Validierungen für Referenzfelder ermöglicht es Ihnen, den Contenttyp der Einträge anzugeben, auf die verwiesen werden kann. Das gleiche gilt für das Medienfeld – Sie möchten nicht versehentlich ein Video dort platzieren, wo ein Bild sein sollte!

Wir empfehlen Ihnen, mit dem Hinzufügen von Validierungen zu warten, bis Sie alle Ihre Contenttypen eingerichtet haben.

Die Registerkarte „Anzeige“

Navigieren Sie zur Registerkarte „Anzeige“, um Contentful mitzuteilen, wie das Feld im Eintragseditor aussehen soll. Die von Ihnen gewählte Anzeigeoption wirkt sich nicht auf die Art und Weise aus, wie der Content in Ihrer Endanwendung angezeigt wird. Sie ändert lediglich die Art und Weise, wie er in unserer Web-App angezeigt wird.

Verwenden Sie die Anzeigeoptionen, um das Leben Ihrer Content-Ersteller*innen zu erleichtern. Anstatt sie in ein leeres Textfeld ausfüllen zu lassen, in der Hoffnung, dass es mit einem der vordefinierten Werte übereinstimmt, geben Sie ihnen eine Dropdown-Liste, damit sie eine Vorlage zur Auswahl haben. Sie können auch Kontrollkästchen erstellen, damit sie mehrere Werte auswählen können.

Kurze Textfelder.

Es ist auch eine gute Idee, einen benutzerdefinierten Hilfetext unter dem Feld anzuzeigen, um Ihren Content-Ersteller*innen den Weg zu erfolgreichem Content-Marketing aufzuzeigen.

Es ist höchst unwahrscheinlich, dass Sie Ihr Content-Modell einmal einrichten und es nie wieder ändern. Glücklicherweise lässt Contentful Ihr Content-Modell mit Ihrem Projekt wachsen. Wenn es an der Zeit ist, Ihr Modell zu optimieren, können Sie Felder nach Bedarf bearbeiten, deaktivieren oder löschen.

Contenttypen duplizieren und löschen

Wenn Sie einige Änderungen an einem Contenttyp vornehmen müssen, aber Ihr aktuelles Modell nicht durcheinanderbringen möchten, erstellen Sie einfach eine Kopie! Öffnen Sie Ihren Contenttyp in unserer Web-App und wählen Sie im Aktionsmenü „Duplizieren“.

Aktionsmenü im Contenttyp-Builder.

Sobald Sie bereit sind, die alte Version Ihres Contenttyps zu löschen, müssen Sie einige Schritte befolgen. Zuerst müssen Sie alle Einträge mit dem Contenttyp löschen. Dadurch wird sichergestellt, dass Sie den Contenttyp nicht versehentlich löschen und der Inhalt in Ihrer Endanwendung nicht beeinträchtigt wird. Woher würde Ihre Anwendung ohne die Contenttyp-Informationen wissen, wie der Eintrag aufgebaut ist? Eben, das Ende wäre eher ungewiss.

Nachdem Sie alle Einträge dieses Contenttyps (einschließlich archivierter Elemente) entfernt haben, können Sie den Contenttyp vollständig löschen.

Es ist einfach, kleine Anpassungen an Ihrem Content-Modell vorzunehmen, z. B. das Hinzufügen und Entfernen von Feldern. Wenn Sie Felder zu einem vorhandenen Contenttyp hinzufügen, wird das neue Feld automatisch zu vorhandenen Einträgen hinzugefügt. Wenn das neue Feld erforderlich ist, werden vorhandene Einträge erst dann validiert, wenn der Eintrag aktualisiert wurde. Dies bedeutet, dass ältere Einträge dieses Contenttyps trotz des leeren Pflichtfelds veröffentlicht bleiben, bis Sie Änderungen an diesem Eintrag vornehmen. An diesem Punkt müssen Sie das erforderliche Feld ausfüllen, bevor Sie es erneut veröffentlichen.

Felder beim Bearbeiten ausblenden

Wenn Sie ein Feld beim Bearbeiten ausblenden, bedeutet dies, dass ein Feld im Eintragseditor ausgeblendet wird, sein Inhalt jedoch in der API-Antwort vorhanden bleibt. Verwenden Sie diesen Status, um ein bestimmtes Feld für Editor*innen auszublenden.

HINWEIS: Ein/e Nutzer*in hat weiterhin die Möglichkeit, ein ausgeblendetes Feld anzuzeigen und seinen Content im Eintragseditor zu bearbeiten. Um eine/n Nutzer*in daran zu hindern, das ausgeblendete Feld zu bearbeiten, konfigurieren Sie die zugehörige Space-Rolle entsprechend – fügen Sie beispielsweise eine Verweigerungsregel hinzu, die verhindert, dass der/die Nutzer*in dieses Feld bearbeitet.

Aus API-Antwort auslassen

Das Auslassen von Feldern aus der API-Antwort bedeutet, dass der Inhalt nicht von der Content Delivery API und der Content Preview API abgerufen werden kann und daher für Ihre Endanwendung nicht verfügbar ist. Diese Felder können weiterhin im Eintragseditor bearbeitet werden. Ein Anwendungsfall wären Felder, die nur in der Contentful Web-App relevant sind, z. B. Felder, die den Status eines Eintrags in Ihrem Workflow angeben. Diese Informationen müssen in Ihrer Endanwendung nicht verfügbar sein. Warum also nicht die Dinge effizienter gestalten, indem Sie sie aus der Antwort herauslassen? Wir sind alle für Optimierung!

Felder löschen

Bevor Sie ein Feld löschen, müssen Sie es zunächst in der API-Antwort deaktivieren. Dieser zweistufige Prozess bietet Ihnen zusätzlichen Schutz vor versehentlich gelöschten Feldern, was für Ihre End-App katastrophal sein könnte! Wenn Sie das Feld in der Antwort zuerst deaktivieren, können Sie auch eine Vorschau anzeigen, wie Ihre API-Antworten nach dem Löschen des Felds aussehen werden. Achten Sie immer darauf, Ihre Antworten zu testen, bevor Sie Felder löschen!

Content-Modellierung ist ein breites und manchmal kompliziertes Thema. Machen Sie sich also keine Sorgen, wenn Sie sich immer noch ein bisschen verloren fühlen. Dieser Leitfaden hat nur an der Oberfläche gekratzt. Wenn Sie während Ihres Modellierungsprozesses nicht weiterkommen, zögern Sie nicht, uns zu kontaktieren. Sie können uns jederzeit eine Chat-Nachricht senden oder bei komplexeren Fragen eine Support-Anfrage senden.

Erfahren Sie mehr über die Content-Modellierung mit Contentful, indem Sie die Schulungskurse in unserem Learning Center besuchen:

• Einführung in die Content-Modellierung.

• Designprozess der Content-Modellierung.