GitHub Issues

Wat je krijgt

• Één GitHub issue per inzending, gekoppeld aan de verbindende gebruiker

• Titel en beschrijving opgebouwd via een sjablooneditor — typ @ om een formulierveldwaarde in te voegen

• Beschrijving ondersteunt GitHub-flavored markdown (vet, lijsten, koppen, code-omheiningen, links)
• Optionele standaard milestone toegepast op elk issue

• Testknop die een echt [Test]-issue aanmaakt zodat je kunt verifiëren vóór je live gaat

GitHub verbinden

1. 1

   Open Formulierinstellingen → Integraties → GitHub Issues

   Klik op Verbind GitHub-account, of kies een account dat de workspace al heeft verbonden. Een pop-up begeleidt je door de OAuth-toestemming. Gevraagde scopes: repo, read:user, read:org.

2. 2

   Kies een repository

   De kiezer toont repos waartoe je push-toegang hebt. formbase sluit gearchiveerde en uitgeschakelde repos uit.

3. 3

   Stel standaardwaarden in (optioneel)

   Kies een standaard milestone. Deze wordt toegepast op elk issue en wordt gereset wanneer je van repository wisselt.

4. 4

   Stel titel en beschrijving op

   Gebruik de sjablooneditors. Typ @ om formulierveldwaarden of inzendingsmetagegevens zoals PDF Link in te voegen. De titel wordt weergegeven als platte tekst (max. 256 tekens); de beschrijving wordt weergegeven als GitHub-flavored markdown.

5. 5

   Verlaten inzendingen (optioneel)

   Kies een inactiviteitsvenster en schrijf een aparte titel en beschrijving voor concepten die niemand heeft afgemaakt. Laat het op Uit staan om over te slaan. Vereist Pro of Business.

6. 6

   Afronden

   Test versturen maakt een echt issue aan met een [Test]-voorvoegsel in de gekozen repository — sluit of verwijder het achteraf. Klik daarna op Maak integratie en elke inzending maakt een GitHub issue aan.

Verlaten reactie-events

Wanneer een respondent je formulier begint maar niet afmaakt, kan formbase een apart issue aanmaken voor de gedeeltelijke gegevens. Zet Stuur verlaten-gebeurtenis na op 12 uur, 1 dag, 3 dagen of 1 week en vul dan de titel en beschrijving voor het verlaten issue in — geen van beide mag leeg zijn. Verlaten issues krijgen een partial-submission-label, dat bij het eerste gebruik wordt aangemaakt.

Een uurlijkse ronde zoekt naar inactieve concepten, dus het issue verschijnt bij de eerste ronde nadat het venster is verstreken. Alleen concepten via een deellink worden meegenomen, en Verplichte velden beperkt dit verder: het issue wordt alleen aangemaakt wanneer minstens één van de velden die je kiest is ingevuld.

Tokens

GitHub OAuth App-tokens verlopen niet — er is geen refresh-tokenrotatie. Als je de machtiging intrekt via de pagina met geautoriseerde OAuth-apps van je GitHub-account, mislukt de volgende verzending, markeert formbase de referentie als verlopen en ontvang je een foutmelding per e-mail. Verbind opnieuw via de werkruimte-integratiepagina om te herstellen.

De integratie verwijderen

• Vanuit formbase — Formulierinstellingen → Integraties → GitHub Issues → Verwijderen. Nieuwe inzendingen stoppen onmiddellijk met het aanmaken van issues.

• Vanuit GitHub — Trek de OAuth-machtiging in via de pagina met geautoriseerde OAuth-apps van je account. formbase trekt het token aan zijn kant niet automatisch in.

Limieten en gedrag

• Één issue per inzending — geen modus voor reageren op bestaande issues
• Geen terugvulling — alleen nieuwe inzendingen maken issues aan
• Titel is platte tekst, afgekapt met een beletselteken na 256 tekens; beschrijving is alleen markdown

• Een lege titel valt terug op New submission to <form name>

• Bestandsuploadantwoorden worden weergegeven als de bestandsnaam gevolgd door de downloadlink, zodat het bestand vanuit het issue bereikbaar is

• Antwoorden worden ongewijzigd in de issuetekst ingevoegd — bevat een antwoord @gebruikersnaam, dan krijgt die gebruiker een GitHub-melding, en #123 maakt een issue-verwijzing

Veelgestelde vragen

Volgende stappen