Azure Boards verbinden: Schritt-für-Schritt-Anleitung
Erstellt für jeden fehlgeschlagenen Test ein Arbeitselement, kommentiert es bei erneutem Fehlschlagen und setzt es auf einen abgeschlossenen Status, sobald der Test fehlerfrei durchläuft. Dasselbe Token veröffentlicht auch Testergebnisse und reiht Pipelines zur Ausführung ein. Diese Anleitung führt Sie von den ersten Schritten bis zur überprüften Verbindung und beschreibt mögliche Fehler mit ihren Ursachen und Lösungen.
Zuletzt aktualisiert:
Halten Sie Ihre Zugangsdaten geheim. Fügen Sie niemals ein Token, einen Schlüssel, ein Passwort oder eine Webhook-URL in einen Chat ein. Geben Sie diese ausschließlich unter Studio → Einstellungen → Integrationen ein. Dort werden sie in der .env-Datei Ihres Arbeitsbereichs gespeichert und als Punkte angezeigt. Das gilt auch für KI-Assistenten: Sie können Sie durch diese Anleitung führen, benötigen aber niemals Ihr Token.
Was Sie benötigen
- Eine Azure DevOps Services-Organisation: https://dev.azure.com/<organization> oder https://<organization>.visualstudio.com (Azure DevOps Server auf Ihren eigenen Rechnern wird nicht unterstützt).
- Den Namen des Projekts, in dem die Arbeitselemente erstellt werden sollen.
- Ein persönliches Zugriffstoken (PAT) mit Arbeitselemente → Lesen & Schreiben sowie Build → Lesen & Ausführen, wenn Sie auch In CI ausführen verwenden.
- Kenntnis des Prozesses Ihres Projekts, da dieser den Arbeitselementtyp bestimmt: Basic bietet Issue, Epic und Task (kein Bug); Agile, Scrum und CMMI bieten Bug.
Zugangsdaten beschaffen
- Öffnen Sie dev.azure.com und anschließend Benutzereinstellungen → Persönliche Zugriffstoken → Neues Token.
- Wählen Sie Ihre Organisation, legen Sie ein Ablaufdatum fest und wählen Sie unter Bereiche die Option Benutzerdefiniert.
- Aktivieren Sie Arbeitselemente → Lesen & Schreiben (ergänzen Sie Build → Lesen & Ausführen für In CI ausführen), erstellen Sie das Token und kopieren Sie es sofort. Es wird nur einmal angezeigt.
- Behalten Sie es in der Zwischenablage. Fügen Sie es ausschließlich im Studio ein (nächster Schritt).
Im Studio verbinden
- Öffnen Sie im Studio Einstellungen → Integrationen → Azure DevOps verbinden.
- Fügen Sie einen beliebigen Link aus Azure DevOps ein (ein Board, ein Arbeitselement oder die Projektseite) und klicken Sie auf Verbindung prüfen. Das Studio übernimmt die Organisation und das Projekt.
- Geben Sie bei Aufforderung das PAT ein und klicken Sie auf Speichern & prüfen. Wählen Sie das Projekt unter "Zielprojekt für Arbeitselemente" aus.
- Wenn die Prüfung meldet, dass das Projekt keinen Arbeitselementtyp namens Bug hat, setzen Sie
AZURE_BOARDS_WORK_ITEM_TYPEauf einen der aufgeführten Typen (bei einem Basic-Projekt: Issue) undAZURE_BOARDS_DONE_STATEauf einen Status dieses Prozesses (Basic: Done). - Aktivieren Sie
AZURE_BOARDS_ENABLED.
Funktion überprüfen
- Verbindung prüfen zeigt "Das Token hat Zugriff auf N Projekte" und "<project> unterstützt Arbeitselemente vom Typ <type>" an. Die Prüfung liest nur Daten; sie erstellt niemals ein Arbeitselement.
- Öffnen Sie Einstellungen → Integrationen → Tickets und klicken Sie auf Testticket erstellen. Dadurch wird ein Arbeitselement mit dem Tag nexus-test und einem angehängten Bildschirmfoto erstellt.
- Öffnen Sie es in Azure Boards, überprüfen Sie das Tag und den Anhang und löschen Sie es anschließend.
Häufige Fehler
| Was Sie sehen | Ursache | Lösung |
|---|---|---|
| "Azure DevOps hat das Token abgelehnt" (HTTP 203 oder 401) | Das PAT ist falsch, abgelaufen, widerrufen, unvollständig kopiert oder wurde in einer anderen Organisation erstellt. | Erstellen Sie ein neues PAT in derselben Organisation wie AZURE_DEVOPS_ORG_URL mit Arbeitselemente → Lesen & Schreiben und speichern Sie es erneut. |
| HTTP 403 | Das PAT ist gültig, aber ihm fehlt ein Berechtigungsbereich, oder Ihr Benutzerkonto hat keine Berechtigung für dieses Projekt. | Bearbeiten Sie die Berechtigungsbereiche des PAT (Arbeitselemente → Lesen & Schreiben; Build → Lesen & Ausführen für In CI ausführen) oder bitten Sie die Projektadministration um Zugriff. |
| HTTP 404 | Die Organisation oder der Projektname existiert nicht, oder das Projekt wurde umbenannt. | Fügen Sie einen Link aus dem richtigen Projekt ein und wählen Sie es aus der Liste aus. |
| VS402323 "Arbeitselementtyp Bug existiert nicht" | Der Prozess des Projekts hat keinen Arbeitselementtyp mit diesem Namen. Ein Basic-Projekt bietet Issue, Epic und Task, aber keinen Bug. | Setzen Sie AZURE_BOARDS_WORK_ITEM_TYPE auf einen bei der Prüfung aufgeführten Typ (Basic: Issue) und AZURE_BOARDS_DONE_STATE auf einen seiner Status (Basic: Done). Klicken Sie anschließend erneut auf Verbindung prüfen. |
| "<project> hat keinen Arbeitselementtyp namens …" | Dieselbe Ursache wie bei VS402323, erkannt durch Verbindung prüfen, bevor etwas angelegt wird. | Setzen Sie AZURE_BOARDS_WORK_ITEM_TYPE auf einen der in dieser Meldung aufgeführten Typen, oder wählen Sie ein anderes Projekt. |
| "Das ist kein Azure DevOps-Link" | Die Adresse liegt nicht unter dev.azure.com/<organization> oder <organization>.visualstudio.com, oder sie beginnt mit http://. | Kopieren Sie die Adresse aus der Adressleiste von Azure DevOps Services. Azure DevOps Server wird nicht unterstützt. |
| "Azure DevOps konnte nicht erreicht werden (…)" oder "hat nicht innerhalb von 20 s geantwortet" | Dieser PC kann Azure DevOps nicht erreichen: wegen eines VPNs oder Proxys oder einer fehlenden Netzwerkverbindung. | Öffnen Sie dev.azure.com in einem Browser auf demselben PC, und wiederholen Sie dann die Prüfung. |
| Ein bestandener Test setzt den Status nicht auf erledigt | Der Prozess lehnt AZURE_BOARDS_DONE_STATE für diesen Typ ab, daher erhält das Arbeitselement nur den Kommentar. | Setzen Sie AZURE_BOARDS_DONE_STATE auf einen Status dieses Typs (Basic: Done; Agile-Fehler: Resolved). |
| Alle Prüfungen sind erfolgreich, aber es erscheint kein Arbeitselement | AZURE_BOARDS_ENABLED ist false; oder das Ergebnis war FLAKY oder umgebungsbedingt; oder es war ein Sandbox-Durchlauf; oder der Test hat bereits ein offenes Arbeitselement (bei einem erneuten Fehlschlag wird stattdessen ein Kommentar hinzugefügt). | Aktivieren Sie AZURE_BOARDS_ENABLED, und verwenden Sie Testticket erstellen, um die Verbindung zu überprüfen. |
Konfigurationsschlüssel
| Schlüssel | Funktionsumfang | Gültiger Wert | So prüfen Sie ihn |
|---|---|---|---|
AZURE_BOARDS_ENABLED | Azure-Arbeitselemente bei Fehlschlägen erstellen | true oder false | Aktivieren Sie die Option nach erfolgreicher Prüfung mit Verbindung prüfen, und führen Sie dann Testticket erstellen aus. |
AZURE_DEVOPS_ORG_URL | Adresse der Azure DevOps-Organisation | https://dev.azure.com/<organization> oder https://<organization>.visualstudio.com | Verbindung prüfen zeigt die Organisation an; ein eingefügter Link trägt sie ein. |
AZURE_DEVOPS_PROJECT | Azure DevOps-Projektname | Der Projektname, genau wie in Azure DevOps angezeigt | Verbindung prüfen listet die Projekte auf, auf die das Token Zugriff hat. |
AZURE_DEVOPS_PAT | Azure DevOps-Zugriffstoken (geheim, nur auf diesem Computer gespeichert) | Eine Zeile, keine Anführungszeichen, keine Leerzeichen | Verbindung prüfen: "Token abgelehnt" bedeutet, dass es falsch oder abgelaufen ist oder aus einer anderen Organisation stammt. |
AZURE_BOARDS_WORK_ITEM_TYPE | Azure-Tickettyp für Fehlschläge | Ein im Prozess des Projekts vorhandener Typ: Bug (Agile, Scrum, CMMI) oder Issue (Basic) | Verbindung prüfen meldet "<project> akzeptiert Arbeitselemente vom Typ <type>" oder listet die im Projekt vorhandenen Typen auf. |
AZURE_BOARDS_DONE_STATE | Azure-Status bei bestandenem Test | Ein Status dieses Arbeitselementtyps: Resolved (Agile-Fehler), Done (Basic-Problem) | Ein eindeutig bestandener Test ändert den Status des Arbeitselements; lehnt der Prozess den Status ab, erhält es nur einen Kommentar. |
AZURE_PIPELINE_ID | In CI auszuführende Azure-Pipeline | Die numerische ID einer Azure-Pipeline (nur für In CI ausführen) | nexus ci-remote --provider=azure reiht diese Pipeline in die Warteschlange ein; erfordert Build → Lesen & ausführen. |
Mehr: alle Integrationen, die Einstellungsanleitung, Fehlerbehebung. Weitere Anleitungen: Jira Cloud, Slack, Microsoft Teams, Telegram, GitHub Issues.
Kommen Sie nicht weiter? Schreiben Sie an [email protected] und geben Sie die genaue Fehlerzeile an, die das Studio anzeigt. Senden Sie kein Token mit.