Das Entitäts-Feld ermöglicht die Verknüpfung eines bestehenden Eintrags mit einem einzelnen Eintrag einer anderen Entität. Beispielsweise kann ein Blogbeitrag mit einem Autor verknüpft werden. Die gewünschten Felder des verknüpften Eintrags können über das Mapping konfiguriert werden, um nur die benötigten Informationen abzurufen.
Für die Verknüpfung mit mehreren Einträgen kann das Entitäten (Mehrere Einträge) Feld verwendet werden.
Datensammlungen
Das Feld funktioniert in beiden Richtungen mit einer Datensammlung:
- In einer Datensammlung verweist es auf einen Inhalt, zum Beispiel ein Kommentar auf den Blogbeitrag, zu dem er gehört.
- In einer Inhalts-Entität kann es einen Eintrag einer Datensammlung auswählen.
Einträge einer Datensammlung werden sofort und endgültig gelöscht. Die Verknüpfung wird dann wie unten beschrieben entfernt.
Gelöschte Einträge
Wird der verknüpfte Eintrag endgültig gelöscht, entfernt Flyo die Verknüpfung automatisch aus allen Einträgen, die auf ihn verweisen. Das Feld ist danach leer, und in den Aktivitäten des Eintrags steht, welcher verknüpfte Eintrag gelöscht wurde. Ist das Feld ein Pflichtfeld, muss beim nächsten Speichern ein neuer Eintrag gewählt werden.
Ein Eintrag im Papierkorb wird nicht ausgegeben, seine Verknüpfungen bleiben aber bestehen. Wird er wiederhergestellt, ist er überall wieder verknüpft.
Mehrsprachigkeit
Das Feld kann nicht mehrsprachig sein. Eine Verknüpfung gilt für alle Sprachen.
Ausgabe
Die Ausgabe unterscheidet sich je nach Kontext. Zusätzlich zum Hauptfeld werden gemappte Felder des verknüpften Eintrags als separate Felder zurückgegeben.
API
Gibt die ID des verknüpften Eintrags als String zurück. Gemappte Felder werden als zusätzliche, flache Felder ausgegeben:
"autor": "10430",
"autor_name": "Max Muster",
"autor_bild": "https://storage.flyo.cloud/portrait_3b53038e.jpg",
"autor_slug": "max-muster"SDK / Nitro CMS
Gibt für das Hauptfeld ein Objekt mit id und unique_id zurück. Gemappte Felder werden als separate Felder mit ihrer jeweiligen SDK-Formatierung ausgegeben:
"autor": {
"id": 10430,
"unique_id": "oJtovbgy"
},
"autor_name": "Max Muster",
"autor_bild": {
"source": "https://storage.flyo.cloud/portrait_3b53038e.jpg",
"caption": "Portrait",
"copyright": "Fotograf",
"name": "portrait.jpg",
"id": 149950,
"mime_type": "image/jpeg"
},
"autor_slug": "max-muster"Im Nitro CMS Kontext werden zusätzlich routes mitgeliefert, die die Detail-Routen für den verknüpften Eintrag enthalten.
Leerer Wert
"autor": false
