Was ist der Xray Test Case Importer?
Der Xray Test Case Importer ist ein Wizard, also ein Assistent von Xray Test Management for Jira, das Ihnen hilft, Tests aus CSV- oder JSON-Dateien zu importieren. In dieser Anleitung zeigen wir Ihnen, wie der Import von CSV-Dateien einfach gemeistert werden kann. Bei Fragen zum Import mit JSON, kontaktieren Sie uns einfach – wir helfen Ihnen gerne weiter!
Generell können Sie Tests auch über die REST API importieren, dies ist jedoch zeitaufwändig und verlangt einiges an Vorarbeit und -wissen. Der Xray Test Case Importer allerdings ist ein intuitiv zu bedienendes Tool, mit dem Sie immens Zeit sparen und Gefahren für mögliche Fallstricke reduzieren können.
Xray Test Case Importer oder Jira CSV Importer?
In Jira haben Sie auch die Möglichkeit, CSV-Daten über den in Jira integrierten CSV Importer zu importieren. Beide Tools sind jedoch für unterschiedliche Ziele geeignet:
Es kann sein, dass Sie den Jira CSV Importer bereits zum Import einiger Vorgänge benutzt haben. Um Ihre vordefinierten Tests in Ihre Jira Instanz hinzuzufügen, ist die Arbeit mit dem Xray Test Case Importer jedoch unumgänglich.
Aber keine Sorge: Mit dieser Anleitung gelingt Ihnen dies im Handumdrehen!
Xray Test Case Importer für Jira effizient nutzen: Schritt-für-Schritt-Anleitung
Vor dem Import: CSV-Datei vorbereiten
Bevor die eigentliche Aufgabe beginnt, gibt es einige Dinge bei der CSV-Datei zu beachten. Sie können die Felder Ihrer Datei ganz nach Ihren individuellen Wünschen benennen, doch achten Sie darauf, diese folgenden drei Pflichtfelder zu integrieren:
-
Test-ID: Eindeutige Bezeichnung für den Vorgang. So können Zeilen gruppiert oder Vorbedingungen für Testreihen identifiziert werden.
-
Zusammenfassung: In Jira kann kein Vorgang ohne Zusammenfassung erstellt werden. Da Xray die Tests als Tickets importiert, ist hier auch eine Zusammenfassung notwendig.
-
Testtyp: Hier wird der Testtyp des zu importierenden Tests definiert. Die Typen sind: Manual, Generic und Cucumber.
Unser Beispiel zeigt, wie eine gut strukturierte CSV-Datei aussehen kann, die allen Anforderungen des Xray Test Case Importers genügt:
Hier sehen Sie die gleiche Datei dargestellt in einem herkömmlichen Texteditor:
Expertentipp: SVERWEIS in Excel
Um die CSV-Datei Xray-konform zu machen und dafür zu sorgen, dass beim Import keine zeitraubenden Störungen auftreten, empfehlen wir Ihnen, sich die SVERWEIS-Formel von Excel einmal genauer anzusehen. Hierbei handelt es sich um eine Funktion, die Spalten senkrecht durchsucht – daher auch der Name, S steht für senkrecht.
Diese Formel nützt viel, wenn Sie beispielsweise ein vorhandenes Issue updaten wollen und mit wenig Aufwand die Keys den CSV-Inhalten zuordnen möchten.
Denken Sie beim Exportieren Ihrer CSV-Datei unbedingt daran, ein Trennzeichen zu wählen, das ausschließlich Feldwerte optimal trennt. Wir empfehlen das Semikolon „;”.
Der Import
Wichtiger Hinweis zu Berechtigungen
Damit Sie den Import erfolgreich durchführen können, benötigen Sie einerseits die Berechtigung „Massenoperationen durchführen” und andererseits die „Vorgänge erstellen”-Berechtigung.
Schritt 1: Öffnen Sie Ihr Jira Dashboard, wählen Sie die App „Xray” und dort den Test Case Importer aus dem Menü.
Schritt 2: Nachdem Sie sich zwischen JSON und CSV für den Import einer CSV-Datei entschieden haben, erscheint folgende Bildschirmmaske:
Wählen Sie hier Ihre CSV-Quelldatei und das zuvor definierte Trennzeichen aus. Wenn Sie sich nicht mehr an das Trennzeichen erinnern, können Sie einfach im File nachsehen, mit einem Rechtsklick auf die CSV-Datei → „Open with Editor”.
Normalerweise ist es ratsam, die UTF-8 Codierung zu verwenden, damit alle Umlaute und Sonderzeichen fehlerfrei dargestellt werden. Beim Xray Test Case Importer ist dies jedoch nicht der Fall und das Format „ISO-8859-1” ist notwendig, um beispielsweise Umlaute korrekt darzustellen.
Schritt 3: Nun können Sie zusätzliche Setup-Informationen auswählen:
-
Projekt auswählen, in welches hinein importiert werden soll
-
Das Trennformat
-
Ein Datumsformat, das zum Analysieren der Felder benutzt wird: Hier muss vor allem das Format aus den Systemeinstellungen übereinstimmen.
-
Ob der Test-Repository-Ordner automatisch erstellt werden soll oder nicht
Schritt 4: Jetzt können Sie die Zuordnung von Spalten zu Jira/Xray Feldern bestimmen. Denn nach der Standardeinstellung ist bei Jira Feldern eingetragen: „Don’t map this field”, wie Sie im nächsten Screenshot erkennen.
Die Zuordnungen gewissenhaft vorzunehmen, ist für die Übersichtlichkeit Ihres Projekts von großem Vorteil. Vergessen Sie nicht, die Felder „Test-ID”, „Zusammenfassung” und „Testtyp” zu vergeben, denn hierbei handelt es sich – wie bereits erwähnt – um Pflichtfelder.
Wenn Sie in Ihrem Jira Projekt bei dem Issue Type Test noch weitere Pflichtfelder definiert haben, muss auch für diese eine Zuordnung angegeben werden.
Eine mögliche Zuordnung kann wie folgt aussehen:
Klicken Sie anschließend auf „Begin Import”, um den Vorgang zu starten.
Schritt 5: Während des Prozesses können Sie nachverfolgen, wie weit der Import fortgeschritten ist.
Schritt 6: Ein erfolgreicher Import liefert Ihnen eine Bildschirmmaske, die so ähnlich aussieht:
Nach dem Import
Nachdem der Importprozess abgeschlossen ist, können Sie sich eine Ergebnisliste anzeigen lassen und gegebenenfalls bearbeiten bzw. abspeichern, um die importierten Vorgänge zum Beispiel in ein Test-Set einzufügen.
Tests, die wieder aus dem Projekt entfernt werden sollen, können Sie einfach per Bulk Change löschen.
Auch können Sie nun prüfen, ob alle Imports erfolgreich abgeschlossen wurden. Wenn nicht, klicken Sie auf „Click here to download detailed import results”. In der dortigen JSON-Datei wird dann erklärt, wo der Fehler lag. Anschließend beheben Sie die Fehler in der CSV-Datei.
Fazit
Diese praktische Anleitung hat Ihnen gezeigt, wie Sie effizient mehrere Testfälle gleichzeitig mit dem Xray Test Case Importer importieren können. Ein Vorteil dieser Methode im Vergleich zum Jira CSV Importer besteht darin, dass das Tool auf Tests ausgelegt und intuitiv zu benutzen ist.
Auf diese Weise können Sie schnell eine große Menge an Test ohne hohes Fehlerrisiko in Ihre Instanz importieren. Unsere Consultant-Tipps zum unkomplizierten Test-Import stellen Ihren Erfolg sicher.
Wenn Sie weitere Tipps wünschen, Unterstützung bei einer Migration benötigen oder wissen wollen, wie der Import mit JSON funktioniert, kontaktieren Sie einfach unsere Consultants.
Wir unterstützen Sie gerne!
