formbasedocs
Zur AppApp

Formulare erstellen

Antwort-Piping

Tippe @, um die Antwort eines beliebigen Felds zu referenzieren — in Fragentiteln, Inhaltsblöcken, Dankesseiten, E-Mail-Benachrichtigungen und Integrationsnachrichten. Werte werden dynamisch aktualisiert, sodass jede Person personalisierte Inhalte sieht.


So funktioniert es

Tippe @ in jedem Text, der dies unterstützt (siehe unten). Ein Erwähnungsmenü erscheint und listet die Felder deines Formulars nach Typ auf: Versteckte Felder, Antworten, Wiederholungsgruppen, Berechnete Felder und Metadaten. Wähle ein Feld aus und formbase fügt an deiner Cursorposition einen Variablen-Chip ein.

Im Editor werden eingefügte Werte als Chip angezeigt (z. B. @Vorname). Wenn eine Person das Formular ausfüllt, ersetzt formbase jeden Chip durch die tatsächliche Antwort.

Um stattdessen ein einfaches @ einzugeben — etwa in einer E-Mail-Adresse oder einem Handle —, drücke Esc, um das Menü zu schließen, und tippe weiter. Das Menü schließt sich auch von selbst, wenn nichts zu dem passt, was du nach dem @ eingegeben hast.

Wo Piping funktioniert

  • Fragentitel — eine Frage bietet ihre eigene Antwort nie an, das wäre zirkulär
  • Inhaltsblöcke: Paragraphen, Überschriften, Listenelemente, Tabellenzellen, Links und Bildunterschriften
  • Inhalt der Dankesseite
  • Übersetzungen von allem oben Genannten, wobei die Erwähnung in jede Sprache übernommen wird
  • Betreff und Inhalt von E-Mail-Benachrichtigungen: eigene Benachrichtigungen, Bestätigungen an Teilnehmende und Erinnerungs-E-Mails bei abgebrochener Antwort, sowie die Request-Einladung

  • Integrationsvorlagen: Slack- und Discord-Nachrichten, GitHub- und Linear-Issue-Titel und -Beschreibungen, und Notion- und Airtable-Feldzuordnungen

Beschriftungen von Antwortoptionen sowie Zeilen- und Spaltenbeschriftungen von Matrizen unterstützen ebenfalls Erwähnungen, allerdings über ein engeres Menü: nur Versteckte Felder, Berechnete Felder und Metadaten — die Werte, die schon vorhanden sind, bevor jemand antwortet. Eine Optionsbeschriftung bestimmt, wie die Option in der Zusammenfassung, in Exporten und im Logik-Auswahlmenü erscheint, und kann deshalb nicht von einer anderen Antwort abhängen.

Schaltflächenbeschriftungen und Titel von Wiederholungsgruppen unterstützen keine Erwähnungen. Zwei verwandte Funktionen funktionieren anders: Weiterleitungs-Query-Parameter wählen für jeden Parameter ein Feld aus einer Dropdown-Liste aus, und Eingabe-Standardwerte setzen einen Wert in ein Feld statt in Text.

Ein bearbeitbares Feld vorausfüllen

Eine Erwähnung zeigt einen Wert als Text an, den die Person nicht ändern kann. Um einen Wert in ein Feld zu bringen, sodass die Person ihn bestätigen oder bearbeiten kann, verwende stattdessen eine Feldreferenz als Standardwert des Feldes: Tippe @ als erstes Zeichen in einem Text Input-, Text Area-, Email-, Phone Number-, Website URL- oder Number-Feld. Dieses Menü listet nur Versteckte Felder und Berechnete Felder auf, da diese schon einen Wert haben, bevor die Person mit dem Beantworten beginnt. Siehe Standardwerte aus anderen Feldern.

Das ist die Technik für einen Freigabelink, wo ein Wert nur über einen URL-Parameter ankommen kann und deshalb ein verstecktes Feld braucht, in das er landet. Bei einem Request brauchst du davon nichts: Der Aufrufer füllt beim Erstellen des Requests eine sichtbare Frage direkt vor, mit prefill, und kann einen Schlüssel als readonly markieren, sodass der Empfänger ihn sieht, aber nicht ändern kann. Baue ein verstecktes Feld, wenn du Daten mitführen willst, die die Person nie sehen soll, nicht nur, um eine Antwort vorauszufüllen. Siehe Requests brauchen kein verstecktes Feld zum Vorausfüllen.

Was du pipen kannst

Im Fließtext listet das @-Menü fünf Gruppen auf, in dieser Reihenfolge:

GruppeWas enthalten ist
Versteckte FelderWerte, die aus URL-Parametern oder dem Kontext eines Requests übernommen werden.
AntwortenJede Frage im Formular — Text, E-Mail, Zahl, Auswahl, Bewertungen usw.
WiederholungsgruppenAlle Einträge einer Wiederholungsgruppe auf einmal. Siehe Wiederholungsgruppen referenzieren weiter unten.
Berechnete FelderBerechnete Punktzahlen, Summen oder verketteter Text.
MetadatenLaufzeitwerte wie die Formular-ID, eine PIN oder ein Code pro Einreichung und die Sprache.

Ein Feld, auf das ein Chip zeigt, das aber nicht mehr existiert, zeigt den Tooltip „Das referenzierte Feld wurde gelöscht” und wird beim Ausfüllen leer dargestellt. Wenn du ein verstecktes oder berechnetes Feld löschst und ein neues mit demselben Namen hinzufügst, verbinden sich bestehende Chips von selbst wieder damit. Fragenreferenzen verbinden sich nie auf diese Weise neu — Titel ändern sich und überschneiden sich, daher bleiben sie defekt, bis du sie neu einfügst.

Metadaten-Variablen

Neben Feldantworten liefert die Gruppe Metadaten Laufzeitwerte. Manche sind überall verfügbar, andere nur in E-Mail-Vorlagen. Der folgende Name ist das, was der Chip anzeigt.

Verfügbar in Formularinhalten und E-Mail-Vorlagen

VariableWas angezeigt wird
Formular-IDEindeutige ID des Formulars.
4-stellige PIN / 6-stellige PINEine numerische PIN, eindeutig pro Einreichung.
4-stelliger Code / 6-stelliger CodeEin alphanumerischer Code, eindeutig pro Einreichung.

Nur in Formularinhalten

VariableWas angezeigt wird
Locale (Sprache)Sprachcode, in dem die Person das Formular liest.

Nur in E-Mail-Vorlagen

VariableWas angezeigt wird
FormularnameDer Name deines Formulars aus deinem Workspace.
Eingereicht amDatum und Uhrzeit der Einreichung.
Einreichungs-IDEindeutige ID der Einreichung.
Einreichungstyp"Neu", "Aktualisiert" oder "Teilweise".
Submission Language (Einreichungssprache)BCP-47-Code für die vom Teilnehmenden verwendete Sprache, zum Beispiel en oder nb-NO.
PDF-LinkPermanenter Download-Link für die PDF-Datei der Einreichung.
Autorisierte E-MailDie E-Mail-Adresse der angemeldeten Person. Nur verfügbar, wenn Authentifizierung erforderlich aktiviert ist.

PINs als Referenznummern

Füge eine 6-stellige PIN in die Bestätigungs-E-Mail an Teilnehmende ein, als Referenznummer. Teilnehmende können sie in Folgekonversationen angeben, und du kannst danach in der Einreichungstabelle suchen.

Beispiele

  • Personalisierte Frage — “Danke @Vorname! Wie würdest du deine Erfahrung mit @Unternehmen bewerten?”

  • Dynamische Dankesseite — “Dein Gesamtbetrag ist @Preis. Wir senden eine Bestätigung an @E-Mail innerhalb von 24 Stunden.”

  • Bedingte E-Mail — “Hallo @Vorname, dein Lead-Score ist @Lead-Score. Unser Team wird sich bei dir melden.”

  • Weiterleitung mit Kontext — füge in den Weiterleitungseinstellungen einen name-Parameter hinzu, der der Frage Name zugeordnet ist, und einen plan-Parameter, der Plan zugeordnet ist. Die Vorschau zeigt die URL, an die Teilnehmende weitergeleitet werden:

https://yoursite.com/confirm?name={Name}&plan={Plan}

Wiederholungsgruppen referenzieren

Wiederholungsgruppen lassen Teilnehmende so viele Einträge hinzufügen, wie sie brauchen, sodass eine einzelne Referenz mehr als einen Wert liefern kann. Wie die @-Erwähnung aufgelöst wird, hängt davon ab, worauf sie zeigt.

  • Ein einzelnes Mitgliedsfeld — formbase verbindet die Werte dieses Felds über alle Einträge hinweg mit · . Eine Erwähnung des Felds Name von drei Gästen zeigt “Jane Appleseed · Marcus Lee · Priya Patel”.

  • Die ganze Gruppe — jeder Eintrag erscheint inline. Mitgliedswerte innerhalb eines Eintrags werden mit · verbunden, und Einträge werden durch Kommas getrennt. Eine Gruppe mit Name und Alter zeigt “Jane Appleseed · 34, Marcus Lee · 29”.

In einer Integrationsspalte erscheint die ganze Gruppe stattdessen als nummerierte, beschriftete Zeilen, sodass jeder Eintrag lesbar bleibt: “1. Vollständiger Name: Jane Appleseed, Alter: 34, 2. Vollständiger Name: Marcus Lee, Alter: 29”.

Ein referenziertes Feld löschen

Eine Erwähnung, die weiterhin auf ein gelöschtes Feld zeigt, ist beim Veröffentlichen ein Fehler, keine Warnung: Der Veröffentlichungsindikator in der Toolbar markiert jede veraltete Referenz — in Formularinhalten, E-Mail-Vorlagen, übersetzten E-Mails und Integrationsnachrichtenvorlagen — und die Veröffentlichung wird gestoppt, bis jede einzelne behoben ist. Öffne die markierte Stelle, entferne den fehlerhaften Chip und füge das richtige Feld erneut ein.

Nächste Schritte