Azure Boards koppelen: stapsgewijze handleiding
Maakt één werkitem aan per mislukte test, plaatst er een opmerking bij als de test opnieuw mislukt en stelt de status in op voltooid wanneer de test zonder problemen slaagt. Hetzelfde token publiceert ook testresultaten en zet pijplijnen in de wachtrij. Deze handleiding begeleidt je vanaf het begin tot een gecontroleerde verbinding en beschrijft mogelijke fouten 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 Azure DevOps Services-organisatie: https://dev.azure.com/<organization> of https://<organization>.visualstudio.com (Azure DevOps Server op je eigen machines wordt niet ondersteund).
- De naam van het project waarin de werkitems terechtkomen.
- Een persoonlijk toegangstoken (PAT) met Werkitems → Lezen & schrijven, en Build → Lezen & uitvoeren als je ook Uitvoeren in CI gebruikt.
- Kennis van het proces van je project, want dat bepaalt het werkitemtype: Basic heeft Issue, Epic en Task (geen Bug); Agile, Scrum en CMMI hebben Bug.
De toegangsgegevens verkrijgen
- Open dev.azure.com en ga naar Gebruikersinstellingen → Persoonlijke toegangstokens → Nieuw token.
- Kies je organisatie, stel een vervaldatum in en kies onder Bereiken voor Aangepast gedefinieerd.
- Vink Werkitems → Lezen & schrijven aan (voeg Build → Lezen & uitvoeren toe voor Uitvoeren in CI), maak het token aan en kopieer het meteen. Het wordt maar één keer getoond.
- Bewaar het op je klembord. Plak het nergens anders dan in de Studio (volgende stap).
Koppelen in de Studio
- Open in de Studio Instellingen → Integraties → Azure DevOps koppelen.
- Plak een willekeurige link uit Azure DevOps (een bord, een werkitem of de projectpagina) en klik op Verbinding controleren. De Studio bewaart de organisatie en het project.
- Voer het PAT in wanneer daarom wordt gevraagd en klik op Opslaan & controleren. Kies het project bij "Werkitems gaan naar".
- Als de controle aangeeft dat het project geen werkitemtype met de naam Bug heeft, stel je
AZURE_BOARDS_WORK_ITEM_TYPEin op een van de vermelde typen (in een Basic-project: Issue) enAZURE_BOARDS_DONE_STATEop een status die dat proces heeft (Basic: Done). - Schakel
AZURE_BOARDS_ENABLEDin.
Controleren of het werkt
- Verbinding controleren toont "Het token heeft toegang tot N projecten" en "<project> accepteert werkitems van het type <type>". De controle leest alleen gegevens; er wordt nooit een werkitem aangemaakt.
- Open Instellingen → Integraties → Tickets en klik op Testticket aanmaken. Er wordt één werkitem aangemaakt met de tag nexus-test en een schermafbeelding als bijlage.
- Open het in Azure Boards, controleer de tag en de bijlage en verwijder het wanneer je klaar bent.
Veelvoorkomende fouten
| Wat je ziet | Oorzaak | Oplossing |
|---|---|---|
| "Azure DevOps heeft het token geweigerd" (HTTP 203 of 401) | Het PAT is onjuist, verlopen, ingetrokken, onvolledig gekopieerd of aangemaakt in een andere organisatie. | Maak een nieuw PAT aan in dezelfde organisatie als AZURE_DEVOPS_ORG_URL met Werkitems → Lezen & schrijven en sla het opnieuw op. |
| HTTP 403 | Het PAT is geldig, maar mist een machtigingsbereik, of je gebruikersaccount heeft geen rechten in dat project. | Wijzig de machtigingsbereiken van het PAT (Werkitems → Lezen & schrijven; Build → Lezen & uitvoeren voor Uitvoeren in CI) of vraag de projectbeheerder om toegang. |
| HTTP 404 | De organisatie of de projectnaam bestaat niet, of het project heeft een andere naam gekregen. | Plak een link uit het juiste project en kies het uit de lijst. |
| VS402323 "Werkitemtype Bug bestaat niet" | Het proces van het project heeft geen werkitemtype met die naam. Een Basic-project heeft Issue, Epic en Task, maar geen Bug. | Stel AZURE_BOARDS_WORK_ITEM_TYPE in op een type dat de controle vermeldt (Basic: Issue) en AZURE_BOARDS_DONE_STATE op een van de bijbehorende statussen (Basic: Done) en klik vervolgens opnieuw op Verbinding controleren. |
| "<project> heeft geen werkitemtype met de naam …" | Dezelfde oorzaak als VS402323, vastgesteld door Verbinding controleren voordat er iets wordt aangemaakt. | Stel AZURE_BOARDS_WORK_ITEM_TYPE in op een van de typen in dat bericht, of kies een ander project. |
| "Dat is geen Azure DevOps-link" | Het adres staat niet op dev.azure.com/<organization> of <organization>.visualstudio.com, of begint met http://. | Kopieer het adres uit de adresbalk van Azure DevOps Services. Azure DevOps Server wordt niet ondersteund. |
| "kon Azure DevOps niet bereiken (…)" of "antwoordde niet binnen 20 s" | Deze pc kan Azure DevOps niet bereiken: een VPN of proxy, of geen netwerkverbinding. | Open dev.azure.com in een browser op dezelfde pc en controleer de verbinding opnieuw. |
| Een geslaagde test stelt de status niet in op voltooid | Het proces weigert AZURE_BOARDS_DONE_STATE voor dat type, waardoor het item alleen de opmerking krijgt. | Stel AZURE_BOARDS_DONE_STATE in op een status van dat type (Basic: Done; Agile-bug: Resolved). |
| Alles klopt, maar er verschijnt geen werkitem | AZURE_BOARDS_ENABLED is false; of het oordeel was FLAKY of een omgevingsoordeel; of het was een sandbox-uitvoering; of de test heeft al een openstaand werkitem (bij een herhaalde fout wordt in plaats daarvan een opmerking toegevoegd). | Schakel AZURE_BOARDS_ENABLED in en gebruik Testticket aanmaken om de verbinding te verifiëren. |
Instellingssleutels
| Sleutel | Wat het doet | Geldige waarde | Zo controleert u dit |
|---|---|---|---|
AZURE_BOARDS_ENABLED | Azure-werkitems aanmaken voor fouten | true of false | Schakel dit in nadat Verbinding controleren is geslaagd en voer vervolgens Testticket aanmaken uit. |
AZURE_DEVOPS_ORG_URL | Adres van de Azure DevOps-organisatie | https://dev.azure.com/<organization> of https://<organization>.visualstudio.com | Verbinding controleren toont de organisatie; een geplakte link vult deze in. |
AZURE_DEVOPS_PROJECT | Azure DevOps-projectnaam | De projectnaam, precies zoals Azure DevOps deze weergeeft | Verbinding controleren toont de projecten waartoe het token toegang heeft. |
AZURE_DEVOPS_PAT | Azure DevOps-toegangstoken (geheim, alleen op deze computer opgeslagen) | Eén regel, geen aanhalingstekens, geen spaties | Verbinding controleren: "token geweigerd" betekent dat het onjuist of verlopen is, of bij een andere organisatie hoort. |
AZURE_BOARDS_WORK_ITEM_TYPE | Azure-tickettype voor fouten | Een type dat het projectproces bevat: Bug (Agile, Scrum, CMMI) of Issue (Basic) | Verbinding controleren meldt "<project> accepteert werkitems van het type <type>" of toont de typen die het project bevat. |
AZURE_BOARDS_DONE_STATE | Azure-status wanneer de test slaagt | Een status van dat werkitemtype: Resolved (Agile-bug), Done (Basic-issue) | Een volledig geslaagde test wijzigt de status van het item; als het proces de status weigert, krijgt het alleen een opmerking. |
AZURE_PIPELINE_ID | Azure-pijplijn om in CI uit te voeren | De numerieke ID van een Azure-pijplijn (alleen voor Uitvoeren in CI) | nexus ci-remote --provider=azure plaatst die pijplijn in de wachtrij; vereist Build → Lezen & uitvoeren. |
Meer: alle integraties, de instellingenhandleiding, problemen oplossen. Andere handleidingen: Jira Cloud, 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.