Variablen

Überblick

Variablen in NueForm ermöglichen dir dynamische, personalisierte Formularerlebnisse. Du kannst Teilnehmerantworten, URL-Parameter und eigene Formularvariablen überall in deinen Fragetiteln, Beschreibungen, Willkommensbildschirmen und Dankesbildschirmen referenzieren — mit der Ersetzungssyntax {variableName}.

Variablentypen

NueForm unterstützt drei Variablentypen:

1. Antwortvariablen

Antwortvariablen erfassen die Antwort eines Teilnehmers auf eine bestimmte Frage und machen sie für spätere Fragen verfügbar.

So richtest du sie ein:

1. Wähle eine Frage im Formular-Builder aus.
2. Suche in den Frageeinstellungen das Feld Antwortvariable.
3. Gib einen Variablennamen ein (z. B. name, company, rating).
4. Die Antwort des Teilnehmers auf diese Frage wird nun als {name}, {company} oder {rating} gespeichert.

Beispiel:

• Frage 1: „Wie heißt du?" (Antwortvariable: name)
• Titel von Frage 2: „Schön, dich kennenzulernen, {name}! Was führt dich heute her?"

Wenn der Teilnehmer bei Frage 1 „Sarah" eingibt, zeigt Frage 2: „Schön, dich kennenzulernen, Sarah! Was führt dich heute her?"

Wertumwandlung:

2. URL-Variablen

URL-Variablen sind Werte, die über URL-Query-Parameter an das Formular übergeben werden. Sie sind sofort beim Laden des Formulars verfügbar, noch bevor Fragen beantwortet wurden.

So nutzt du sie:

Hänge Query-Parameter an deine Formular-URL an:

https://nueform.io/f/my-form?firstName=John&company=Acme&source=email

Diese Parameter sind automatisch als Variablen verfügbar:

• {firstName} wird zu „John"
• {company} wird zu „Acme"
• {source} wird zu „email"

Anwendungsfälle:

• Formularfelder mit bekannten Daten vorbefüllen.
• Begrüßungen personalisieren: „Hi {firstName}, wir haben ein paar Fragen an dich."
• Empfehlungsquellen in deinen Antwortdaten nachverfolgen.
• Teilnehmer per Start-Logiksprüngen basierend auf URL-Parametern weiterleiten.

3. Formularvariablen

Formularvariablen sind vordefinierte Variablen mit Name, Typ und Standardwert. Sie werden auf Formularebene definiert und können durch Variablenaktionen in Logiksprüngen verändert werden.

So definierst du sie:

Formularvariablen werden in den Variablendefinitionen des Formulars festgelegt und haben folgende Eigenschaften:

So werden sie verändert:

Formularvariablen werden über Variablenaktionen an Logiksprüngen verändert. Wenn die Bedingung eines Logiksprungs zutrifft, werden die zugehörigen Variablenaktionen ausgeführt:

Beispiel: Einen Punkterechner bauen

1. Definiere eine Formularvariable: score (Typ: number, Standard: 0).
2. Füge bei jeder Frage Logiksprünge mit Variablenaktionen hinzu:
   • Wenn Bewertung >= 4, addiere 10 zu score.
   • Wenn Bewertung >= 2, addiere 5 zu score.
3. Auf dem Dankesbildschirm: „Deine Punktzahl ist {score} von 50."

Ersetzungssyntax

Die {variableName}-Syntax funktioniert an folgenden Stellen:

So funktioniert die Ersetzung

1. Das System durchsucht Text nach {variableName}-Mustern (einfache geschweifte Klammern mit Wortzeichen darin).
2. Es schlägt den Variablennamen in der aktuellen Variablen-Map nach.
3. Wird er gefunden, wird das Token durch den Wert der Variable ersetzt.
4. Wird er nicht gefunden, wird das Token durch einen leeren String ersetzt.

Variablenerkennung

NueForm erkennt automatisch alle in deinem Formular referenzierten Variablen, indem es Folgendes durchsucht:

• {variableName}-Tokens in allen Textfeldern (Titel, Beschreibungen, Willkommens-/Dankesbildschirme).
• Felder mit url:-Präfix in Bedingungen von Logiksprüngen.
• Variablennamen in Aktionen von Logiksprüngen.
• answerVariable-Deklarationen an Fragen.
• Variablendefinitionen auf Formularebene.

Dieser umfassende Scan erzeugt eine sortierte, deduplizierte Liste aller in deinem Formular verwendeten Variablennamen.

Auflösungsreihenfolge der Variablen

Beim Auflösen eines {variableName}-Tokens prüft NueForm Variablen in dieser Reihenfolge:

1. URL-Variablen — über die Formular-URL übergeben.
2. Antwortvariablen — gesetzt durch die Antworten der Teilnehmer auf Fragen mit konfigurierter answerVariable.
3. Formularvariablen — auf Formularebene definiert und durch Logiksprung-Aktionen verändert.

Existiert derselbe Variablenname in mehreren Quellen, haben URL-Variablen Vorrang (da sie die Quelle sind, die zusammen mit den eingemischten Formular-/Antwortvariablen an die Ersetzungsfunktion übergeben wird).

Beispiele

Personalisierte Begrüßung

URL: https://nueform.io/f/feedback?name=Sarah&product=Widget

Willkommenstitel: „Hi {name}!" Willkommensbeschreibung: „Wir würden gerne deine Meinung zu {product} hören."

Ergebnis: „Hi Sarah!" / „Wir würden gerne deine Meinung zu Widget hören."

Dynamische Folgefragen

Frage 1: „Was ist deine Rolle?" (Antwortvariable: role) Frage 2: „Was ist als {role} deine größte Herausforderung?"

Anzeige einer berechneten Punktzahl

Formularvariable: score (number, Standard: 0) Logiksprung-Aktionen: Punkte basierend auf Antworten addieren Dankesbeschreibung: „Du hast {score} Punkte erreicht! Danke fürs Abschließen des Quiz."

Bedingte Weiterleitung mit URL-Variablen

URL: https://nueform.io/f/survey?plan=enterprise

Start-Logiksprung:

• Bedingung: url:plan gleich "enterprise"
• Ziel: Sprung zu Enterprise-spezifischen Fragen
• Aktion: Setze plan_name auf "Enterprise"

Best Practices

1. Verwende aussagekräftige Namen: Wähle Variablennamen, die klar erkennen lassen, was sie speichern (z. B. customer_name statt n).
2. Setze Standardwerte: Gib bei Formularvariablen immer einen sinnvollen Standardwert an, falls die Variable nie verändert wird.
3. Teste mit URL-Parametern: Wenn du URL-Variablen nutzt, teste dein Formular mit verschiedenen Parameterkombinationen, um sicherzustellen, dass alle Pfade korrekt funktionieren.
4. Gehe elegant mit fehlenden Variablen um: Falls eine URL-Variable möglicherweise nicht übergeben wird, gestalte deinen Text so, dass er sich auch dann natürlich liest, wenn die Variable zu einem leeren String aufgelöst wird.