Erweiterte Fragetypen

Rechtliches / AGB

Eine Frage zur Annahme von Geschäftsbedingungen, die eine Erklärung präsentiert und den Teilnehmer akzeptieren oder ablehnen lässt.

Typ-Bezeichner: legal

Eigenschaften

Verhalten

• Zeigt den Rechtstext aus buttonText an.
• Der Teilnehmer klickt auf „Ich akzeptiere" oder „Ich akzeptiere nicht".
• Typischerweise verwendet für Datenschutzerklärungen, Nutzungsbedingungen, Einwilligungsformulare und Auftragsverarbeitungsvereinbarungen.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer die Bedingungen akzeptieren, um fortzufahren. Das Ablehnen (Auswahl von „Ich akzeptiere nicht") zeigt bei einer Pflichtfrage einen Validierungsfehler.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Vergleiche bei equals gegen true (akzeptiert) oder false (abgelehnt).

Antwortformat

Die Antwort wird als boolean gespeichert (true für akzeptiert, false für abgelehnt, oder null, wenn unbeantwortet).

Bewertung im Quiz-Modus

Rechtliches ist ein bewertbarer Fragetyp:

• Wissensquiz: Setze correctAnswers mit "true" oder "false".
• Lead-Qualifizierung: Setze choiceScores mit den Schlüsseln "true" und "false".
• Match-Quiz: Setze choiceOutcomes als Zuordnung von Annahme/Ablehnung zu Endbildschirmen.

Zahlung

Erfasse Zahlungen von Teilnehmern als Teil des Formularablaufs über die Stripe-Integration. Unterstützt zwei Zahlungsmodi, konfigurierbare Währungen sowie feste oder variable Beträge.

Typ-Bezeichner: payment

Zahlungsmodi

Eigenschaften

Verhalten

• Ist price gesetzt, sieht der Teilnehmer den festen Betrag und gibt seine Kartendaten an.
• Ist price nicht gesetzt, gibt der Teilnehmer seinen eigenen Betrag ein (Variabel-/Spendenmodus).
• Für die sichere Kartenerfassung wird das Stripe Payment Element gerendert.
• Nach erfolgreicher Zahlung springt das Formular automatisch zur nächsten Frage.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer die Zahlung abschließen, um fortzufahren.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als PaymentResult-Objekt gespeichert:

{
  "paymentIntentId": "pi_abc123",
  "amount": 2999,
  "currency": "usd",
  "status": "succeeded"
}

Datum

Ein Datumswähler, mit dem Teilnehmer ein Datum auswählen können. Unterstützt konfigurierbare Datumsformate.

Typ-Bezeichner: date

Eigenschaften

Verhalten

• Zeigt eine Datumswähler-Oberfläche.
• Der Teilnehmer kann ein Datum manuell eintippen oder aus einem Kalender-Widget auswählen.
• Das Datum wird unabhängig vom Anzeigeformat im ISO-Format gespeichert.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer ein Datum auswählen.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als string gespeichert (der Datumswert, typischerweise im ISO-Format oder im konfigurierten dateFormat).

Ranking

Präsentiere eine Liste von Elementen, die der Teilnehmer per Drag-and-drop in seine bevorzugte Reihenfolge bringt.

Typ-Bezeichner: ranking

Eigenschaften

Verhalten

• Elemente werden in einer Liste angezeigt.
• Der Teilnehmer zieht Elemente, um sie umzusortieren.
• Ziehgriffe kennzeichnen ziehbare Elemente.
• Touch- und Mausinteraktion werden beide unterstützt.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer ein Ranking übermitteln.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als Array von Strings gespeichert (Auswahl-IDs in der vom Teilnehmer gewählten Reihenfolge).

Matrix

Ein rasterbasierter Fragetyp, bei dem Teilnehmer mehrere Elemente über mehrere Kategorien bewerten.

Typ-Bezeichner: matrix

Eigenschaften

Verhalten

• Wird als Raster angezeigt, mit Zeilen links und Spalten oben.
• Der Teilnehmer wählt eine Option pro Zeile.
• Auf Mobilgeräten passt sich das Raster für bessere Bedienbarkeit einem gestapelten Format an.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer für jede Zeile eine Option auswählen.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als object gespeichert, das Zeilenbeschriftungen den ausgewählten Spaltenbeschriftungen zuordnet:

{
  "Quality": "Excellent",
  "Speed": "Good",
  "Support": "Average"
}

Kontaktinfo

Erfasse strukturierte Kontaktinformationen — Name, E-Mail-Adresse und Telefonnummer — in einer einzigen Frage.

Typ-Bezeichner: contact_info

Eigenschaften

Verhalten

• Zeigt Felder für Vorname, Nachname, E-Mail und Telefonnummer.
• Das Telefonfeld enthält eine Ländervorwahl-Auswahl.
• Jedes Unterfeld kann einzeln als erforderlich oder optional festgelegt werden.

Validierung

Ist required auf true gesetzt, müssen alle sichtbaren Unterfelder ausgefüllt werden.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als object gespeichert:

{
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane@example.com",
  "phone": "+14155551234"
}

Adresse

Erfasse eine vollständige Postadresse mit optionaler Autovervollständigung über Google Places.

Typ-Bezeichner: address

Eigenschaften

Verhalten

• Zeigt Felder für Straße, Stadt, Bundesland/Provinz, Postleitzahl und Land.
• Bei aktivierter Autovervollständigung zeigt das Tippen im Straßenfeld Adressvorschläge.
• Die Auswahl eines Vorschlags füllt alle Adressfelder automatisch aus.

Validierung

Ist required auf true gesetzt, müssen alle Adressfelder ausgefüllt werden.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als object gespeichert:

{
  "street": "123 Main St",
  "city": "San Francisco",
  "state": "CA",
  "postalCode": "94105",
  "country": "US"
}

Data Node

Ein unsichtbarer Fragetyp, der während des Formularablaufs HTTP-API-Aufrufe ausführt. Data Nodes werden Teilnehmern nicht angezeigt — sie laufen automatisch und können Daten abrufen, Antworten validieren oder externe Aktionen auslösen.

Typ-Bezeichner: data_node

Eigenschaften

Verhalten

• Wird automatisch ausgeführt, sobald er im Formularablauf erreicht wird.
• Alle {variableName}-Tokens in URL, Headern und Body werden durch aktuelle Variablenwerte ersetzt.
• Ist dataNodeResponseVariable gesetzt, wird die vollständige JSON-Antwort als Formularvariable gespeichert.
• Im Silent-Modus läuft der Request im Hintergrund ohne Ladeindikator.
• Im Validierungs-Gate-Modus blockiert ein fehlschlagender Request das Weiterkommen von der vorherigen Frage.

Anwendungsfälle

• Externe Daten abrufen: Produktdetails, Preise oder Nutzerprofile während des Formularablaufs nachschlagen.
• Antworten validieren: Eine E-Mail gegen deine Datenbank prüfen, einen Gutscheincode verifizieren oder eine Adresse validieren.
• Aktionen auslösen: Daten an einen Webhook senden, einen Datensatz in deinem CRM anlegen oder einen Workflow starten.

Composite

Bette ein wiederverwendbares, versioniertes Fragenbündel ein — einmal auf der Composites-Seite definiert und über Formulare hinweg geteilt. Teilnehmer sehen alle Felder des Composites auf einem Bildschirm und übermitteln sie gemeinsam. Siehe die Composites-Anleitung zum Erstellen, Bearbeiten, Veröffentlichen und Nachverfolgen von Einträgen.

Typ-Bezeichner: composite_ref

Eigenschaften

Validierung

Erforderliche Unterfelder werden gemeinsam validiert, wenn der Teilnehmer den Bildschirm absendet.

Logiksprung-Operatoren

is_answered, is_not_answered an der Frage selbst. Einzelne Unterantworten können in jeder Bedingung über die Unterfeld-Adressierung (questionId.subFieldId) angesprochen werden — Unterfelder erscheinen in der Bedingungsfeld-Auswahl unter ihrer übergeordneten Frage.

Antwortformat

Ein object mit Unterfeld-IDs als Schlüssel:

{ "sub_first_name": "Ada", "sub_title": "Director", "sub_email": "ada@example.com" }

Die Übermittlung wird zusätzlich als Composite-Eintrag erfasst, sichtbar über alle Formulare hinweg in der Einträge-Ansicht des Composites.

Gemeinsame erweiterte Funktionen

Rich Text in Titeln und Beschreibungen

Alle erweiterten Fragetypen unterstützen Rich Text in ihren Titel- und Beschreibungsfeldern. Rich Text wird über einen Tiptap-basierten Editor im Formular-Builder eingegeben und unterstützt:

• Fett, kursiv, Unterstreichung und Durchstreichung
• Links (mit den Attributen href, target, rel)
• Geordnete und ungeordnete Listen
• Inline-Code
• Tief- und Hochstellung
• Eigene Schriftfamilien und Farben über Inline-Styles

Der Rich Text wird als HTML gespeichert und vor dem Rendern mit DOMPurify und einer strikten Allowlist von Tags und Attributen bereinigt.

Variablenersetzung

Alle erweiterten Fragetypen unterstützen die {variableName}-Ersetzung in ihren Titel- und Beschreibungsfeldern. Siehe die Anleitung zu Variablen.

Medienanhänge

Alle erweiterten Fragetypen unterstützen Medienanhänge (Bild, Video, Icon, QR-Code) mit der vollen Bandbreite an Layout-Optionen. Siehe die Anleitung Formulare erstellen.