Custom Fields
Mit Custom Fields ergänzt Du Events, Kontakte und Adressen um zusätzliche Datenpunkte. Einmal definiert, sind sie im Formular-Builder, auf der Event-Detailseite, in Workflows und in Vorlagen sowie Integrationen verfügbar -- überall, wo Du sie brauchst.
So öffnest Du die Custom Fields
- Gehe zu Einstellungen in der Navigation.
- Klicke auf Custom Fields.
Nur Owner und Admins können Custom Fields verwalten.
Bereiche
Custom Fields leben in einem von drei Bereichen:
- Event -- allgemeine Event-Daten (z. B. Budget-Codes, Kampagnen-IDs).
- Kontakt -- zusätzliche Kontaktdaten (z. B. Loyalty-Stufe, Lieferanten-Referenz).
- Adresse -- zusätzliche Adressangaben (z. B. Stockwerk, Zugangscode).
Wechsle zwischen den Bereichen über die Tabs oben auf der Seite.
Ein Custom Field erstellen
- Wähle den Tab des gewünschten Bereichs.
- Klicke auf Feld hinzufügen.
- Fülle die Grunddaten aus:
- Bereich -- wo der Wert in einem Event gespeichert wird.
- Schlüssel -- eine kurze snake_case Kennung (Kleinbuchstaben, Ziffern und Unterstriche). Der Schlüssel wird gesperrt, sobald das Feld verwendet wird.
- Bezeichnung -- der Name, den Deine Nutzer in Auswahllisten und auf der Event-Detailseite sehen.
- Beschreibung -- optionaler Hilfetext für den Formular-Builder und die Einstellungen.
- Wähle einen Datentyp. Der passende Formular-Feldtyp wird automatisch gesetzt. Unterstützt werden unter anderem Text, Zahl, Datum, Zeit, Ja/Nein, Einzelauswahl, Mehrfachauswahl, E-Mail, Telefon und URL.
- Für Einzelauswahl oder Mehrfachauswahl legst Du mindestens eine Option an. Jede Option hat einen eindeutigen Wert und eine Bezeichnung.
- Wähle über die Schalter Wo das Feld erscheint, wo das Feld genutzt werden darf. Siehe Oberflächen.
- Klicke auf Speichern.
Der daraus gebildete Mapping-Schlüssel (z. B. event.budget_code) wird direkt unter dem Schlüsselfeld angezeigt. Verwende den Mapping-Schlüssel, wenn Du das Feld in Workflows, Vorlagen und Integrationen referenzierst.
Oberflächen
Jedes Custom Field kann in mehreren Oberflächen erscheinen. Manche Oberflächen setzen andere voraus -- Im Event speichern ist die Hauptschleuse für alles darunter.
| Oberfläche | Was sie bewirkt | Setzt voraus |
|---|---|---|
| Im Formular-Builder verfügbar | Feld erscheint im Formular-Builder zur Auswahl. | -- |
| Im Event speichern | Speichert den Wert im Event, damit andere Oberflächen ihn lesen können. | -- |
| Auf Event-Detailseite sichtbar | Zeigt den Wert auf der Event-Detailseite. | Im Event speichern |
| Auf Event-Detailseite bearbeitbar | Erlaubt Bearbeitung auf der Event-Detailseite. | Auf Event-Detailseite sichtbar |
| In Workflow-Bedingungen nutzbar | Workflows dürfen das Feld in Bedingungen auswerten. | Im Event speichern |
| In Workflow-Triggern nutzbar | Workflows dürfen auf Änderungen am Feld reagieren. | Im Event speichern |
| Von Workflow-Aktionen beschreibbar | Workflow-Aktionen dürfen das Feld aktualisieren. | Im Event speichern |
| Als Vorlagen-Variable verfügbar | Nutzung in E-Mail- und Textvorlagen. | Im Event speichern |
| In öffentlicher API zeigen | Feld wird in den API-Antworten ausgeliefert. | Im Event speichern |
| In Webhooks zeigen | Feld wird in ausgehenden Webhook-Payloads mitgesendet. | Im Event speichern |
Wenn Du einen übergeordneten Schalter ausschaltest, werden abhängige Schalter automatisch zurückgesetzt.
Ein Custom Field bearbeiten
- Öffne den Tab des Bereichs, in dem das Feld liegt.
- Klicke beim Feld auf das Drei-Punkte-Menü.
- Klicke auf Feld bearbeiten.
Bereich und Schlüssel werden gesperrt, sobald das Feld in einem Formular, einer Antwort, einem Workflow oder einem Event verwendet wird. Bezeichnung, Beschreibung, Optionen, Sortierung und Schalter kannst Du jederzeit ändern.
Ein Custom Field archivieren
- Öffne beim Feld das Drei-Punkte-Menü.
- Klicke auf Feld archivieren und bestätige.
Das Archivieren blendet das Feld aus Auswahllisten und neuen Formularen aus, erhält aber alle bestehenden Werte und Referenzen. Mit dem Schalter Archivierte anzeigen blendest Du archivierte Felder in der Liste ein.
Custom Fields in Formularen verwenden
Erstelle oder bearbeite ein Formular, dessen Typ Events zulässt (Event-Formulare oder Detailformulare mit aktivierten Event-Updates). Im Formular-Builder erscheinen Deine Custom Fields direkt unter dem passenden Bereich-Tab (Event, Kontakt oder Adresse) als zusätzlicher Abschnitt Custom Fields. Beim Hinzufügen legst Du ein Feld an, das mit Deinem Custom Field verknüpft ist und den Wert beim Absenden auf das Event zurückschreibt.
Custom Fields auf der Event-Detailseite
Custom Fields tauchen auf der Event-Detailseite genau dort auf, wo sie inhaltlich hingehören:
- Event-Felder erscheinen im Abschnitt Event Details auf der Hauptseite des Events.
- Kontakt-Felder erscheinen unten im Kontakt-Block.
- Adresse-Felder erscheinen unten im Adresse-Block.
Der Abschnitt Event Details wird nur dann angezeigt, wenn mindestens ein aktives Event-Custom-Field für die Event-Detailseite freigeschaltet ist. Felder, die Du als nicht bearbeitbar markiert hast, werden nur lesend angezeigt.
Custom Fields in Workflows verwenden
- Bedingungen -- wähle das Feld in der Bedingungskonfiguration, um Werte zu vergleichen.
- Trigger -- wähle das Feld im Trigger "Event-Feld geändert", um auf Änderungen zu reagieren.
- Aktionen -- wähle das Feld in der Aktion "Event-Feld aktualisieren", damit der Workflow einen neuen Wert setzt.
Es erscheinen nur Felder, für die Du die jeweilige Oberfläche aktiviert hast.
Grenzen
- Bis zu 100 aktive Custom Fields pro Workspace.
- Schlüssel bestehen aus Kleinbuchstaben, Ziffern und Unterstrichen (zwischen 2 und 64 Zeichen) und dürfen nicht mit reservierten Eventyflow-Feldern kollidieren. Das Formular meldet reservierte Schlüssel beim Speichern.
- Einzel- und Mehrfachauswahl-Felder benötigen mindestens eine Option mit eindeutigem Wert.