# Airtable

Übertrage Einreichungen mit typisierter Feldzuordnung in eine Airtable-Base.

## Airtable

Sende jede Einreichung als neuen Datensatz an eine Airtable-Tabelle. Ordne Felder typisierten Spalten zu, erstelle einen Rich-Text-Inhalt und befülle vergangene Antworten nach.

<h2 id="what-you-get">Was du erhältst</h2>

<ul>
  <li>Ein Datensatz pro Einreichung</li>
  <li>Feldzuordnung auf Feldebene mit Typkompatibilitätsprüfungen</li>
  <li>Metadatenzuordnung, einschließlich eines Links zum erzeugten Einreichungs-PDF</li>
  <li>Optionales Rich-Text-Inhaltsfeld mit Überschriften, Fettschrift, Listen und eingefügten Antworten</li>
  <li>Nachbefüllung bestehender Einreichungen bei der Verbindung (in Stapeln von 10)</li>
  <li>Automatische Wiederherstellung bei umbenannten Spalten</li>
  <li>Testdatensatz zur Überprüfung der Verbindung, bevor echte Einreichungen eintreffen</li>
</ul>

<h2 id="connect">Airtable verbinden</h2>

<h2 id="column-types">Spaltentypen</h2>

<p>Formstep erstellt automatisch Auswahloptionen, wenn der übermittelte Wert keiner vorhandenen Option entspricht.</p>

<p>
  Formel-, Rollup-, Zähl-, Nachschlage-, verknüpfte Datensatz-, Mitarbeiter-, Erstellungs-/Änderungszeit-, Erstellt/Geändert-von-,
  automatische Nummerierungs-, Schaltflächen- und synchronisierte Quellspalten sind schreibgeschützt und können nicht zugeordnet werden.
</p>

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

<p>
  Eine <a href="/de/building-forms/repeating-groups">Wiederholungsgruppe</a> lässt Befragte so viele Einträge hinzufügen, wie sie brauchen —
  etwa eine Gästeliste mit Name und Alter zu jedem Eintrag. In der Feldauswahl legst du fest, wie sie zugeordnet wird:
</p>

<ul>
  <li>
    <strong>Die gesamte Gruppe</strong> wird einem Feld zugeordnet. Jeder Eintrag erscheint als nummerierte, beschriftete Zeile, etwa „1.
    Full name: Jane Appleseed, Age: 34, 2. Full name: Marcus Lee, Age: 29".
  </li>
  <li>
    <strong>Jedes einzelne Feld</strong> wird seinem eigenen Feld zugeordnet. Die Werte aus jedem Eintrag werden mit <code> · </code>{' '}
    verbunden, sodass das Feld Full name „Jane Appleseed · Marcus Lee" liest.
  </li>
</ul>

<p>
  Wähle eines, das andere, oder beides. Entfernst du später ein Feld aus deinem Formular, erscheint es weiterhin in der Auswahl, sodass
  vergangene Datensätze ihr Feld behalten — deine Zuordnung bricht nie.
</p>

<h2 id="rich-text-body">Rich-Text-Inhalt</h2>

<p>
  Wenn deine Tabelle eine Rich-Text-, Langtext- oder einzeilige Textspalte hat, kannst du deren Inhalt mit dem Vorlageneditor erstellen.
  Tippe <strong>@</strong>, um einen beliebigen Formularfeldwert oder Metadaten wie PDF Link einzufügen — der Editor zeigt sie als
  Erwähnungs-Chips an, die zum Synchronisierungszeitpunkt aufgelöst werden. Rich-Text-Spalten behalten die Formatierung bei; andere
  Spaltentypen erhalten einfaches Markdown.
</p>

<p>
  Unterstützte Formatierung: Überschriften (H1-H4), <strong>Fett</strong>, <em>Kursiv</em>, ~~Durchgestrichen~~, <code>Inline-Code</code>,
  Links und geordnete/ungeordnete Listen. Bilder und Einbettungen werden nicht unterstützt.
</p>

<h2 id="backfill">Bestehende Einreichungen nachbefüllen</h2>

<p>
  Nach der Verbindung kannst du vergangene Antworten nachbefüllen. Datensätze werden in Stapeln von 10 mit einer kurzen Verzögerung zwischen
  den Stapeln geschrieben, um die Ratenlimits von Airtable einzuhalten. Der Fortschritt wird im Integrationspanel angezeigt.
</p>

<h2 id="test-event">Testereignis</h2>

<p>
  Der Schritt Fertigstellen und das Integrations-Detailpanel haben beide eine Schaltfläche <strong>Test senden</strong>, die einen
  Platzhalterdatensatz schreibt. Textspalten erhalten <code>[Question Title]</code>-Zeichenfolgen, Zahlen erhalten <code>0</code>, E-Mails
  erhalten <code>test@example.com</code>, Datumsangaben erhalten den aktuellen Zeitstempel, und Auswahlfelder verwenden die erste Option aus
  den Auswahlmöglichkeiten der Frage (um das Erstellen unerwünschter Optionen zu vermeiden). Lösche den Testdatensatz nach der Überprüfung.
</p>

<h2 id="abandoned-responses">Ereignisse bei abgebrochenen Antworten</h2>

<p>
  Wenn eine befragte Person dein Formular startet, aber nicht abschließt, kann Formstep die Teildaten trotzdem synchronisieren. Stelle im
  Schritt <strong>Abgebrochene Einreichungen</strong> <strong>Abbruch-Ereignis senden nach</strong> auf 12 Stunden, 1 Tag, 3 Tage oder 1
  Woche. Ein stündlicher Durchlauf schreibt dann einen Datensatz mit derselben Feldzuordnung wie eine abgeschlossene Einreichung. Ordne das
  Metadatenfeld „Einreichungsstatus" einer Einfachauswahl- oder Textspalte zu, um „Partial"-Datensätze von „Completed"- und
  „Updated"-Datensätzen zu unterscheiden.
</p>

<p>
  Nur Entwürfe von einem Freigabe-Link werden erfasst, und <strong>Erforderliche Felder</strong> schränkt es weiter ein: Der Datensatz wird
  nur geschrieben, wenn mindestens eines der von dir gewählten Felder ausgefüllt wurde.
</p>

> ℹ️ **Pro-Funktion**
> <p>
>     Die Zustellung bei abgebrochenen Antworten erfordert einen Pro- oder Business-Plan. Die grundlegende Airtable-Integration ist in allen
>     Plänen verfügbar. Siehe <a href="/de/subscription-billing/plans-pricing">Pläne & Preise</a>.
>   </p>

<h2 id="schema-drift">Schemaänderungen und automatische Wiederherstellung</h2>

<p>
  Wenn du eine Spalte in Airtable umbenennst, erkennt Formstep die Änderung bei der nächsten Einreichung und aktualisiert die Zuordnung
  automatisch. Spalten werden anhand ihrer stabilen internen ID abgeglichen, sodass Umbenennungen transparent sind.
</p>

<p>
  Wenn du eine Spalte löschst, entfernt Formstep sie aus der Zuordnung und synchronisiert die verbleibenden Felder weiterhin. Wenn sich der
  Typ einer Spalte in etwas Inkompatibles ändert, schlägt die Synchronisierung des Werts fehl — öffne die Integration erneut und ordne
  dieses Feld neu zu.
</p>

<h2 id="troubleshooting">Fehlerbehebung</h2>

<ul>
  <li>
    <strong>Autorisierung abgelaufen</strong> — Airtable-Zugriffstoken sind etwa eine Stunde gültig und werden automatisch erneuert, sowohl
    durch einen täglichen Job als auch vor jeder Zustellung. Schlägt die Erneuerung selbst fehl — die Berechtigung wurde widerrufen, oder
    das Refresh-Token ist abgelaufen —, wird die Verbindung als abgelaufen markiert, und jede Integration darauf stoppt. Drücke Erneut
    verbinden.
  </li>
  <li>
    <strong>Spalte nicht sichtbar</strong> — Stelle sicher, dass die OAuth-Berechtigung die Base einschließt und der Spaltentyp beschreibbar
    ist (siehe Tabelle oben).
  </li>
  <li>
    <strong>Ratenlimit</strong> — Airtable erzwingt 5 Anfragen/Sekunde pro Base. Nachbefüllungen werden automatisch gedrosselt;
    Live-Synchronisierungen werden mit Backoff wiederholt.
  </li>
</ul>

<h2 id="faq">FAQ</h2>

  <p>
    Vier Airtable-Berechtigungen: Datensatzdaten lesen/schreiben, Base-Schemas lesen und deine E-Mail lesen (zur Kontoidentifizierung).
    Verwendet OAuth mit PKCE — keine API-Schlüssel zu verwalten.
  </p>

  <p>
    Ja. Airtable-Verbindungen sind workspace-weit gültig. Jedes Mitglied kann bei der Einrichtung einer Integration ein beliebiges
    verbundenes Konto verwenden.
  </p>

  <p>Ja. Autorisiere weitere Konten bei der Einrichtung neuer Integrationen. Jedes Formular wählt, welches Konto verwendet werden soll.</p>

  <p>
    Die nächste Einreichung schlägt mit einem „nicht gefunden"-Fehler fehl, und die Integration stoppt. Die Base und die Tabelle sind bei
    der Erstellung der Integration fixiert — lösche diese Integration und erstelle eine neue gegen die neue Tabelle.
  </p>

  <p>
    Nein. Diese sind in der Airtable-API schreibgeschützt. Die vollständige Liste der ausgeschlossenen Spaltentypen findest du im Abschnitt{' '}
    <a href="#column-types">Spaltentypen</a>.
  </p>

  <p>
    Gehe zu Formulareinstellungen → Integrationen → Airtable und lösche die Integration. Um auch den Zugriff von Formstep zu widerrufen,
    gehe zu deinen Airtable-Kontoeinstellungen und entferne die Formstep-OAuth-App.
  </p>

<h2 id="next-steps">Nächste Schritte</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Linear](/de/integrations/linear) — Wandle Einreichungen in Linear-Issues um
  - [GitHub Issues](/de/integrations/github) — Wandle Einreichungen in GitHub-Issues um
  - [Wiederholungsgruppen](/de/building-forms/repeating-groups) — Befragte mehrere Einträge hinzufügen lassen
</div>