Åpne appen

DokumentasjonWorkflowsHTTP og utviklerverktøy

Linear node

Opprett, list og oppdater Linear-issues direkte fra workflowen din, via Linears offisielle GraphQL-API (ett endepunkt for alt). Se oppsett, input og output, testkjøring og løsning av vanlige feil.

8 min lesetidOppdatert

Hva noden gjør

Opprett, list og oppdater Linear-issues direkte fra workflowen din, via Linears offisielle GraphQL-API (ett endepunkt for alt).

Bruk Linear som et tydelig avgrenset trinn i en anymize-workflow.

  • Behandler 1 input.
  • Gir 1 output til senere trinn.
  • Kjører som et vanlig trinn i flyten.

Sett opp noden

  1. 01Åpne en workflow og legg til Linear fra nodekatalogen.
  2. 02Fyll ut obligatoriske felt og koble verdier fra tidligere trinn.
  3. 03Kjør noden med et lite testdatasett og kontroller outputtet.
  4. 04Koble det vellykkede outputtet og aktiver etter en fullstendig test.

Handlinger og moduser

Velg ønsket funksjon i Handling. Panelet viser deretter de relevante innstillingene.

  • Opprett issue
  • List issues
  • Oppdater issue

Innstillinger

FeltBetydningOmråde
Linear API-nøkkelRefererer kun til navnet på workflow-secreten, selve nøkkelen løses trygt først ved kjøring. Opprett nøkkelen under Linear → Settings → Security & access → Personal API keys.Beskyttet
HandlingValg: Opprett issue, List issues, Oppdater issueStandard
Team-IDLinear team-ID-en (UUID). Valgfritt filter ved "List issues", påkrevd ved "Opprett issue".Standard
TittelTittel på issuet.Standard
BeskrivelseValgfri beskrivelse (Markdown støttes).Standard
Maks antallHvor mange issues som lastes maks (standard 50, maks 250).Standard
Issue-IDID-en eller identifikatoren (f.eks. ENG-123) til issuet som skal oppdateres.Standard
TittelTittel på issuet.Standard
BeskrivelseValgfri beskrivelse (Markdown støttes).Standard
Status-IDValgfritt, ID-en til den nye issue-statusen (workflow state). Lar statusen være uendret hvis tom.Standard
Kjør én gang per elementAv (standard): noden kjører én gang for hele inputet. På: får den flere elementer (for eksempel fra «Del opp liste»), kjører den én gang PER element, og {{ $json }} er da nettopp dette elementet. Slik jobber du deg gjennom en filliste post for post.Standard
Hvis et element feiler«Hopp over» skriver et `error`-felt for elementet som feilet og fortsetter med resten, i stedet for å miste hele kjøringen på én uleselig fil.Standard
Pause mellom elementer (millisekunder)Ventetid før hver kjøring bortsett fra den første. 1000 = 1 sekund per element. Nyttig hvis motparten ellers struper deg. Maksimalt 300000 (5 minutter).Standard

Input og output

InputBetydningType
StandardMottar hele resultatet fra forrige trinn.JSON
OutputBetydningType
StandardGjør resultatet tilgjengelig som JSON for neste trinn.JSON

Noden kan behandle lister element for element. Feilhåndtering og pause finnes under avanserte innstillinger.

Eksempel og testkjøring

Opprett en feilrapport som Linear-issue: start med et lite og gjenkjennelig datasett. Kontroller outputtet og bruk bare felt som faktisk finnes.

Eksempel på testkjøring

{
  "action": "create_issue",
  "team_id": "team-eng",
  "title": "Checkout wirft 500 bei Rabattcode",
  "description": "Reproduziert mit Code SUMMER10 im Staging. Stacktrace im Anhang."
}

Tilgang og sikkerhet

Før aktivering bør du kontrollere hvilke data som går inn i trinnet og hva outputtet inneholder.

Lagre nøkler og påloggingsdata i den beskyttede tilkoblingsadministrasjonen. Ikke lim dem inn i vanlige felt, testdata eller beskrivelser.

Løs vanlige feil

  • Ingen output: kontroller siste kjøring og feltene fra forrige node.
  • Tom variabel: åpne outputtet fra forrige trinn og bruk et felt fra de faktiske testdataene.
  • Listen behandles bare én gang: aktiver kjøring per element.

Relaterte artikler