formbasedocs
Gå til appenAppen

Integrasjoner

GitHub Issues

Gjør innsendinger til GitHub-saker automatisk. Hver innsending oppretter én sak i depotet du velger, med egendefinert tittel, innhold og milepæl.


Hva du får

  • Én GitHub-sak per innsending, tilknyttet den tilkoblede brukeren
  • Tittel og innhold bygget fra et malredigeringsprogram — skriv @ for å sette inn verdien fra et skjemafelt

  • Innholdet støtter GitHub-flavored markdown (fet, lister, overskrifter, kodeblokker, lenker)
  • Valgfri standard milepæl som gjelder for alle saker
  • Testknapp som oppretter en ekte sak med [Test]-prefiks slik at du kan verifisere før du går live

Koble til GitHub

  1. 1

    Åpne Skjemainnstillinger → Integrasjoner → GitHub Issues

    Klikk Koble til GitHub-konto, eller velg en konto arbeidsområdet allerede har koblet til. En popup guider deg gjennom OAuth-samtykke. Forespurte tillatelser: repo, read:user, read:org.

  2. 2

    Velg et depot

    Velgeren viser depoter der du har push-tilgang. formbase utelukker arkiverte og deaktiverte depoter.

  3. 3

    Angi standardverdier (valgfritt)

    Velg en standard milepæl. Den gjelder for alle saker og tilbakestilles når du bytter depot.

  4. 4

    Sett opp tittel og innhold

    Bruk malredigeringsprogrammene. Skriv @ for å sette inn skjemafeltverdier eller innsendingsmetadata som PDF Link. Tittelen vises som ren tekst (maks 256 tegn); innholdet vises som GitHub-flavored markdown.

  5. 5

    Forlatte innsendinger (valgfritt)

    Velg et inaktivitetsvindu og skriv en egen tittel og innhold for utkast ingen fullførte. La den stå på Av for å hoppe over. Krever Pro eller Business.

  6. 6

    Fullfør

    Send test oppretter en ekte sak med prefiks [Test] i det valgte depotet — lukk eller slett den etterpå. Trykk deretter Opprett integrasjon, så oppretter hver innsending en GitHub-sak.

Avbrutte svar-hendelser

Når en respondent starter skjemaet ditt men ikke fullfører, kan formbase opprette en separat sak for de delvise dataene. Sett Send hendelse for forlatt etter til 12 timer, 1 dag, 3 dager eller 1 uke, og fyll deretter inn tittel og innhold for den avbrutte saken — ingen av delene kan stå tomme. Avbrutte saker får etiketten partial-submission, opprettet ved første bruk.

En times-sveip leter etter inaktive utkast, så saken dukker opp ved første sveip etter at vinduet er passert. Bare utkast fra en delelenke sveipes, og Obligatoriske felter avgrenser det ytterligere: saken opprettes bare når minst ett av feltene du velger, ble fylt ut.

Pro-funksjon

Levering av avbrutte svar krever en Pro- eller Business-plan. Kjerneintegrasjonen med GitHub Issues er tilgjengelig på alle planer. Se planer og priser.

Tokens

GitHub OAuth App-tokens utløper ikke — det er ingen rotasjon av oppdateringstoken. Hvis du tilbakekaller tilgangen fra din GitHub-kontos side for autoriserte OAuth-apper, vil neste utsending mislykkes, formbase markerer legitimasjonen som utløpt, og du mottar en varslingsmelding på e-post. Koble til på nytt fra arbeidsområdets Integrasjoner-side for å gjenopprette tilgangen.

Fjerne integrasjonen

  • Fra formbase — Skjemainnstillinger → Integrasjoner → GitHub Issues → Slett. Nye innsendinger slutter å opprette saker umiddelbart.

  • Fra GitHub — Tilbakekall OAuth-tilgangen fra kontoens side for autoriserte OAuth-apper. formbase tilbakekaller ikke tokenet automatisk på sin side.

Begrensninger og atferd

  • Én sak per innsending — ingen modus for å kommentere på eksisterende saker
  • Ingen tilbakefylling — kun nye innsendinger oppretter saker
  • Tittelen er ren tekst, avkortet med en ellipse etter 256 tegn; innholdet er kun markdown
  • En tom tittel faller tilbake til New submission to <form name>

  • Filopplastingssvar vises som filnavnet etterfulgt av nedlastingslenken, slik at filen er tilgjengelig fra saken
  • Respondentsvar settes inn i issue-teksten som de er — inneholder et svar @brukernavn, varsler GitHub den brukeren, og #123 oppretter en issue-referanse

FAQ

Tre GitHub-tillatelser: repo (opprette saker), read:user (identifisere kontoen din) og read:org (liste opp organisasjonsdepoter). Dette er en standard OAuth-app — ingen GitHub App-installasjon er nødvendig.

Ja. GitHub-tilkoblinger er begrenset til arbeidsområdet. Ethvert arbeidsområdemedlem kan bruke en tilkoblet GitHub-konto når de setter opp en integrasjon.

Ja. Åpne integrasjonsdetaljpanelet og endre ett av feltene. Å bytte depot tilbakestiller milepælen siden milepæler er depotspesifikke.

Neste innsending mislykkes med en “ikke funnet”-feil og integrasjonen viser en feilstatus. Rediger integrasjonen for å velge et annet depot.

Integrasjonen settes automatisk på pause, og en e-post går til personen som satte den opp. Et tilbakekalt token, en tapt tillatelse eller et slettet depot venter ikke på fem feil — det stopper integrasjonen umiddelbart. Uansett: fiks årsaken og trykk Gjenoppta.

Neste steg