Integrationen: Jira, Azure DevOps, GitHub Issues, Slack, Teams und Telegram
Nexus StudioQA verbindet sich mit sechs Diensten: Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams und Telegram. Jeder Dienst bleibt deaktiviert, bis Sie ihn aktivieren, und wird direkt von Ihrem Rechner aus angesprochen, niemals über unsere Server. Diese Seite erklärt, was jeder Dienst tut, welche Schlüssel er ausliest und was er niemals tut.
Zuletzt aktualisiert:
Vom Nexus StudioQA-Team, Verdict System LLC. 9. Oktober 2026.
Wie jede Integration funktioniert
- Ausgeschaltet, bis Sie es einschalten. Jeder Dienst hat seinen eigenen Schalter:
JIRA_ENABLED,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLEDundTELEGRAM_ENABLED. Alle stehen standardmäßig auffalse. - Direkt von Ihrem Computer. Die Engine ruft die jeweilige API des Dienstes direkt von dem Rechner auf, der die Tests ausführt. Nichts läuft über unsere Server, und wir sehen Ihre Vorgänge, Benachrichtigungen oder Ergebnisse zu keinem Zeitpunkt.
- Schlüssel verbleiben im Workspace. Token und Schlüssel sind Zeilen in der
.env-Datei des Workspaces auf Ihrer Festplatte. Die Einstellungen unter Integrations bearbeiten diese und zeigen jeden Token, Schlüssel und Webhook zensiert an. - Sandbox-Durchläufe bleiben außen vor. Ein Sandbox-Durchlauf ist ein Test im Aufbau, kein Befund: Er erstellt, kommentiert oder schließt niemals einen Vorgang.
Ein Vorgang pro Test, solange er fehlschlägt
Jira, Azure Boards und GitHub Issues folgen demselben Lebenszyklus, und in den Einstellungen für Tickets lässt sich jeder Schritt anpassen. Der Vorgang gehört zum Test, nicht zum Lauf. Ein Test, der jede Nacht fehlschlägt, ergibt daher einen Vorgang mit Verlauf, nicht jede Nacht einen neuen.
- Der erste Fehler öffnet ein Issue. Ein Durchlauf, der mit BREACHED, BREACHED_FLAKY, CHAOS_BREACHED oder TIMEOUT endet, öffnet ein Issue für diesen Test – mit angehängtem Fehler und Screenshot des Fehlers.
- Ein wiederholter Fehler kommentiert es. Solange dieses Issue geöffnet ist, fügt der nächste Fehler einen Kommentar hinzu, an den der neue Screenshot angehängt wird. Zwei Browser, die gleichzeitig fehlschlagen, ergänzen dasselbe Issue.
- Ein erfolgreicher Durchlauf schließt es. Wenn der Test in jedem Browser eines Durchlaufs fehlerfrei besteht, erhält das Issue einen entsprechenden Kommentar und wechselt in seinen Erledigt-Status. Wenn der Workflow keinen solchen Übergang oder Status aufweist, erhält es nur den Kommentar.
- Ein darauf folgender Fehler öffnet ein neues Issue. Dasselbe gilt für einen Fehler, dessen Issue gelöscht oder verschoben wurde.
Anhänge: standardmäßig nur der Screenshot. Der Playwright-Trace und das Ausführungsprotokoll werden nur dann ebenfalls angehängt, wenn Sie dies per Opt-in über NEXUS_ISSUE_ATTACH_TRACE=true in den Einstellungen aktivieren, da sie Sitzungsdaten enthalten können: Cookies, Autorisierungs-Header und eingegebene Passwörter. Jede Datei wird bis zu einer Größe von 10 MB angehängt.
FLAKY erstellt niemals einen Eintrag: Ein Durchlauf, der fehlschlug und dann bei einem Wiederholungsversuch erfolgreich war, ist kein Bug. Dasselbe gilt für BLOCKED, UNREACHABLE, CRASHED oder einen Konfigurationsfehler, die die Umgebung betreffen und nicht Ihre Anwendung (wie Urteile gefällt werden). Welches Issue zu welchem Test gehört, wird in evidence/integrations/issue-map.json im Workspace festgehalten.
Schritt-für-Schritt-Anleitungen
Jede Anleitung erklärt, was Sie benötigen, wie Sie die Zugangsdaten erhalten und die Verbindung prüfen. Außerdem enthält sie häufige Fehler samt Ursache und Lösung.
- Jira Cloud verbinden
- Azure Boards verbinden
- GitHub Issues verbinden
- Slack verbinden
- Microsoft Teams verbinden
- Telegram verbinden
Weitere Ziele für Fehlermeldungen
Für fünf weitere Ziele gelten dieselben Regeln wie für die Dienste oben. Jedes ist zunächst deaktiviert, bis du es einschaltest, und wird direkt von deinem Rechner aus mit deinem eigenen Schlüssel angesprochen.
- Linear: ein Ticket pro fehlgeschlagenem Test im gewählten Team. Bei erneutem Fehlschlagen wird es kommentiert, bei einem fehlerfreien Durchlauf in den ersten abgeschlossenen Status verschoben. Schlüssel:
LINEAR_ENABLED,LINEAR_API_KEYundLINEAR_TEAM_ID. - GitLab Issues: derselbe Lebenszyklus in einem GitLab-Projekt: Bei einem fehlerfreien Durchlauf wird das Ticket geschlossen und bei erneutem Auftreten wieder geöffnet. Schlüssel:
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKENundGITLAB_ISSUES_PROJECT. Das Token wird ausschließlich über https übertragen. - PagerDuty: ein Fehlschlag löst einen Vorfall aus. Ein erneuter Fehlschlag ergänzt denselben Vorfall, ein fehlerfreier Durchlauf löst ihn. Schlüssel:
PAGERDUTY_ENABLEDundPAGERDUTY_ROUTING_KEY. - Opsgenie: derselbe Lebenszyklus als Alarm, der bei einem fehlerfreien Durchlauf geschlossen wird. Schlüssel:
OPSGENIE_ENABLEDundOPSGENIE_API_KEY. - TestRail: meldet das Ergebnis jedes Durchlaufs für den Testfall, den ein Test mit einem Kommentar wie
// nexus:testrail C123angibt. Schlüssel:TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEYundTESTRAIL_PROJECT_ID.
Nach Grundursache gruppieren ist eine Regel in den Ticket-Einstellungen und standardmäßig deaktiviert. Ist sie aktiviert und schlägt ein Test mit demselben Fehler fehl wie ein Test, für den bereits ein offenes Ticket besteht, wird dort ein Kommentar hinzugefügt, statt ein zweites Ticket zu öffnen. Ein fehlerfreier Durchlauf des gruppierten Tests schließt niemals das Ticket des ersten Tests.
Einen KI-Assistenten um Anleitung bitten
Jeder KI-Assistent kann Sie durch diese Anleitungen führen. Geben Sie ihm die Adresse einer Anleitung oder von integrations-guide.json. Diese Datei enthält alle Schlüssel samt gültigem Format und Prüfmethode sowie alle Fehler mit Ursache und Lösung.
- Fügen Sie niemals ein Token, einen Schlüssel, ein Passwort oder eine Webhook-URL in den Chat ein. Geben Sie Zugangsdaten ausschließlich im Studio unter Einstellungen, Integrationen ein. Ein Assistent benötigt sie niemals.
- Teilen Sie ihm nur Informationen mit, die nicht geheim sind: die Website-Adresse, den Projektnamen und die genaue Fehlerzeile, die das Studio anzeigt.
- Entscheidend ist die Prüfung im Studio selbst. Verbindung prüfen, Testnachricht senden und Testticket erstellen zeigen Ihnen, ob eine Verbindung funktioniert, nicht der Assistent.
- Falls Sie bereits Zugangsdaten in einen Chat eingefügt haben, widerrufen Sie diese beim jeweiligen Dienst und erstellen Sie neue.
Jira Cloud
- Verbinden: Ihre Atlassian-Konto-E-Mail und ein API-Token, erstellt unter id.atlassian.com. Fügen Sie in den Einstellungen unter Integrationen einen beliebigen Link von Ihrer Jira-Website ein: Das Studio übernimmt die Website und den Projektschlüssel. Die Website-Adresse,
JIRA_BASE_URL, muss https sein. Verbindung prüfen testet diese und erstellt nichts. - Issues: ein Bug in
JIRA_PROJECT_KEY, der dem oben genannten Lebenszyklus folgt. Bei einem fehlerfreien Durchlauf durchläuft das Issue den inJIRA_DONE_TRANSITIONbenannten Übergang, standardmäßig Done, unabhängig von der Groß-/Kleinschreibung nach Name abgeglichen. - Keine Duplikate: Wenn in den letzten 24 Stunden ein Bug mit derselben Zusammenfassung erstellt wurde, wird kein zweiter gemeldet.
- Mehrere Jira-Sites: unter Tickets fügt Weitere Jira-Site hinzufügen ein Ziel mit eigener Site, eigenem Projektschlüssel und Vorgangstyp hinzu. Jedes aktivierte Ziel erhält ein eigenes Ticket. Die Site muss eine Atlassian-Cloud-Adresse sein, https://<name>.atlassian.net, und dieselbe Atlassian-E-Mail-Adresse und dasselbe API-Token gelten für alle Sites dieses Kontos. Das Token wird nur an die von Ihnen aufgeführten Sites gesendet.
- Manuell: Das Evidence Locker kann einen Fehler an Jira senden, wenn Sie dies möchten.
Azure DevOps: Boards, Test Plans und Pipelines
Ein persönliches Zugriffstoken (PAT) und ein Projekt in AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> oder https://<org>.visualstudio.com) und AZURE_DEVOPS_PROJECT. Das PAT wird ausschließlich an die eigenen Hosts von Azure DevOps gesendet und erscheint niemals in einer Protokollzeile. In den Einstellungen unter Integrationen überprüft Azure DevOps verbinden das Projekt sowie den Work-Item-Typ und erstellt nichts.
- Azure Boards: Mit
AZURE_BOARDS_ENABLED=trueöffnet ein Fehlschlag ein Work-Item des TypsAZURE_BOARDS_WORK_ITEM_TYPE, standardmäßig Bug, gemäß dem oben beschriebenen Lebenszyklus. Bei einem erfolgreichen Durchlauf wechselt es in den Status inAZURE_BOARDS_DONE_STATE, standardmäßig Resolved; ein Prozess, der diesen Status verweigert, erhält nur den Kommentar. Das PAT benötigt Work Items (Lesen & Schreiben). Der Evidence Locker kann einen Fehlschlag auch manuell an Azure Boards senden. - Azure Test Plans: Die von der CI/CD-Ansicht generierte
azure-pipelines.ymlveröffentlicht das JUnit-XML des Durchlaufs mit der AufgabePublishTestResults@2, sodass jeder Pipeline-Durchlauf unter Test Plans, Runs angezeigt wird. - Azure Pipelines:
nexus ci-remote --provider=azurereiht einen Durchlauf der Pipeline inAZURE_PIPELINE_IDin die Warteschlange ein, wartet darauf und überträgt das JUnit-XML zurück auf diesen Rechner. Das PAT benötigt hierfür Build (Lesen & Ausführen).
GitHub Issues
- Verbinden: ein differenziert berechtigtes persönliches Zugriffstoken mit Issues-Berechtigungen (Lesen und Schreiben) für ein Repository in
GITHUB_ISSUES_TOKENund das Repository als owner/repo inGITHUB_ISSUES_REPO. In den Einstellungen unter Integrationen zeigt GitHub Issues verbinden an, wem das Token gehört, und bietet nur die damit zugänglichen Repositorys an, in denen Issues aktiviert sind (Schritt-für-Schritt-Anleitung). - Issues: mit
GITHUB_ISSUES_ENABLED=truewird bei einem Fehler ein Issue mit den Labels des Tickets gemäß dem oben beschriebenen Lebenszyklus erstellt. Bei einem fehlerfreien Durchlauf erhält das Issue einen Kommentar und wird als abgeschlossen geschlossen. - Weiteres Repository: unter Tickets kann für ein GitHub-Ziel ein anderes owner/repo angegeben werden als in
.env.
Slack
- Verbinden: Eine Incoming-Webhook-URL in
SLACK_WEBHOOK_URL. In den Einstellungen gibt es die Schaltfläche Testnachricht senden. - Was empfangen wird: Block-Kit-Nachrichten: die Zusammenfassung des Durchlaufs und mit
NEXUS_SLACK_NOTIFY=trueeine Nachricht pro fehlschlagendem, instabilem, Chaos- oder visuellem Regressionstest. Eine Nachricht über einen Fehlschlag verlinkt das entsprechende Jira-Ticket, sofern eines existiert. - Manuell: Der Evidence Locker kann eine Textzusammenfassung eines Fehlschlags in Slack posten. Slack erhält keine Dateien.
Microsoft Teams
- Verbinden: eine Workflows-Webhook-URL für einen Kanal in
TEAMS_WEBHOOK_URL. Teams Workflows erfordert ein Microsoft 365-Geschäfts- oder Schulkonto. In den Einstellungen gibt es Speichern & Test senden (Schritt-für-Schritt-Anleitung). - Was gesendet wird: dieselben Nachrichten wie an Slack, als Adaptive Cards: die Zusammenfassung des Durchlaufs und, mit
NEXUS_TEAMS_NOTIFY=true, eine Nachricht pro fehlgeschlagenem, instabilem, Chaos- oder visuellem Regressionstest. - Wohin die URL führt: nur zu einer https-Adresse auf Microsofts eigenen Webhook-Hosts (logic.azure.com, webhook.office.com, api.powerplatform.com). Jede andere URL wird abgelehnt und es wird nichts gesendet.
Telegram
- Verbinden: Ein eigener Bot, einmalig mit @BotFather erstellt, in
TELEGRAM_TOKEN. In den Einstellungen verknüpft Per QR verbinden Ihren Chat und fülltTELEGRAM_CHAT_IDaus. Es gibt keinen geteilten Bot. - Was empfangen wird: Benachrichtigungen bei Fehlschlägen, eine pro Test mit
NEXUS_TELEGRAM_NOTIFY=true, sowie die Berichte und Dateien, die Sie über das Studio teilen möchten. - Bevor Sie es aktivieren: Telegram kann Dateien wie Berichte und PDFs empfangen, und diese werden an die Server von Telegram übertragen. In einer regulierten Umgebung sollten Sie sich zunächst an Ihr Compliance-Team wenden.
Tickets: wann sie erstellt werden, was sie enthalten, wohin sie gehen
In den Einstellungen legt die Ansicht Tickets unter Integrationen fest, was bei einem fehlgeschlagenen Test in Jira, Azure Boards oder GitHub Issues erfasst wird. Die Teilen-Funktion des Evidence Locker verwendet dieselbe Vorlage. Sie wird im Arbeitsbereich in nexus-tickets.config.json gespeichert, einer Datei ohne Geheimnisse, die Sie in Ihrem Repository aufbewahren können. Ohne diese Datei verhalten sich Tickets wie oben beschrieben. Ist die Datei ungültig, gelten die Standardwerte und das Protokoll nennt den Grund.
- Wann: welche Ergebnisse ein Ticket auslösen (standardmäßig BREACHED und TIMEOUT), wie viele aufeinanderfolgende Fehlschläge dafür nötig sind, eine Obergrenze pro Durchlauf, lokale Durchläufe, CI-Durchläufe oder beides, einzuschließende oder auszuschließende Test-IDs, die Aktion bei einem fehlerfreien Test (schließen, nur kommentieren oder nichts) und ob ein erneut auftretender Fehler das geschlossene Ticket wieder öffnet, statt ein neues anzulegen.
- Was: die Titelvorlage mit
{type},{testId},{browser}und{error.firstLine}.{testId}ist erforderlich, da der Titel innerhalb von 24 Stunden als Schlüssel zur Duplikaterkennung dient. Außerdem die zu übermittelnden Beschreibungsabschnitte und deren Reihenfolge, der Umfang der Fehlermeldung, Schlagwörter, die Priorität je Ergebnis, die zugewiesene Person, die Komponente, benutzerdefinierte Felder und eine Teamnotiz. - Anhänge: standardmäßig der Screenshot. Die Ablaufaufzeichnung, das Video und der Bericht nur, wenn Sie diese auswählen, jeweils bis zur Größenobergrenze.
- Wohin: ein Ziel pro Ticketsystem, jeweils mit eigenem Schalter. Ein Ziel kann die Jira-Site, das Projekt und den Vorgangstyp, das GitHub-Repository oder den Azure-Arbeitselementtyp überschreiben.
- Vorschau und Test: Die Ansicht zeigt vor dem Speichern für jedes Ziel das Ticket an, das Ihr jüngster Fehlschlag erzeugen würde. Testticket erstellen legt daraus ein echtes Ticket mit dem Schlagwort
nexus-testan.
Was ein Ticket niemals enthält
- Nur das, was Sie auswählen. Nicht ausgewählte Abschnitte oder Anhänge bleiben auf Ihrem Rechner.
- Geheimnisse werden zuerst maskiert. Jede Textzeile wird vor dem Erfassen bereinigt: Autorisierungs- und Cookie-Header, Bearer- und Basic-Token, JWTs, bekannte Schlüsselformate von Anbietern, Passwörter in URLs und Werte von Feldern, deren Namen auf Geheimnisse hindeuten. Dabei werden die üblichen Formen erkannt, in denen Geheimnisse in Protokollen und Fehlermeldungen auftauchen, aber nicht jedes Geheimnis, das Freitext enthalten kann. Lassen Sie die Ablaufaufzeichnung daher deaktiviert, sofern Sie sie nicht benötigen.
- Keine Token in der Datei.
nexus-tickets.config.jsonweist alle Felder zurück, deren Namen auf Geheimnisse hindeuten, sowie alle URLs mit Benutzernamen und Passwort. Token bleiben in.env.
Die Schlüssel
Jeder Schlüssel ist eine Zeile in der .env des Workspace. Über die Einstellungen können alle bearbeitet werden.
| Dienst | Schlüssel | Standardwerte |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | Aus; Projekt QA; Übergang Done |
| Azure DevOps | AZURE_BOARDS_ENABLED, AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PAT, AZURE_BOARDS_WORK_ITEM_TYPE, AZURE_BOARDS_DONE_STATE, AZURE_PIPELINE_ID | Aus; Typ Bug; Status Resolved |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | Aus |
| Issue-Anhänge | NEXUS_ISSUE_ATTACH_TRACE | Aus: nur der Screenshot |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | Aus |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | Aus |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | Aus |
In einer Pipeline sind dieselben Schlüssel – alle außer AZURE_PIPELINE_ID – die geheimen Variablen der Pipeline, und ein Schlüssel, den Sie nicht setzen, belässt den zugehörigen Dienst deaktiviert (Secrets in CI/CD).
Fragen
Sieht Nexus StudioQA meine Jira- oder Azure DevOps-Daten?
Nein. Die Engine kommuniziert von Ihrem Rechner aus mit Jira, Azure DevOps, GitHub Issues, Slack, Teams und Telegram und verwendet dabei Ihre Schlüssel. Nichts davon läuft über unsere Server.
Eröffnet ein unzuverlässiger (flaky) Test ein Ticket?
Nein. FLAKY erstellt nichts. BREACHED_FLAKY schon: Der Fehler selbst war inkonsistent, und ein erneuter Versuch verbirgt ihn nicht.
Ein Test ist diese Woche 30 Mal fehlgeschlagen. Wie viele Issues sind das?
Eines, mit einem Kommentar und einem neuen Screenshot für jeden Fehler nach dem ersten, bis der Test in jedem Browser fehlerfrei durchläuft.
Kann ich Jira, Azure Boards und GitHub Issues gleichzeitig verwenden?
Ja. Jedes System führt pro Test einen eigenen Vorgang, ebenso jede zusätzliche Jira-Site.