# Linear

Öffne bei jeder Einreichung ein Linear-Issue.

## Linear

Wandle Einreichungen automatisch in Linear-Issues um. Jede Einreichung erstellt ein Issue im gewählten Team – mit individuellem Titel, Beschreibung und Projekt.

<h2 id="what-you-get">Was du bekommst</h2>

<ul>
  <li>Ein Linear-Issue pro Einreichung, dem verbindenden Nutzer zugeordnet</li>
  <li>
    Titel und Beschreibung werden im Vorlageneditor erstellt — tippe <strong>@</strong>, um einen beliebigen Formularfeldwert einzufügen
  </li>
  <li>Beschreibung unterstützt Markdown (Fett, Listen, Überschriften, Code-Blöcke, Blockzitate, Links)</li>
  <li>Optionales Standardprojekt, das für jedes Issue gilt</li>
  <li>Vorhandene Einreichungen auf Wunsch nachträglich importieren (~1 Issue pro Sekunde)</li>
  <li>
    Test-Schaltfläche, die ein echtes Issue mit dem Präfix <code>[Test]</code> erstellt, damit du vor dem Live-Gang alles prüfen kannst
  </li>
</ul>

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

<h2 id="backfill">Vorhandene Einreichungen nachimportieren</h2>

<p>
  Wenn du dich zum ersten Mal verbindest, kannst du vorhandene Einreichungen als Linear-Issues exportieren. Der Nachimport läuft im
  Hintergrund mit ~1 Issue pro Sekunde, um innerhalb der Rate-Limits von Linear zu bleiben. Der Fortschritt wird alle 10 Einreichungen
  protokolliert.
</p>

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

<p>
  Wenn eine befragte Person dein Formular startet, es aber nicht abschließt, kann Formstep ein separates Issue für die Teilausfüllung
  erstellen. Stelle <strong>Abbruch-Ereignis senden nach</strong> auf 12 Stunden, 1 Tag, 3 Tage oder 1 Woche und fülle dann Titel und
  Beschreibung des abgebrochenen Issues aus — keins von beiden darf leer bleiben. Abgebrochene Issues erhalten das Label{' '}
  <code>partial-submission</code>.
</p>

<p>
  Ein stündlicher Durchlauf sucht nach untätigen Entwürfen, sodass das Issue beim ersten Durchlauf nach Ablauf des Fensters erscheint. Nur
  Entwürfe von einem Freigabe-Link werden erfasst, und <strong>Erforderliche Felder</strong> schränkt es weiter ein: Das Issue wird nur
  erstellt, 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 Linear-Integration ist in allen
>     Plänen verfügbar. Siehe <a href="/de/subscription-billing/plans-pricing">Pläne & Preise</a>.
>   </p>

<h2 id="token-refresh">Token-Aktualisierung</h2>

<p>
  Linear-Zugriffstoken werden vor jedem Versand automatisch erneuert, wenn sie kurz vor dem Ablauf stehen. Schlägt die Erneuerung fehl
  (Token widerrufen, App deinstalliert), markiert Formstep die Integration als fehlerhaft, und du erhältst eine Fehlerbenachrichtigung per
  E-Mail. Verbinde dich über die Workspace-Integrationsseite erneut, um die Verbindung wiederherzustellen.
</p>

<h2 id="removing">Integration entfernen</h2>

<ul>
  <li>
    <strong>In Formstep</strong> — Formulareinstellungen → Integrationen → Linear → Löschen. Neue Einreichungen erstellen sofort keine
    Issues mehr.
  </li>
  <li>
    <strong>In Linear</strong> — Widerrufe die OAuth-Berechtigung in deinen Nutzereinstellungen. Der nächste Versand schlägt fehl, und die
    Anmeldedaten werden als abgelaufen markiert.
  </li>
</ul>

<h2 id="limits">Limits und Verhalten</h2>

<ul>
  <li>Ein Issue pro Einreichung — kein Modus zum Kommentieren bestehender Issues</li>
  <li>Titel ist Klartext, wird nach 255 Zeichen mit einem Auslassungszeichen gekürzt; Beschreibung ist nur Markdown</li>
  <li>
    Ein leerer Titel greift auf <code>New submission to &lt;form name&gt;</code> zurück
  </li>
  <li>
    Datei-Upload-Antworten werden als Dateiname gefolgt von ihrem Download-Link dargestellt, sodass die Datei über das Issue erreichbar ist
  </li>
  <li>
    Ein mit @ eingefügtes <a href="/de/building-forms/repeating-groups">Wiederholungsgruppen</a>-Feld zeigt jeden Eintrag durch " · "
    verbunden
  </li>
</ul>

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

  <p>
    Drei Linear-OAuth-Berechtigungen: <code>read</code> (Teams, Projekte und Labels auflisten),
    <code>write</code> (Issue-Metadaten aktualisieren) und <code>issues:create</code> (Issues erstellen). Die Verbindung verwendet{' '}
    <code>actor=user</code>, sodass Issues dir zugeordnet werden, nicht einem Bot.
  </p>

  <p>
    Ja. Öffne das Detail-Sheet der Integration und ändere eines der beiden Felder. Ein Teamwechsel setzt das Projekt zurück, da Projekte
    teamspezifisch sind.
  </p>

  <p>
    Ja. Autorisiere verschiedene Linear-Konten, um mehrere Anmeldedaten hinzuzufügen. Jede Formularintegration wählt dann aus, welche
    verwendet wird.
  </p>

  <p>
    Ja. Linear-Verbindungen sind workspace-weit gültig. Jedes Workspace-Mitglied kann jedes verbundene Linear-Konto beim Einrichten einer
    Integration verwenden.
  </p>

  <p>
    Die Integration wird automatisch pausiert, und eine E-Mail geht an die Person, die sie eingerichtet hat. Ein widerrufener Token, eine
    verlorene Berechtigung oder ein gelöschtes Team wartet nicht auf fünf Fehler — die Integration stoppt sofort. So oder so: Behebe die
    Ursache und drücke dann Fortsetzen.
  </p>

<h2 id="next-steps">Nächste Schritte</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [GitHub Issues](/de/integrations/github) — Wandle Einreichungen in GitHub-Issues um
  - [Gesundheit und Überwachung](/de/integrations/health-monitoring) — Integrationsfehler und Token-Aktualisierungsstatus verfolgen
</div>