UAT Studioby Salvion
Hilfe · Verbindungen

UAT Studio mit Azure DevOps verbinden

Senden Sie Issues aus Ihrem UAT direkt in das Azure-DevOps-Projekt Ihres Entwicklungsteams, als Work Items vom Typ Bug mit dem Testschritt, dem erwarteten Ergebnis, den Screenshots und einem Rücklink. Wenn das Work Item erledigt ist, weiß der Tester, dass es Zeit für den Retest ist.

Dauer etwa 10 MinutenWer ein Workspace-AdminFunktioniert mit Azure DevOps ServicesPakete Team, Business, Partner und Enterprise
In einer Minute

Erst ansehen

Die Azure-DevOps-Verbindung einrichten, ein erstes Issue als Work Item senden und den Status zurückbekommen (68 Sekunden, Untertitel im Bild).
Bevor Sie beginnen

Was Sie brauchen

  • Azure DevOps Services: eine Adresse wie dev.azure.com/yourcompany. (Azure DevOps Server auf Ihren eigenen Servern wird nicht unterstützt.)
  • Ein Konto, das Work Items anlegen darf, in dem Projekt, in das die Bugs gehen sollen.
  • Admin-Rechte in Ihrem UAT Studio Workspace.
Tipp: Verwenden Sie ein DienstkontoWork Items werden im Namen des Kontos angelegt, dessen Token Sie verwenden. Viele Teams nutzen dafür ein eigenes Konto wie UAT Studio, damit Work Items nicht von einer Person abhängen und leicht zu erkennen sind.
Einrichten · einmal pro Workspace

Ihr Azure-DevOps-Projekt verbinden

1

Organisation, Projekt und Prozess finden

Öffnen Sie Ihr Projekt in Azure DevOps und sehen Sie in die Adresszeile: dev.azure.com/acme/Customer Portal. Der erste Teil ist die Organisation (acme), der zweite das Projekt (Customer Portal), genau so geschrieben, einschließlich Leerzeichen.

Prüfen Sie dann den Prozess des Projekts: Project settings › Overview › Process.

ProzessZu verwendender Work-Item-Typ
Agile, Scrum oder CMMIBug: mit Repro Steps, Severity, Priority und Tags.
BasicIssue: Basic hat keinen Typ Bug. Das Work Item erhält Titel und Beschreibung; Basic hat keine Felder für Schweregrad und Priorität.
2

Personal Access Token erstellen

  1. Klicken Sie in Azure DevOps oben rechts auf das Symbol User settings (die Person mit Zahnrad neben Ihren Initialen) und wählen Sie Personal access tokens.
  2. Klicken Sie auf + New Token.
  3. Name: UAT Studio. Organization: Ihre Organisation. Expiration: Wählen Sie Custom defined, bis zu einem Jahr.
  4. Scopes: Wählen Sie Custom defined und haken Sie Work Items › Read & write an. Um auch Testfälle aus Test Plans zu lesen, haken Sie zusätzlich Test Management › Read an.
  5. Klicken Sie auf Create und kopieren Sie den Token. Azure DevOps zeigt ihn nur einmal: Lassen Sie das Fenster offen, bis Sie ihn in Schritt 4 eingefügt haben.
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.
3

Azure DevOps in UAT Studio hinzufügen

Melden Sie sich unter app.uat.studio an, öffnen Sie Ihren Workspace und klicken Sie auf Connections. Wählen Sie unter Add a connection die Option Azure DevOps und klicken Sie auf Add.

Add a connection, mit ausgewähltem Azure DevOps und der Schaltfläche Add
FeldWas Sie eintragen
NameSo heißt die Schaltfläche: Send to Azure DevOps. Ändern Sie es, wenn Sie mehr als ein Projekt verbinden.
OrganizationDer Teil nach dev.azure.com/, etwa acme.
ProjectDer Projektname genau wie in Azure DevOps, etwa Customer Portal.
Work item typeBug oder Issue in einem Basic-Projekt (siehe Schritt 1).
Area pathOptional: wohin die Work Items gehen, etwa Customer Portal\UAT. Leer: der Standardbereich des Projekts.

Klicken Sie auf Save settings.

Die Karte der Azure-DevOps-Verbindung mit Organisation acme, Projekt Customer Portal und Work-Item-Typ Bug
4

Token speichern

Fügen Sie den Token aus Schritt 2 in das Feld Personal access token ein und klicken Sie auf Store token. Das Feld zeigt danach nur noch die letzten 4 Zeichen.

Das Feld Personal access 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.
5

Verbindung testen

Klicken Sie auf Test connection. UAT Studio prüft den Token, das Projekt und ob der Work-Item-Typ existiert. Wenn alles stimmt, sehen Sie Connected to project … in …; work items of type Bug can be created und OK neben dem letzten Test. Existiert der Typ nicht, nennt die Meldung die Typen, die das Projekt hat.

Die Verbindungskarte nach einem erfolgreichen Test: letzter Test OK, verbunden mit dem Projekt Customer Portal in acme
Jeden Testtag

Issues an Azure DevOps senden

Ein Issue

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

Der Issue-Bereich mit der Schaltfläche Send to Azure DevOps

Nummer und Link des Work Items erscheinen am Issue, und sein Verlauf 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 Azure-DevOps-Work-Item 4101, mit einem Link zum Öffnen

Alle Issues nach dem Triage-Call

Treffen Sie in Issues › Triage für jedes neue Issue eine Entscheidung. Klicken Sie danach auf Send 3 to Azure DevOps (oder wie viele es sind), um alle Work Items auf einmal anzulegen.

Was das Work Item enthält

  • Titel: Nummer und Titel des Issues, etwa ISS-012: Quote PDF shows the wrong VAT rate.
  • Repro Steps und Description: was der Tester geschrieben hat, der Testfall mit dem fehlgeschlagenen Schritt und dem erwarteten Ergebnis und wer es gefunden hat, mit einem Rücklink zu UAT Studio.
  • Severity, Priority und die Tags UAT und die Issue-Nummer (nicht in einem Basic-Projekt).
  • Attachments: die Screenshots und Dateien des Issues, bis zu 10 Dateien mit je höchstens 10 MB.

Duplikate zusammenführen

Wenn Sie zwei Issues zusammenführen, die beide ein Work Item haben, erhält das doppelte Work Item einen Kommentar, den Link Duplicate Of zum anderen und wird geschlossen (Closed, Done oder Resolved, je nachdem, was der Prozess zulässt). Hatte nur das Duplikat ein Work Item, übernimmt das verbleibende Issue es.

Status zurück

Wenn die Korrektur in Azure DevOps fertig ist

Wenn der Entwickler das Work Item auf Resolved, Done oder Closed setzt, wird das Issue in UAT Studio zu Ready for retest und der Tester erhält eine E-Mail. Active, Committed oder Doing setzen das Issue auf In progress. Der Status in Azure DevOps wird neben dem Link angezeigt.

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

Von selbst oder sofort

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

Sofort: Lassen Sie Azure DevOps UAT Studio über einen Service Hook melden, wenn sich ein Work Item ändert. Sie müssen dafür Projektadministrator in Azure DevOps sein.

  1. Klicken Sie in UAT Studio unter Connections in der Azure-DevOps-Verbindung auf Create webhook address und kopieren Sie die Adresse. Sie wird nur einmal angezeigt.
Status zurück in der Verbindung: die Webhook-Adresse mit einer Schaltfläche Copy und die Schritte für Azure DevOps
  1. Öffnen Sie in Azure DevOps das Projekt und gehen Sie zu Project settings › Service hooks. Klicken Sie auf Create subscription.
  2. Scrollen Sie in der Liste der Dienste nach unten, wählen Sie Web Hooks und klicken Sie auf Next.
Neues Service-Hooks-Abonnement: die Liste der Dienste mit Web Hooks ganz unten
Schritt 3: Web Hooks steht weit unten in der Liste.
  1. Trigger on this type of event: Work item updated. Setzen Sie unter Filters Field auf State, damit nur Statusänderungen gesendet werden. Area path und Work item type können auf [Any] bleiben, oder Sie grenzen sie auf Ihren Projektbereich und Typ ein. Klicken Sie auf Next.
Trigger: Work item updated, mit den Filtern Area path, Work item type und Field auf State gesetzt
Schritt 4: Work item updated, Field State.
  1. URL: Fügen Sie die Adresse aus Schritt 1 ein. Lassen Sie die anderen Felder (Benutzername, Passwort, Header) leer. Klicken Sie zur Prüfung auf Test, dann auf Finish.
Aktion: Post via HTTP, mit dem Feld URL
Schritt 5: Fügen Sie die Adresse in URL ein.
Behalten Sie die Adresse im TeamDie Adresse dient nur als Schlüssel zum Melden von Work-Item-Status. Verloren oder versehentlich geteilt? Klicken Sie in UAT Studio auf New address und aktualisieren Sie den Service Hook: Die alte Adresse funktioniert sofort nicht mehr.
Rollen

Wer was darf

AdminsVerbindungen hinzufügen, ändern, testen und entfernen; Issues senden.
Tester, Stakeholder, EntwicklerSehen Nummer und Link des Work Items 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 is not accepted, or has no access to this organizationPrüfen Sie den Namen der Organisation (der Teil nach dev.azure.com/), ob der Token für diese Organisation erstellt wurde und ob er den Scope Work Items (Read & write) hat. Oder erstellen Sie einen neuen Token und speichern Sie ihn erneut.
The project has no work item type "Bug"Das Projekt verwendet wahrscheinlich den Prozess Basic: Tragen Sie unter Work item type Issue ein. Die Meldung nennt die vorhandenen Typen.
Not found (404)Prüfen Sie den Projektnamen: genau wie in der Adresszeile, einschließlich Leerzeichen.
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 einem Service Hook: In Azure DevOps zeigt Project settings › Service hooks, ob er gelaufen ist und was zurückkam; unter Connections in UAT Studio sehen Sie, wann die letzte Nachricht ankam.
Keine Schaltfläche Send to Azure DevOpsNur 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 Jira? Siehe UAT Studio mit Jira 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 Work Items (mit ihren Dateien) anzulegen, den Status dieser Work Items zu lesen und nach dem Zusammenführen ein Duplikat zu schließen. Es braucht nur den Scope Work Items.
  • Entfernen Sie die Verbindung oder widerrufen Sie den Token in Azure DevOps, und der Zugriff endet sofort.