UAT Studioby Salvion
Hilfe · Verbindungen

UAT Studio mit Jira verbinden

Senden Sie Issues aus Ihrem UAT direkt in das Jira-Projekt Ihres Entwicklungsteams. Kein Abschreiben von Tickets mehr nach dem Triage-Call: ein Klick, und der Bug ist in Jira, mit dem Testschritt, dem erwarteten Ergebnis, den Screenshots und einem Rücklink. Wenn die Korrektur fertig ist, weiß der Tester, dass es Zeit für den Retest ist.

Dauer etwa 10 MinutenWer ein Workspace-AdminFunktioniert mit Jira CloudPakete Team, Business, Partner und Enterprise
In einer Minute

Erst ansehen

Die Jira-Verbindung einrichten und ein erstes Issue senden, mit dem Status, der zurückkommt (59 Sekunden, Untertitel im Bild).
Bevor Sie beginnen

Was Sie brauchen

  • Jira Cloud: eine Adresse, die auf .atlassian.net endet.
  • Ein Jira-Konto, das Vorgänge anlegen darf, in dem Projekt, in das die Bugs gehen sollen.
  • Admin-Rechte in Ihrem UAT Studio Workspace.
Tipp: Verwenden Sie ein DienstkontoTickets werden im Namen des Kontos angelegt, dessen Token Sie verwenden. Viele Teams legen dafür einen eigenen Jira-Benutzer wie UAT Studio an, damit Tickets nicht vom Konto einer Person abhängen und leicht zu erkennen sind.
Einrichten · einmal pro Workspace

Ihr Jira-Projekt verbinden

1

API-Token in Atlassian erstellen

  1. Melden Sie sich bei Atlassian mit dem Jira-Konto an, das Sie verwenden werden, und gehen Sie zu id.atlassian.com › Security › API tokens.
  2. Klicken Sie auf Create API token.
  3. Geben Sie ihm einen Namen, den Sie später wiedererkennen, zum Beispiel UAT Studio, und wählen Sie ein Ablaufdatum.
  4. Klicken Sie auf Copy. Lassen Sie das Fenster offen, bis Sie den Token in Schritt 5 eingefügt haben: Atlassian zeigt ihn nur einmal.
Atlassian-Konto, Registerkarte Security, API Tokens: die Schaltfläche Create API token und ein Token namens UAT Studio, der nach einem Jahr abläuft
Verwenden Sie Create API token, nicht Create API token with scopes. Tokens laufen nach höchstens einem Jahr ab.
Tragen Sie das Ablaufdatum in Ihren Kalender einWenn der Token abläuft, stoppt das Senden. Erstellen Sie einen neuen Token und fügen Sie ihn in UAT Studio ein; sonst ändert sich nichts.
2

Jira-Adresse und Project Key finden

Jira address: Öffnen Sie Jira und sehen Sie in die Adresszeile. Alles bis einschließlich .atlassian.net ist Ihre Adresse, zum Beispiel https://acme.atlassian.net.

Project key: der kurze Code vor jeder Ticketnummer. In PORTAL-123 ist der Key PORTAL. Öffnen Sie ein beliebiges Ticket im Projekt, dann sehen Sie ihn oben im Breadcrumb. Noch keine Tickets? Öffnen Sie das Projekt und sehen Sie in die Adresszeile: Der Key folgt auf /projects/.

Projects oder Spaces?Das neuere Jira nennt Projekte spaces. Das ist dasselbe: Verwenden Sie den Key des Space, in den Ihre Bugs gehen sollen.
3

Connections in UAT Studio öffnen

Melden Sie sich unter app.uat.studio an und öffnen Sie Ihren Workspace. Klicken Sie auf Connections. Sie finden es auch in jedem Projekt unter Setup, als Manage connections.

Die Workspace-Seite mit den Schaltflächen Plan & billing, People & access, Connections und Audit log
4

Jira hinzufügen und Einstellungen ausfüllen

Wählen Sie unter Add a connection die Option Jira und klicken Sie auf Add.

Add a connection, mit ausgewähltem Jira und der Schaltfläche Add

Eine Karte für die neue Verbindung erscheint. Füllen Sie aus:

FeldWas Sie eintragen
NameSo heißt die Schaltfläche: Send to Jira. Ändern Sie es, wenn Sie mehr als ein Projekt verbinden, zum Beispiel Portal Jira.
Jira addressIhre Adresse aus Schritt 2, etwa https://acme.atlassian.net.
Email of the Jira accountDie E-Mail-Adresse des Kontos, das den Token erstellt hat.
Project keyDer Key aus Schritt 2, in Großbuchstaben, etwa PORTAL.
Issue typeBug. Wenn Ihr Projekt keinen Typ Bug hat, verwenden Sie den Typ, den Ihr Team für Fehler nutzt, etwa Task.

Klicken Sie auf Save settings.

Die Karte der Jira-Verbindung mit ausgefüllter Adresse, E-Mail, Project Key und Issue type
5

Token speichern

Fügen Sie den Token aus Schritt 1 in das Feld API token ein und klicken Sie auf Store token. Das Feld zeigt danach nur noch die letzten 4 Zeichen, damit Sie sehen, welcher Token gespeichert ist.

Das Feld API token mit einem eingefügten, als Punkte verborgenen Token und die Schaltfläche Store token
Ihr Token bleibt IhrerDer Token wird einmal über eine verschlüsselte Verbindung gesendet und verschlüsselt gespeichert. Niemand kann ihn wieder auslesen: nicht Ihre Kollegen, nicht der UAT Studio Support.
6

Verbindung testen

Klicken Sie auf Test connection. UAT Studio meldet sich mit Ihrem Token bei Jira an und prüft das Projekt. Wenn alles stimmt, sehen Sie Connected as <name> to project <project> und OK neben dem letzten Test.

Die Verbindungskarte nach einem erfolgreichen Test: letzter Test OK, verbunden als Emma de Vries mit dem Projekt Customer Portal

Das war's. Jedes Projekt in diesem Workspace kann jetzt Issues an dieses Jira-Projekt senden.

Jeden Testtag

Issues an Jira senden

Ein Issue

Öffnen Sie das Issue. Klicken Sie unter Ticket in the development team's system auf Send to Jira.

Der Issue-Bereich mit der Schaltfläche Send to Jira

Wenige Sekunden später existiert das Ticket in Jira. Ticketnummer und Link erscheinen am Issue, und der Verlauf des Issues zeigt, wann und von wem es gesendet wurde. Ein bereits verknüpftes Issue kann nicht versehentlich zweimal gesendet werden.

Der Issue-Bereich nach dem Senden: verknüpft mit dem Jira-Ticket PORTAL-1, mit einem Link Open Jira PORTAL-1

Alle Issues nach dem Triage-Call

Treffen Sie in Issues › Triage für jedes neue Issue eine Entscheidung. Danach zählt UAT Studio die zu behebenden Issues, die noch kein Ticket haben. Klicken Sie auf Send 3 to Jira (oder wie viele es sind), um alle Tickets auf einmal anzulegen.

Triage erledigt: Send to the development team, mit der Schaltfläche Send 3 to Jira und den CSV-Downloads

Was das Jira-Ticket enthält

  • Titel: Nummer und Titel des Issues, etwa ISS-012: Quote PDF shows the wrong VAT rate.
  • Beschreibung: was der Tester geschrieben hat, der Testfall mit dem fehlgeschlagenen Schritt und dem erwarteten Ergebnis, die Umgebung und wer es gefunden hat.
  • Priorität aus dem Schweregrad sowie die Labels UAT und die Issue-Nummer, damit Sie danach filtern können.
  • Ein Rücklink zum Issue in UAT Studio, wo die Screenshots sind.
Ein von UAT Studio angelegter Bug in Jira: der Titel ISS-001 mit dem fehlgeschlagenen Testschritt und eine Beschreibung mit dem Schritt, dem erwarteten und dem tatsächlichen Ergebnis
Ein Ticket, wie UAT Studio es anlegt. Unter der Beschreibung: der Testfall, wer es gefunden hat, und der Link Open in UAT Studio.

Screenshots kommen mit

Die Screenshots und Dateien des Issues werden an das Jira-Ticket angehängt: bis zu 10 Dateien mit je höchstens 10 MB. Eine Datei, die nicht passt, bleibt in UAT Studio, und der Verlauf des Issues nennt sie.

Duplikate zusammenführen

Wenn Sie in UAT Studio zwei Issues zusammenführen, die beide ein Ticket haben, folgt das doppelte Ticket: Es erhält einen Kommentar, den Link duplicates zum anderen Ticket und wechselt nach Done. Wenn Ihr Workflow das nicht zulässt, sagt UAT Studio Ihnen das, und Sie schließen es selbst in Jira. Hatte nur das Duplikat ein Ticket, übernimmt das verbleibende Issue es.

Status zurück

Wenn die Korrektur in Jira fertig ist

Wenn der Entwickler das Ticket in einen Status der Kategorie Done verschiebt, wird das Issue in UAT Studio zu Ready for retest und der Tester erhält eine E-Mail zum Retest. Wechselt das Ticket nach In Progress, tut das Issue das auch. Der Status in Jira wird neben dem Ticketlink angezeigt.

Ein fehlgeschlagener Retest wird nie rückgängig gemacht: Wenn der Tester das Issue wieder öffnet, während das Ticket noch Done ist, lässt UAT Studio es offen. Ein geschlossenes Issue bleibt geschlossen.

Von selbst oder sofort

Ohne Ihr Zutun fragt UAT Studio den Ticketstatus jedes Mal ab, wenn ein Admin die Issues öffnet, sowie über die Schaltfläche Update ticket status.

Sofort: Lassen Sie Jira UAT Studio melden, wenn sich ein Ticket bewegt. Sie müssen dafür im Jira-Projekt eine Automatisierungsregel anlegen dürfen.

  1. Klicken Sie in UAT Studio unter Connections in der Jira-Verbindung auf Create webhook address und kopieren Sie die Adresse. Sie wird nur einmal angezeigt.
  2. Öffnen Sie in Jira das Projekt und gehen Sie zu Project settings › Automation › Create rule.
  3. Trigger: Work item transitioned (im älteren Jira: Issue transitioned). Lassen Sie From und To leer.
  4. Aktion: Send web request. Web request URL: die kopierte Adresse. Methode POST. Web request body: Issue data (Jira format).
  5. Nennen Sie die Regel UAT Studio status und schalten Sie sie ein.
Behalten Sie die Adresse im TeamDie Adresse dient nur als Schlüssel zum Melden von Ticketstatus. Verloren oder versehentlich geteilt? Klicken Sie auf New address: Die alte funktioniert sofort nicht mehr.
Rollen

Wer was darf

AdminsVerbindungen hinzufügen, ändern, testen und entfernen; Issues senden.
Tester, Stakeholder, EntwicklerSehen Ticketnummer und Link an einem Issue. Sie können keine Issues senden und keine Verbindungseinstellungen sehen.
Audit-LogJede Änderung an einer Verbindung wird protokolliert, sodass Sie immer sehen, wer was wann geändert hat.
Fehlerbehebung

Wenn etwas schiefgeht

Sie sehenWas zu tun ist
The token or email address is not acceptedDie E-Mail-Adresse muss die des Atlassian-Kontos sein, das den Token erstellt hat. Prüfen Sie auf Tippfehler oder erstellen Sie einen neuen Token und speichern Sie ihn erneut.
The project … was not foundPrüfen Sie den Project Key und ob das Jira-Konto das Projekt sehen kann.
Senden scheitert am Issue typeDas Projekt hat keinen Typ mit diesem Namen. Sehen Sie die Typen in Ihrem Jira-Projekt nach und tragen Sie unter Issue type den richtigen ein.
Es hat funktioniert, jetzt nicht mehrDer Token ist wahrscheinlich abgelaufen oder wurde widerrufen. Erstellen Sie einen neuen und speichern Sie ihn; der Rest bleibt, wie er ist.
Der Status kommt nicht zurückÖffnen Sie die Issues als Admin oder klicken Sie auf Update ticket status. Mit einer Webhook-Adresse: Prüfen Sie, ob die Automatisierungsregel eingeschaltet ist, und sehen Sie sich ihr Audit-Log in Jira an; unter Connections sehen Sie, wann die letzte Nachricht ankam.
Keine Schaltfläche Send to JiraNur Admins sehen sie, und nur wenn die Verbindung On ist und einen gespeicherten Token hat.
Connections are not part of your planVerbindungen gehören zu Team, Business, Partner und Enterprise und sind als Add-on für Project erhältlich. Ihr Admin kann unter Plan & billing upgraden.

Kommen Sie nicht weiter? Schreiben Sie an [email protected] mit der Meldung, die Sie sehen. Senden Sie uns nie den Token selbst.

Sie nutzen Azure DevOps? Siehe UAT Studio mit Azure DevOps verbinden. Alle Anleitungen: UAT Studio Hilfe.

Sicherheit

Wie wir mit Ihrem Token umgehen

  • Der Token geht einmal über eine verschlüsselte Verbindung von Ihrem Browser an unseren Server.
  • Er wird verschlüsselt gespeichert (AES-256). Der Schlüssel zum Entschlüsseln wird getrennt von der Datenbank aufbewahrt, sodass eine Kopie der Datenbank allein nutzlos ist.
  • Niemand kann den Token wieder auslesen: nicht in der App, nicht über den Support.
  • UAT Studio verwendet den Token nur, um die Verbindung zu testen, die von Ihnen gesendeten Tickets (mit ihren Dateien) anzulegen, den Status dieser Tickets zu lesen und nach dem Zusammenführen ein doppeltes Ticket zu schließen. Sonst liest es nichts in Ihrem Jira.
  • Entfernen Sie die Verbindung oder widerrufen Sie den Token in Atlassian, und der Zugriff endet sofort.