Linear-issues aanmaken vanuit workflows
Open vanuit een workflow een Linear-issue — in het team dat je kiest, met een prioriteit — en laat de actie in Polzy zichzelf sluiten zodra het issue klaar is. Koppel Linear één keer met een persoonlijke API-sleutel.
Op deze pagina
Als feedback je product- of ontwikkelteam nodig heeft, kan een workflow er een Linear-issue voor openen — in het team dat je kiest, met een titel, een beschrijving en een prioriteit op basis van wat Polzy weet. Heeft de workflow ook een actie in Polzy aangemaakt, dan volgt die actie het issue en sluit ze zichzelf zodra het issue klaar of geannuleerd is. Aan het eind van deze handleiding heb je Linear gekoppeld en een workflow die issues opent.
Linear hoort bij Business en wordt vanuit workflows gebruikt. Alleen een Beheerder kan het koppelen en workflows bouwen.
Voordat je begint
Je hebt nodig:
- Een werkruimte op Business, en de rol Beheerder daarin.
- Integraties en Workflows aangezet voor de werkruimte, onder Instellingen → Algemeen → Wat deze werkruimte doet.
- Een Linear-account dat issues mag aanmaken in de teams die je gaat gebruiken. Issues worden als dit account aangemaakt, dus een apart account voorkomt dat ze aan één persoon hangen.
- Een persoonlijke API-sleutel voor dat account (hieronder).
Een persoonlijke API-sleutel maken
- Open in Linear Settings → Account → Security & access.
- Kies onder Personal API keys New key en noem hem Polzy.
- Geef hem volledige toegang, of minstens toestemming om issues te lezen en aan te maken, en toegang tot de teams die Polzy moet bereiken.
- Kopieer de sleutel. Die begint met
lin_api_.
Laat Linear je geen sleutel maken, dan heeft een Linear-beheerder sleutels voor leden misschien uitgezet onder Settings → Administration → API. Linear legt sleutels uit in Linear: API and webhooks.
Linear aan Polzy koppelen
- Open in de zijbalk onder Automatiseren de pagina Integraties en kies het tabblad Beschikbaar.
- Zoek Linear en kies Verbinden.
- Plak de sleutel bij Persoonlijke API-sleutel.
- Kies Verbinding testen. Polzy antwoordt Connected as met de naam van het account.
- Kies Verbinden.
De sleutel wordt versleuteld opgeslagen. Na het koppelen biedt de rij van Linear onder Integraties Bereik instellen om de sleutel te vervangen, en Beheren voor de pagina ervan.
Een issue openen vanuit een workflow
- Open Workflows en de workflow, of begin een nieuwe.
- Sleep onder Connectors in Geïnstalleerde stappen de stap Linear-issue aanmaken · Linear naar het canvas, na de stap waarop hij moet volgen. Een rij met een slotje betekent dat Linear nog niet gekoppeld is of aandacht vereist.
- Kies onder Team het team. De lijst toont elk team dat de sleutel kan zien, met naam en sleutel.
- Schrijf de Titel, tot 255 tekens. Typ
{{om een waarde uit de run in te voegen, zoals de titel van de actie. - Schrijf desgewenst een Beschrijving.
- Kies een Prioriteit: Geen prioriteit, Urgent, Hoog, Gemiddeld of Laag.
De stap geeft de identificatie van het issue, zoals CS-142, door als {{connector.issueKey}} en het adres als {{connector.url}}. Een Testrun doorloopt de workflow zonder het issue te openen; alleen een echte run maakt er een aan. Workflows legt triggers en stappen uit.
De actie sluiten zodra het issue klaar is
Loopt Linear-issue aanmaken na Actiepunt aanmaken in dezelfde run van de workflow, dan wordt het issue aan die actie gekoppeld:
- Gevolgd in. Het paneel van de actie toont de identificatie van het issue, met een link naar Linear, en de status die Linear het laatst meldde.
- Gesloten door Linear. Polzy vraagt Linear hooguit elke 10 minuten naar het issue. Is het afgerond — of geannuleerd, want het werk gebeurt daar dan niet — dan gaat de actie naar Klaar.
- Alleen de status. Opmerkingen en andere wijzigingen blijven in Linear. Een actie die eerst in Polzy wordt gesloten, wordt niet meer nagevraagd.
Wat Polzy naar Linear stuurt
Alleen wat de stap zegt: het team, de titel, de beschrijving en de prioriteit, met de waarden die je invoegt. Verder verlaat niets over het antwoord of de persoon Polzy. Een anoniem antwoord heeft geen persoon, dus waarden zoals het e-mailadres van de respondent zijn leeg; wat iemand schreef, wordt pas verstuurd als het op veiligheid is gecontroleerd. Losse antwoorden worden niet tegengehouden door de minimale groepsgrootte, dus denk na over wie de issues van het team kan lezen voordat je de eigen woorden van mensen in een issue zet.
Problemen oplossen
- Linear refused the credentials (401). De sleutel is fout of ingetrokken. Maak een nieuwe, kies Bereik instellen in de rij van Linear onder Integraties, plak hem en kies Opslaan. Een run die hierop stuit, zet Linear op Vereist aandacht.
- Linear: gevolgd door de eigen woorden van Linear (in een run). Linear weigerde het verzoek — vaak omdat de sleutel geen toegang heeft tot dat team of geen issues mag aanmaken. Controleer de rechten van de sleutel.
- Linear did not create the issue. Linear antwoordde zonder issue. Draai de workflow opnieuw; gebeurt het steeds, controleer dan of het team nog bestaat.
- This step names no team of The issue has no title. Vul Team en Titel van de stap in.
- De lijst Team is een gewoon vak. De sleutel ziet geen teams, of Linear was niet bereikbaar.
- De actie sluit niet. De Linear-stap liep niet na Actiepunt aanmaken in dezelfde run, het issue is niet afgerond of geannuleerd, of de koppeling vereist aandacht — de controles pauzeren tot dat is opgelost.
Goed om te weten
- Eén koppeling, elk team. Elke stap kiest zijn team uit wat de sleutel kan zien.
- Wie is de maker? Het account waar de sleutel bij hoort.
- Kan een stap hetzelfde issue twee keer openen? Nee. Een stap die na een crash opnieuw draait, gebruikt wat hij de eerste keer aanmaakte.
Handige links
Gerelateerde artikelen
Ingelogde leden kunnen het Polzy vragen of het team een bericht sturen via Support. Hoe snel we antwoorden, hangt af van je abonnement.