formbasedocs
Naar de appApp

Integraties

Linear

Verander inzendingen automatisch in Linear-issues. Elke inzending maakt één issue aan in het team dat je kiest, met een aangepaste titel, beschrijving en project.


Wat je krijgt

  • Één Linear-issue per inzending, toegewezen aan de verbindende gebruiker
  • Titel en beschrijving samengesteld via een sjablooneditor — typ @ om een formulierveldwaarde in te voegen

  • Beschrijving ondersteunt markdown (vet, lijsten, koppen, code-omheiningen, blokcitaten, links)
  • Optioneel standaardproject dat op elk issue wordt toegepast
  • Bestaande inzendingen op aanvraag terugvullen (~1 issue per seconde)
  • Testknop die een echt [Test]-issue aanmaakt zodat je kunt controleren voordat je live gaat

Linear verbinden

  1. 1

    Open Formulierinstellingen → Integraties → Linear

    Klik op Verbind Linear-account, of kies een account dat de werkruimte al heeft verbonden. Een pop-up begeleidt je door de OAuth-toestemming. Gevraagde scopes: read, write, issues:create.

  2. 2

    Kies een team

    Issues komen terecht in de backlog van dit team. Elke integratie richt zich op één team — voeg een andere integratie toe om naar een tweede team te routeren.

  3. 3

    Stel standaardwaarden in (optioneel)

    Kies een project. Dit wordt op elk issue toegepast en wordt gereset wanneer je van team 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. 255 tekens); de beschrijving wordt weergegeven als 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 het gekozen team — archiveer of verwijder het achteraf. Klik daarna op Maak integratie en elke inzending maakt een Linear-issue aan.

Bestaande inzendingen terugvullen

Wanneer je voor het eerst verbinding maakt, kun je bestaande inzendingen exporteren als Linear-issues. Het terugvullen loopt op de achtergrond met ~1 issue per seconde om binnen de limieten van Linear te blijven. Voortgang wordt elke 10 inzendingen bijgehouden.

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.

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.

Pro-functie

Bezorging van verlaten reacties vereist een Pro- of Business-abonnement. De kern Linear-integratie is beschikbaar op alle abonnementen. Zie abonnementen & prijzen.

Token vernieuwen

Linear-toegangstokens worden automatisch vernieuwd vóór elke verzending wanneer ze bijna verlopen. Als het vernieuwen mislukt (token ingetrokken, app verwijderd), markeert formbase de integratie als fout en ontvang je een foutmelding per e-mail. Verbind opnieuw via de werkruimte-integratiepagina om te herstellen.

De integratie verwijderen

  • Vanuit formbase — Formulierinstellingen → Integraties → Linear → Verwijderen. Nieuwe inzendingen stoppen direct met het aanmaken van issues.

  • Vanuit Linear — Trek de OAuth-machtiging in via je gebruikersinstellingen. De volgende verzending mislukt en de referentie wordt als verlopen gemarkeerd.

Limieten en gedrag

  • Één issue per inzending — geen modus voor reageren op bestaande issues
  • Titel is platte tekst, afgekapt met een beletselteken na 255 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

  • Een herhalende groep-veld dat met @ wordt ingevoegd, toont elke invoer samengevoegd met “ · “

Veelgestelde vragen

Drie Linear OAuth-scopes: read (teams, projecten en labels weergeven), write (issuemetagegevens bijwerken) en issues:create (issues aanmaken). De verbinding gebruikt actor=user, zodat issues aan jou worden toegewezen, niet aan een bot.

Ja. Open het integratiedetailvenster en wijzig een van beide velden. Bij het wisselen van team wordt het project gereset, omdat projecten teamspecifiek zijn.

Ja. Autoriseer verschillende Linear-accounts om meerdere referenties toe te voegen. Elke formulierintegratie kiest welke te gebruiken.

Ja. Linear-verbindingen zijn werkruimtegebonden. Elk werkruimtelid kan elk verbonden Linear-account gebruiken bij het instellen van een integratie.

De integratie wordt automatisch gepauzeerd en de persoon die haar heeft ingesteld ontvangt een e-mail. Een ingetrokken token, een verloren machtiging of een verwijderd team wacht niet op vijf mislukkingen — dat stopt de integratie meteen. Los in beide gevallen de oorzaak op en klik op Hervat.

Volgende stappen