Jira Cloud verbinden: Schritt-für-Schritt-Anleitung
Erstellt für jeden fehlgeschlagenen Test ein Bug-Ticket, kommentiert es bei erneutem Fehlschlagen und setzt es auf Erledigt, sobald der Test fehlerfrei durchläuft. Diese Anleitung führt Sie von der Ersteinrichtung bis zur geprüften Verbindung und nennt mögliche Fehler samt Ursache und Lösung.
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 Jira Cloud-Website, zum Beispiel https://your-team.atlassian.net (nur Jira Cloud; die Adresse muss https verwenden).
- Die E-Mail-Adresse Ihres Atlassian-Kontos und ein mit demselben Konto erstelltes API-Token.
- Einen Projektschlüssel, zum Beispiel QA, dessen Projekt einen Vorgangstyp namens Bug hat.
- Für dieses Konto im betreffenden Projekt die Berechtigungen zum Durchsuchen, Erstellen von Vorgängen, Hinzufügen von Kommentaren, Erstellen von Anhängen und Ändern des Vorgangsstatus.
Zugangsdaten beschaffen
- Öffnen Sie https://id.atlassian.com/manage-profile/security/api-tokens und wählen Sie API-Token erstellen.
- Vergeben Sie einen Namen (zum Beispiel "Nexus StudioQA"), wählen Sie ein Ablaufdatum, erstellen Sie das Token und kopieren Sie es sofort. Atlassian zeigt es nur einmal an.
- 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 → Jira verbinden.
- Fügen Sie einen beliebigen Link aus Ihrem Jira ein (Startseite, Board oder Vorgang) und klicken Sie auf Verbindung prüfen. Das Studio übernimmt die Website-Adresse und den Projektschlüssel.
- Geben Sie bei Aufforderung Ihre Atlassian-E-Mail-Adresse und das Token ein und klicken Sie auf Speichern & prüfen.
- Wählen Sie unter "Bugs gehen an" das Projekt aus und aktivieren Sie dann
JIRA_ENABLED.
Funktion überprüfen
- Verbindung prüfen zeigt "Angemeldet als <your name>" und "<KEY> akzeptiert Bug-Tickets" an. Die Prüfung liest nur Daten; sie erstellt niemals ein Ticket.
- Öffnen Sie Einstellungen → Integrationen → Tickets und klicken Sie auf Testticket erstellen. Dadurch wird ein Ticket mit dem Label nexus-test erstellt. Dies ist dort der einzige Klick, der Jira aufruft.
- Öffnen Sie dieses Ticket in Jira und prüfen Sie, ob es die Labels auto-generated, nexus-studioqa-automation und nexus-test hat. Löschen Sie es anschließend.
Häufige Fehler
| Was Sie sehen | Ursache | Lösung |
|---|---|---|
| "Das ist kein Link" oder "Ein Jira-Link beginnt mit https://" | Der eingefügte Text ist keine vollständige Webadresse oder beginnt mit http://. | Kopieren Sie die Adresse aus der Adressleiste, während Sie sich auf Ihrer Jira-Website befinden. Sie muss mit https:// beginnen. |
| HTTP 401 | Die E-Mail-Adresse oder das Token ist falsch, das Token ist abgelaufen oder wurde widerrufen, oder die E-Mail-Adresse gehört nicht zu dem Konto, mit dem das Token erstellt wurde. | Erstellen Sie unter id.atlassian.com mit dem Konto, dessen E-Mail-Adresse Sie gespeichert haben, ein neues Token. Speichern Sie anschließend beides erneut unter Einstellungen. |
| HTTP 403 | Die Anmeldung funktioniert, aber laut Jira darf dieses Konto die Aktion nicht ausführen: Meist fehlt im Projekt die Berechtigung zum Erstellen von Vorgängen, Hinzufügen von Kommentaren oder Erstellen von Anhängen. | Bitten Sie den Projektadministrator um diese Berechtigungen oder wählen Sie ein anderes Projekt. Nexus StudioQA kann sie nicht erteilen. |
| HTTP 404 | Die Website-Adresse oder der Projektschlüssel existiert nicht, oder das Konto kann das Projekt nicht sehen (Jira antwortet bei ausgeblendeten Projekten mit 404). | Fügen Sie einen beliebigen Link von der richtigen Website ein und wählen Sie das Projekt aus der Liste aus. |
| "Diese Adresse hat geantwortet, aber nicht mit einem Jira-Konto" | Die Adresse gehört nicht zu einer Jira Cloud-Website (zum Beispiel eine Server- oder Data Center-Adresse oder eine andere Webseite). | Verwenden Sie die Adresse https://<team>.atlassian.net Ihrer Jira Cloud-Website. |
| "<KEY> hat keinen Vorgangstyp namens Bug" | Das Projekt hat keinen Vorgangstyp namens Bug, daher kann kein Ticket erstellt werden. | Öffnen Sie in Jira Projekteinstellungen → Vorgangstypen und fügen Sie Bug hinzu, oder wählen Sie ein anderes Projekt. |
| "Jira konnte nicht erreicht werden (ENOTFOUND)" oder "hat nicht innerhalb von 20 s geantwortet" | Dieser PC kann die Website nicht erreichen: ein Tippfehler in der Adresse, ein VPN oder Proxy oder keine Netzwerkverbindung. | Korrigieren Sie die Adresse und öffnen Sie die Website dann in einem Browser auf demselben PC. Wiederholen Sie die Prüfung. |
| Alle Prüfungen sind erfolgreich, aber es erscheint kein Ticket | JIRA_ENABLED ist false; oder das Ergebnis war FLAKY oder ein Umgebungsergebnis; oder es war ein Sandbox-Durchlauf; oder für diesen Test existiert bereits ein offener Bug (bei erneutem Fehlschlagen wird stattdessen ein Kommentar hinzugefügt); oder in den letzten 24 Stunden wurde ein Bug mit demselben Titel erstellt. | Aktivieren Sie JIRA_ENABLED, lesen Sie "Ein Vorgang pro Test" auf der Integrationsseite und verwenden Sie Testticket erstellen, um die Verbindung zu überprüfen. |
| Ein bestandener Test schließt sein Ticket nicht | Der Workflow hat keinen Übergang mit dem in JIRA_DONE_TRANSITION angegebenen Namen, daher erhält das Ticket nur den Kommentar. | Setzen Sie JIRA_DONE_TRANSITION auf den genauen Namen der Übergangsschaltfläche in Ihrem Workflow. |
Konfigurationsschlüssel
| Schlüssel | Funktionsumfang | Gültiger Wert | So prüfen Sie ihn |
|---|---|---|---|
JIRA_ENABLED | Jira-Tickets für fehlgeschlagene Tests erstellen | true oder false | Aktivieren Sie die Integration und führen Sie dann Testticket erstellen aus. |
JIRA_BASE_URL | Jira-Website-Adresse | https://<site>.atlassian.net | Verbindung prüfen zeigt die Website an; ein eingefügter Link füllt das Feld aus. |
JIRA_EMAIL | E-Mail-Adresse für die Jira-Anmeldung | Die E-Mail-Adresse des Atlassian-Kontos, dem das Token gehört | Verbindung prüfen zeigt "Angemeldet als …" mit dieser E-Mail-Adresse an. |
JIRA_API_TOKEN | Jira-Zugriffstoken (geheim, nur auf diesem Computer gespeichert) | Eine Zeile, keine Anführungszeichen, keine Leerzeichen | Verbindung prüfen: HTTP 401 bedeutet, dass die Kombination aus E-Mail-Adresse und Token falsch ist. |
JIRA_PROJECT_KEY | Jira-Projekt für Bug-Tickets | Der Projektschlüssel, normalerweise in Großbuchstaben, zum Beispiel QA | Die Projektauswahlliste enthält das Projekt; "akzeptiert Bug-Tickets" bestätigt den Typ. |
JIRA_DONE_TRANSITION | Jira-Status bei bestandenem Test | Der genaue Name eines Workflow-Übergangs, ohne Berücksichtigung der Groß- und Kleinschreibung | Ein eindeutig bestandener Test ändert den Ticketstatus; wenn der Workflow keinen solchen Übergang hat, erhält das Ticket nur einen Kommentar. |
Mehr: alle Integrationen, die Einstellungsanleitung, Fehlerbehebung. Weitere Anleitungen: Azure Boards, 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.