# Antwort-Piping

Verwende @-Erwähnungen, um Antworten überall in deinem Formular zu referenzieren.

## 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.

<h2 id="how-it-works">So funktioniert es</h2>

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

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

<p>
  Um stattdessen ein einfaches <strong>@</strong> einzugeben — etwa in einer E-Mail-Adresse oder einem Handle —, drücke <kbd>Esc</kbd>, 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{' '}
  <strong>@</strong> eingegeben hast.
</p>

<h2 id="where-it-works">Wo Piping funktioniert</h2>

<ul>
  <li>Fragentitel — eine Frage bietet ihre eigene Antwort nie an, das wäre zirkulär</li>
  <li>Inhaltsblöcke: Paragraphen, Überschriften, Listenelemente, Tabellenzellen, Links und Bildunterschriften</li>
  <li>Inhalt der Dankesseite</li>
  <li>Übersetzungen von allem oben Genannten, wobei die Erwähnung in jede Sprache übernommen wird</li>
  <li>
    Betreff und Inhalt von E-Mail-Benachrichtigungen: eigene Benachrichtigungen, Bestätigungen an Teilnehmende und Erinnerungs-E-Mails bei
    abgebrochener Antwort, sowie die Request-Einladung
  </li>
  <li>
    Integrationsvorlagen: <a href="/de/integrations/slack">Slack</a>- und <a href="/de/integrations/discord">Discord</a>-Nachrichten,{' '}
    <a href="/de/integrations/github">GitHub</a>- und <a href="/de/integrations/linear">Linear</a>-Issue-Titel und -Beschreibungen, und{' '}
    <a href="/de/integrations/notion">Notion</a>- und <a href="/de/integrations/airtable">Airtable</a>-Feldzuordnungen
  </li>
</ul>

<p>
  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.
</p>

<p>
  Schaltflächenbeschriftungen und Titel von Wiederholungsgruppen unterstützen keine Erwähnungen. Zwei verwandte Funktionen funktionieren
  anders: <a href="/de/building-forms/redirect-after-submit#query-parameters">Weiterleitungs-Query-Parameter</a> wählen für jeden Parameter
  ein Feld aus einer Dropdown-Liste aus, und <a href="#input-defaults">Eingabe-Standardwerte</a> setzen einen Wert in ein Feld statt in
  Text.
</p>

<h2 id="input-defaults">Ein bearbeitbares Feld vorausfüllen</h2>

<p>
  Eine Erwähnung zeigt einen Wert als Text an, den die Person nicht ändern kann. Um einen Wert <em>in</em> ein Feld zu bringen, sodass die
  Person ihn bestätigen oder bearbeiten kann, verwende stattdessen eine Feldreferenz als Standardwert des Feldes: Tippe <kbd>@</kbd> als
  erstes Zeichen in einem Text Input-, Text Area-, Email-, Phone Number-, Website URL- oder Number-Feld. Dieses Menü listet nur{' '}
  <strong>Versteckte Felder</strong> und <strong>Berechnete Felder</strong> auf, da diese schon einen Wert haben, bevor die Person mit dem
  Beantworten beginnt. Siehe <a href="/de/building-forms/field-configuration#default-values">Standardwerte aus anderen Feldern</a>.
</p>

<p>
  Das ist die Technik für einen <strong>Freigabelink</strong>, wo ein Wert nur über einen URL-Parameter ankommen kann und deshalb ein
  verstecktes Feld braucht, in das er landet. Bei einem <a href="/de/requests/overview">Request</a> brauchst du davon nichts: Der Aufrufer
  füllt beim Erstellen des Requests eine sichtbare Frage direkt vor, mit <code>prefill</code>, und kann einen Schlüssel als{' '}
  <code>readonly</code> 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{' '}
  <a href="/de/building-forms/hidden-fields#requests-prefill-directly">Requests brauchen kein verstecktes Feld zum Vorausfüllen</a>.
</p>

<h2 id="field-types">Was du pipen kannst</h2>

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

<p>
  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.
</p>

<h2 id="metadata-variables">Metadaten-Variablen</h2>

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

<h3 id="metadata-form-and-email">Verfügbar in Formularinhalten und E-Mail-Vorlagen</h3>

<h3 id="metadata-form-only">Nur in Formularinhalten</h3>

<h3 id="metadata-email-only">Nur in E-Mail-Vorlagen</h3>

> 💡 **PINs als Referenznummern**
> <p>
>     Füge eine <strong>6-stellige PIN</strong> 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.
>   </p>

<h2 id="examples">Beispiele</h2>

<ul>
  <li>
    <strong>Personalisierte Frage</strong> — "Danke @Vorname! Wie würdest du deine Erfahrung mit @Unternehmen bewerten?"
  </li>
  <li>
    <strong>Dynamische Dankesseite</strong> — "Dein Gesamtbetrag ist @Preis. Wir senden eine Bestätigung an @E-Mail innerhalb von 24
    Stunden."
  </li>
  <li>
    <strong>Bedingte E-Mail</strong> — "Hallo @Vorname, dein Lead-Score ist @Lead-Score. Unser Team wird sich bei dir melden."
  </li>
  <li>
    <strong>Weiterleitung mit Kontext</strong> — füge in den Weiterleitungseinstellungen einen <code>name</code>-Parameter hinzu, der der
    Frage Name zugeordnet ist, und einen <code>plan</code>-Parameter, der Plan zugeordnet ist. Die Vorschau zeigt die URL, an die
    Teilnehmende weitergeleitet werden:
  </li>
</ul>

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

<h2 id="referencing-repeating-groups">Wiederholungsgruppen referenzieren</h2>

<p>
  <a href="/de/building-forms/repeating-groups">Wiederholungsgruppen</a> 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.
</p>

<ul>
  <li>
    <strong>Ein einzelnes Mitgliedsfeld</strong> — Formstep verbindet die Werte dieses Felds über alle Einträge hinweg mit{' '}
    <strong> · </strong>. Eine Erwähnung des Felds Name von drei Gästen zeigt "Jane Appleseed · Marcus Lee · Priya Patel".
  </li>
  <li>
    <strong>Die ganze Gruppe</strong> — jeder Eintrag erscheint inline. Mitgliedswerte innerhalb eines Eintrags werden mit{' '}
    <strong> · </strong> verbunden, und Einträge werden durch Kommas getrennt. Eine Gruppe mit Name und Alter zeigt "Jane Appleseed · 34,
    Marcus Lee · 29".
  </li>
</ul>

<p>
  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".
</p>

<h2 id="deleting-piped-fields">Ein referenziertes Feld löschen</h2>

<p>
  Eine Erwähnung, die weiterhin auf ein gelöschtes Feld zeigt, ist beim Veröffentlichen ein <em>Fehler</em>, keine Warnung: Der
  Veröffentlichungsindikator in der Toolbar markiert jede veraltete Referenz — in Formularinhalten, E-Mail-Vorlagen,{' '}
  <a href="/de/building-forms/translating-form-content#field-reference-checks">übersetzten E-Mails</a> 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.
</p>

<h2 id="next-steps">Nächste Schritte</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Benutzerdefinierte Dankesseite](/de/building-forms/custom-thank-you) — Antworten auf der Seite nach dem Absenden einfügen
  - [Formulareinstellungen](/de/building-forms/form-settings) — Benachrichtigungsvorlagen mit eingefügten Variablen einrichten
  - [Eigene Benachrichtigungen](/de/submissions-analytics/self-notifications) — Piping in Team-Alert-E-Mails verwenden
  - [Benachrichtigungen an Teilnehmende](/de/submissions-analytics/respondent-notifications) — Bestätigungs-E-Mails mit Piping personalisieren
  - [Wiederholungsgruppen](/de/building-forms/repeating-groups) — Teilnehmenden erlauben, mehrere Einträge zu einer Gruppe hinzuzufügen
</div>
