GitHub Issues

Was du erhältst

• Ein GitHub Issue pro Einreichung, zugeordnet dem verbindenden Benutzer

• Titel und Inhalt werden im Vorlageneditor erstellt — tippe @, um einen beliebigen Formularfeldwert einzufügen

• Der Inhalt unterstützt GitHub-Flavored Markdown (Fett, Listen, Überschriften, Code-Blöcke, Links)
• Optionaler Standard-Meilenstein, der auf jedes Issue angewendet wird

• Test-Schaltfläche, die ein echtes Issue mit dem Präfix [Test] erstellt, damit du vor dem Live-Gang überprüfen kannst

GitHub verbinden

1. 1

   Formulareinstellungen → Integrationen → GitHub Issues öffnen

   Drücke GitHub-Konto verbinden, oder wähle ein Konto, das der Workspace bereits verbunden hat. Ein Popup führt dich durch die OAuth-Zustimmung. Angeforderte Berechtigungen: repo, read:user, read:org.

2. 2

   Ein Repository auswählen

   Die Auswahl listet Repositories auf, für die du Push-Zugriff hast. formbase schließt archivierte und deaktivierte Repositories aus.

3. 3

   Standardwerte festlegen (optional)

   Wähle einen Standard-Meilenstein. Er wird auf jedes Issue angewendet und wird zurückgesetzt, wenn du das Repository wechselst.

4. 4

   Titel und Inhalt verfassen

   Verwende die Vorlageneditoren. Tippe @, um Formularfeldwerte oder Einreichungsmetadaten wie PDF Link einzufügen. Der Titel wird als Klartext dargestellt (max. 256 Zeichen); der Inhalt wird als GitHub-Flavored Markdown gerendert.

5. 5

   Abgebrochene Einreichungen (optional)

   Wähle ein Leerlauffenster und verfasse einen eigenen Titel und Inhalt für Entwürfe, die niemand abgeschlossen hat. Lasse es auf Aus, um zu überspringen. Erfordert Pro oder Business.

6. 6

   Fertigstellen

   Test senden erstellt ein echtes Issue mit dem Präfix [Test] im gewählten Repository — schließe oder lösche es danach. Drücke dann Integration erstellen, und jede Einreichung erstellt ein GitHub Issue.

Ereignisse bei abgebrochenen Antworten

Wenn eine befragte Person dein Formular startet, aber nicht abschließt, kann formbase ein separates Issue für die teilweise erfassten Daten erstellen. Stelle Abbruch-Ereignis senden nach auf 12 Stunden, 1 Tag, 3 Tage oder 1 Woche und fülle dann Titel und Inhalt des abgebrochenen Issues aus — keins von beiden darf leer bleiben. Abgebrochene Issues erhalten das Label partial-submission, das beim ersten Mal erstellt wird.

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 Erforderliche Felder schränkt es weiter ein: Das Issue wird nur erstellt, wenn mindestens eines der von dir gewählten Felder ausgefüllt wurde.

Tokens

GitHub-OAuth-App-Tokens laufen nicht ab — es gibt keine Refresh-Token-Rotation. Wenn du die Berechtigung auf der Seite der autorisierten OAuth Apps deines GitHub-Kontos widerrufst, schlägt der nächste Versand fehl, formbase markiert die Zugangsdaten als abgelaufen, und du erhältst eine Fehlerbenachrichtigungs-E-Mail. Verbinde dich über die Workspace-Integrationsseite erneut, um die Verbindung wiederherzustellen.

Integration entfernen

• Aus formbase — Formulareinstellungen → Integrationen → GitHub Issues → Löschen. Neue Einreichungen erstellen sofort keine Issues mehr.

• Aus GitHub — Widerrufe die OAuth-Berechtigung auf der Seite der autorisierten OAuth Apps deines Kontos. formbase widerruft das Token auf seiner Seite nicht automatisch.

Einschränkungen und Verhalten

• Ein Issue pro Einreichung — kein Modus zum Kommentieren bestehender Issues
• Kein Nachfüllen — nur neue Einreichungen erstellen Issues
• Titel ist Klartext, wird nach 256 Zeichen mit einem Auslassungszeichen gekürzt; Inhalt ist nur Markdown

• Ein leerer Titel greift auf New submission to <form name> zurück

• Datei-Upload-Antworten werden als Dateiname gefolgt von ihrem Download-Link dargestellt, sodass die Datei über das Issue erreichbar ist

• Antworten der befragten Person werden unverändert in den Issue-Inhalt eingefügt — enthält eine Antwort @benutzername, benachrichtigt GitHub diese Person, und #123 erzeugt eine Issue-Referenz

FAQ

Nächste Schritte