Jira Cloud koppelen: stapsgewijze handleiding
Maakt één Bug aan per mislukte test, voegt een opmerking toe als de test opnieuw mislukt en zet de Bug op Gereed als de test zonder fouten slaagt. Deze handleiding begeleidt je vanaf het begin tot een geverifieerde verbinding en beschrijft de fouten die je kunt tegenkomen, met hun oorzaak en oplossing.
Laatst bijgewerkt:
Houd je toegangsgegevens privé. Plak nooit een token, sleutel, wachtwoord of webhook-URL in een chat. Voer deze alleen in via Studio → Instellingen → Integraties, waar ze worden opgeslagen in het .env-bestand van je werkruimte en als stippen worden weergegeven. Hetzelfde geldt voor een AI-assistent: die kan je door deze handleiding leiden, maar heeft je token nooit nodig.
Wat je nodig hebt
- Een Jira Cloud-site, bijvoorbeeld https://your-team.atlassian.net (alleen Jira Cloud; het adres moet https gebruiken).
- Het e-mailadres van je Atlassian-account en een API-token dat met datzelfde account is aangemaakt.
- Een projectsleutel, bijvoorbeeld QA, waarvan het project een issuetype met de naam Bug heeft.
- In dat project moet dat account rechten hebben om het project te bekijken, issues aan te maken, opmerkingen toe te voegen, bijlagen aan te maken en de status van issues te wijzigen.
De toegangsgegevens verkrijgen
- Open https://id.atlassian.com/manage-profile/security/api-tokens en kies API-token aanmaken.
- Geef het een naam (bijvoorbeeld "Nexus StudioQA"), kies een vervaldatum, maak het aan en kopieer het token meteen. Atlassian toont het maar één keer.
- Bewaar het op je klembord. Plak het nergens anders dan in de Studio (volgende stap).
Koppelen in de Studio
- Open in Studio Instellingen → Integraties → Jira koppelen.
- Plak een willekeurige link uit je Jira (de startpagina, een bord of een issue) en druk op Verbinding controleren. Studio bewaart het siteadres en de projectsleutel.
- Voer je Atlassian-e-mailadres en het token in wanneer daarom wordt gevraagd en druk op Opslaan & controleren.
- Kies het project bij "Bugs gaan naar" en schakel vervolgens
JIRA_ENABLEDin.
Controleren of het werkt
- Verbinding controleren toont "Aangemeld als <je naam>" en "<KEY> accepteert Bug-tickets". De controle leest alleen gegevens; er wordt nooit een ticket aangemaakt.
- Open Instellingen → Integraties → Tickets en druk op Testticket aanmaken. Hiermee maak je één ticket met het label nexus-test aan. Dit is de enige knop daar die Jira aanroept.
- Open dat ticket in Jira en controleer of het de labels auto-generated, nexus-studioqa-automation en nexus-test heeft. Verwijder het als je klaar bent.
Veelvoorkomende fouten
| Wat je ziet | Oorzaak | Oplossing |
|---|---|---|
| "Dat is geen link" of "Een Jira-link begint met https://" | De geplakte tekst is geen volledig webadres of begint met http://. | Kopieer het adres uit de adresbalk terwijl je op je Jira-site bent. Het moet beginnen met https://. |
| HTTP 401 | Het e-mailadres of het token is onjuist, het token is verlopen of ingetrokken, of het e-mailadres hoort niet bij het account waarmee het token is aangemaakt. | Maak op id.atlassian.com een nieuw token aan met het account waarvan je het e-mailadres hebt opgeslagen en sla beide vervolgens opnieuw op in Instellingen. |
| HTTP 403 | Het aanmelden lukt, maar volgens Jira heeft dat account geen toestemming voor de actie: meestal ontbreekt in het project het recht om issues aan te maken, opmerkingen toe te voegen of bijlagen aan te maken. | Vraag de projectbeheerder om die rechten of kies een ander project. Nexus StudioQA kan ze niet verlenen. |
| HTTP 404 | Het siteadres of de projectsleutel bestaat niet, of dat account heeft geen toegang tot het project (Jira geeft 404 terug voor projecten die het verbergt). | Plak een willekeurige link van de juiste site en kies het project uit de lijst. |
| "Dat adres reageerde, maar niet met een Jira-account" | Het adres is geen Jira Cloud-site (bijvoorbeeld een Server- of Data Center-adres, of een andere webpagina). | Gebruik het adres https://<team>.atlassian.net van je Jira Cloud-site. |
| "<KEY> heeft geen issuetype met de naam Bug" | Het project heeft geen issuetype met de naam Bug, waardoor er geen ticket kan worden aangemaakt. | Open in Jira Projectinstellingen → Issuetypen en voeg Bug toe, of kies een ander project. |
| "kon Jira niet bereiken (ENOTFOUND)" of "reageerde niet binnen 20 s" | Deze pc kan de site niet bereiken: een typefout in het adres, een VPN of proxy, of geen netwerkverbinding. | Corrigeer het adres en open de site vervolgens in een browser op dezelfde pc. Voer de controle opnieuw uit. |
| Alles is in orde, maar er verschijnt geen ticket | JIRA_ENABLED staat op false; of het oordeel was FLAKY of een omgevingsoordeel; of het was een uitvoering in een sandbox; of er bestaat al een open Bug voor die test (bij een herhaalde fout wordt in plaats daarvan een opmerking toegevoegd); of er is in de afgelopen 24 uur een Bug met dezelfde titel aangemaakt. | Schakel JIRA_ENABLED in, lees "Eén issue per test" op de integratiepagina en gebruik Testticket aanmaken om de verbinding te controleren. |
| Een geslaagde test sluit het bijbehorende ticket niet | De workflow heeft geen overgang met de naam die in JIRA_DONE_TRANSITION staat, dus het ticket krijgt alleen de opmerking. | Stel JIRA_DONE_TRANSITION in op de exacte naam van de overgangsknop in je workflow. |
Instellingssleutels
| Sleutel | Wat het doet | Geldige waarde | Zo controleert u dit |
|---|---|---|---|
JIRA_ENABLED | Jira-tickets aanmaken voor fouten | true of false | Schakel de integratie in en voer vervolgens Testticket aanmaken uit. |
JIRA_BASE_URL | Jira-siteadres | https://<site>.atlassian.net | Verbinding controleren toont de site; een geplakte link vult deze in. |
JIRA_EMAIL | E-mailadres voor aanmelden bij Jira | Het e-mailadres van het Atlassian-account waartoe het token behoort | Verbinding controleren toont "Aangemeld als …" met dit e-mailadres. |
JIRA_API_TOKEN | Jira-toegangstoken (geheim, alleen op deze computer opgeslagen) | Eén regel, geen aanhalingstekens, geen spaties | Verbinding controleren: HTTP 401 betekent dat de combinatie van e-mailadres en token onjuist is. |
JIRA_PROJECT_KEY | Jira-project voor Bug-tickets | De projectsleutel, meestal hoofdletters, bijvoorbeeld QA | De keuzelijst met projecten toont het; "accepteert Bug-tickets" bevestigt het type. |
JIRA_DONE_TRANSITION | Jira-status wanneer de test slaagt | De exacte naam van een workflowovergang, niet hoofdlettergevoelig | Een volledig geslaagde test verplaatst het ticket; als de workflow geen dergelijke overgang heeft, krijgt het alleen een opmerking. |
Meer: alle integraties, de instellingenhandleiding, problemen oplossen. Andere handleidingen: Azure Boards, Slack, Microsoft Teams, Telegram, GitHub Issues.
Kom je er nog steeds niet uit? Mail naar [email protected] met de exacte foutregel die Studio toont. Stuur geen token mee.