Je team plant al in een tracker. In plaats van een ticket over te typen in CodeLynq, koppel je de tracker aan een project: een label op een ticket start de taak, en CodeLynq meldt zich terug op het ticket.
Een tracker koppelen kunnen beheerders van de organisatie en de eigenaar van het project.
Hoe het werkt
- Iemand zet het label (standaard
codelynq; in Azure DevOps is het een tag) op een ticket. - CodeLynq maakt een taak in het gekoppelde project op basis van de titel en beschrijving van het ticket, laat in een reactie weten dat het is opgepakt, en schrijft de specificatie.
- De specificatie verschijnt als reactie op het ticket, met de vragen die de technical lead nog heeft.
- Een lid van het project reageert op het ticket:
/codelynq approvekeurt de specificatie goed. Als de koppeling dat toestaat, start de development run meteen, met dezelfde controles als de Run-knop./codelynq feedbackgevolgd door wat er moet veranderen, stuurt dat naar de chat over de specificatie; een bijgewerkte versie volgt op het ticket.
- De link naar de pull request komt op het ticket zodra die openstaat, en een laatste reactie meldt wanneer de taak klaar of mislukt is.
Alleen een reactie die begint met /codelynq is een opdracht. Het e-mailadres van wie reageert moet in de tracker bij een lid van het CodeLynq-project horen; anderen krijgen een reactie met het verzoek CodeLynq te gebruiken.
Een tracker koppelen
Open het project, ga naar Instellingen → Issue trackers en kies Tracker koppelen.
Jira (Cloud)
- URL van je Jira-site:
https://..atlassian.net - E-mailadres en API-token van het Atlassian-account waarmee CodeLynq reageert. Maak de token aan op id.atlassian.com onder Beveiliging → API-tokens.
- Kopieer na het koppelen de webhook-URL (die zie je één keer). Ga in Jira naar Instellingen → Systeem → WebHooks → Create a WebHook, plak hem, en vink Issue created, Issue updated en Comment created aan. Met JQL beperk je hem tot één project.
Linear
- API-sleutel: Settings → Security & access → Personal API keys.
- Kopieer na het koppelen de webhook-URL. Ga in Linear naar Settings → API → Webhooks → New webhook, plak hem, kies het team en vink Issues en Comments aan.
- Plak ook het signing secret van de webhook in CodeLynq: dan weigert CodeLynq elke aanroep die Linear niet heeft ondertekend.
Azure DevOps Boards
- Project-URL:
https://dev.azure.com/./ - Personal access token met de scope Work Items (Read & write).
- Kopieer na het koppelen de webhook-URL. Ga in Azure DevOps naar Project settings → Service hooks → Create subscription → Web Hooks, en maak drie abonnementen met die URL: Work item created, Work item updated en Work item commented on.
Als er geen reacties meer komen
Weigert de tracker een reactie (bijvoorbeeld door een verlopen token), dan toont de koppeling de reden onder Instellingen → Issue trackers, en CodeLynq probeert het elke paar minuten opnieuw. Vervang de token en de gemiste reacties volgen alsnog.
Pauzeer een koppeling om te voorkomen dat nieuwe tickets taken starten; bestaande taken merken daar niets van. Ontkoppelen laat de aangemaakte taken staan.