Blog

ReqTest zu Azure DevOps Test Plans migrieren

DEC 18, 2023

Der ReqTest to Azure DevOps Migrator ist ein CLI-Tool von Solidify (jetzt Eficode), das die Übertragung all eurer Testdaten von der ReqTest-Plattform zu Azure DevOps Test Plans erleichtert. Dieser Blogbeitrag stellt das Tool vor und zeigt euch, wie ihr sämtliche Testdaten von ReqTest zu Azure DevOps (AzDo) Test Plans migriert – für einen reibungslosen Übergang und den Erhalt der Testintegrität.

Alexander Hjelm

Das Tool ist ideal für Unternehmen, die ihre Testmanagement-Plattform reibungslos wechseln oder Azure DevOps Test Plans einfach bewerten möchten – bei gleichzeitiger Wahrung der Testintegrität.

Hinweis zum Bezug des Tools

In diesem Blogbeitrag wird der ReqTest to Azure DevOps Migrator von Solidify verwendet. Wenn ihr das Tool zu Evaluierungszwecken erhalten möchtet, könnt ihr uns gerne kontaktieren.

Funktionen des Tools

Unser Tool unterstützt alle folgenden ReqTest-Ressourcen:

  • Test Cases: Alle Testfälle werden präzise migriert.

  • Anforderungen: Überträgt Anforderungen, damit das Projekt konsistent bleibt.

  • Bugs: Überträgt Bugs, um den Entwicklungsprozess zu vereinfachen.

  • Test Suites: Überträgt Test Suites und erhält ihre Hierarchie.

  • Test Runs: Vollständige Migration bisheriger Test Runs und ihrer Ergebnisse.

Überblick über den Ablauf

  1. Erforderliche Berechtigungen in Azure DevOps erteilen

  2. API-Tokens beschaffen

  3. CLI-Tool konfigurieren

  4. Benutzerzuordnung einrichten

  5. CLI-Tool ausführen

  6. Ergebnisse überprüfen

1. Schritt für Schritt: Berechtigungen festlegen und API-Tokens beschaffen

Azure DevOps

Hinweis zur Lizenz

Um auf Azure Test Plans zuzugreifen und den gesamten Funktionsumfang für Tests zu nutzen, benötigt ihr die Zugriffsstufe Basic + Test Plans oder eines der folgenden Abonnements: Visual Studio Enterprise, Visual Studio Test Professional oder MSDN Platform.

Erforderliche Berechtigungen

Der Benutzer, der die Migration ausführt, benötigt Contributor-Zugriff auf das gewünschte Azure DevOps-Projekt sowie die folgenden Berechtigungen auf Projekt- und Bereichspfadebene:

Projektebene:

  • Test Runs erstellen

  • Testkonfigurationen verwalten

Bereichspfad-Ebene:

  • Arbeitselemente in diesem Knoten anzeigen

  • Arbeitselemente in diesem Knoten bearbeiten

  • Testpläne verwalten

  • Testsuiten verwalten

PAT-Berechtigungsbereiche

Beim Erstellen eures Personal Access Token (PAT) müsst ihr die folgenden Berechtigungsbereiche aktivieren:

  • Arbeitselemente: Lesen, Schreiben und Verwalten

  • Testmanagement: Lesen und Schreiben

Jetzt könnt ihr ein PAT erstellen und sicher speichern.

2. Schritt für Schritt: Konfiguration

Alle erforderlichen Konfigurationen findet ihr oben in der Datei migrator.py.

Beschreibung der Konfiguration

  • reqtest_project_id: ReqTest-Projekt-ID (numerischer Wert).

  • reqtest_api_key: ReqTest-Zugriffstoken zur Authentifizierung.

  • azdo_collection_url: URL zu eurer Azure DevOps-Organisation.

  • ado_project: Name eures Azure DevOps-Projekts.

  • azdo_pat: Azure DevOps Personal Access Token zur Authentifizierung.

  • azdo_testplan_id: Azure DevOps-Testplan-ID (numerischer Wert).

  • azdo_testplan_rootsuite_id: ID der Suite im AzDo-Testplan, in der Testfälle abgelegt werden sollen (numerischer Wert).

  • azdo_areapath: Azure DevOps-Bereichspfad für die korrekte Kategorisierung.

  • azdo_iterationpath_base: Azure DevOps-Iterationspfad für eine strukturierte Planung.

  • usermap_path: Dateipfad zur Benutzerzuordnung, die Zuordnungen zwischen ReqTest- und AzDo-Benutzern definiert.

Beispielkonfiguration

###################
## Confiugration ##
###################

reqtest_project_id = 123456789
reqtest_api_key = "your_reqtest_api_key"
azdo_collection_url = "https://dev.azure.com/yourorganization"
ado_project = "Your_Azure_DevOps_Project"
azdo_pat = "your_azure_devops_personal_access_token"
azdo_testplan_id = 987654321
azdo_testplan_rootsuite_id = 456789012
azdo_areapath = "Your_AzureDevOps_AreaPath"
azdo_iterationpath_base = "Your_AzureDevOps_IterationPath"
usermap_path = "C:\\path\\to\\your\\usermap\\file.txt"

3. Schritt für Schritt: User Map

Die User Map legt fest, welche Azure DevOps-Identität welchem Benutzer in ReqTest zugeordnet wird. Dies wirkt sich auf das Feld für den Work-Item-Zugewiesenen sowie auf die Work-Item-Historie und Kommentare aus.

Alle aktiven ReqTest-Benutzer müssen in der User-Map-Datei enthalten sein. Die Datei muss den Namen user-map.txt tragen und folgendem Format entsprechen:

reqtest.user1@email.com=azdo.user1@email.com
reqtest.user2@email.com=azdo.user2@email.com
reqtest.user3@email.com=azdo.user3@email.com

4. Schritt für Schritt: Das Tool ausführen

Sobald die gesamte Konfiguration eingerichtet ist, führt das Tool einfach mit folgendem Befehl aus:

python3 migrator.py

Das Tool führt eine Online-Migration durch und überträgt alle Daten direkt an Azure DevOps.

Nachdem alle Testdaten erfolgreich migriert wurden, prüft das Log, um sicherzustellen, dass während der Migration keine Fehler aufgetreten sind.

Fazit

Dieser Blogbeitrag hat den ReqTest to Azure DevOps Migrator von Solidify vorgestellt, mit dem ihr alle Testdaten von der ReqTest-Plattform zu Azure DevOps Test Plans migrieren könnt.

Wenn ihr eine Produktanfrage habt oder weitere Fragen stellen möchtet, sprecht uns an.

  • DevOps
  • Cloud
  • Microsoft

Subscribe to our newsletter