Projekt importieren

Sie können Projekte aus externen Quellen importieren, um Testvorgänge über den Test Manager durchzuführen. Verwenden Sie diese Funktion, um ganze Testprojekte aus verschiedenen Application Lifecycle Management (ALM)-Systemen in Test Manager zu übertragen.

Wie es funktioniert

Das Importieren des Projekts folgt einem Schema, das externe Systemprojekte (z. B. Testanwendungen) in ein Format konvertiert, das von Test Manager gelesen werden kann. Dazu gehören Objekte wie Anforderungen, Testfälle, Testsätze, Testergebnisse, Bezeichnungen, benutzerdefinierte Felder und Anhänge. Der Importprozess erfolgt asynchron.

Überlegungen

• Neue Objekt-IDs (GUIDs) werden während des Imports in Test Manager generiert.
• Zeitstempel (Erstellungszeit,Aktualisierungszeit) werden beibehalten.
• Erstellt von und Aktualisiert von beziehen sich auf den Benutzer, der die Projektimportanforderung eingereicht hat. Der ursprüngliche Benutzer, der das Artefakt erstellt hat, wird nicht im ALM-System beibehalten.
• Dateianhänge, die die Größenbeschränkungen (90 MB) überschreiten, werden übersprungen.

Wer kann Projekte importieren?

Jeder Benutzer mit einer gültigen Test Manager-Lizenz kann Projekte importieren.

Weitere Informationen finden Sie unter Benutzer- und Gruppenzugriffsverwaltung.

Getting the schema version

Sie benötigen die Schemaversion , um die TMH-Datei zu erstellen. Das Abrufen der Schemaversion umfasst die Verwendung von API-Aufrufen in Swagger. Führen Sie die folgenden Schritte aus, um die Schemaversion abzurufen:

1. Wechseln Sie mit dem derzeit verwendeten Test Manager-Endpunkt zu Swagger. Informationen zum Verbinden von Swagger mit Ihrem Test Manager finden Sie in den API-Referenzen
2. Go to the ProjectMigrationSchema request.
3. Execute GET /api/v2/migration/schema/versions and copy the version generated in the Response Body.
4. Input the copied schema version as a parameter for GET /api/v2/migration/schema/{schemaVersion} and execute the API.
5. Select Download file from the Response body section.

Results: A ZIP file is downloaded, that has the schema of different testing artifacts in the TMH file. The ZIP file contains the following folders and files:

• An attachments folder - contains subfolders corresponding to the attachments associated with each object, object Id is folder name (test cases, test sets, requirements, test executions, etc.).
• An objects folder - contains subfolders corresponding to all types of objects available in Test Manager.
• A JSON manifest file - holds basic metadata about your WebExtension.
• A readme.txt file - contains instructions for preparing data that goes inside the folders.

Preparing the TMH file

Wenn Sie Ihre THM-Dateien für den Import vorbereiten, empfehlen wir, eine Dateigröße zu verwenden, die 2 GB nicht überschreitet. Wenn Sie die Dateigröße innerhalb dieses Grenzwerts halten, können Sie vermeiden, dass der Importprozess zwischendurch abgebrochen wird.

Geben Sie alle Objekte an, die Sie in JSON-Dateien importieren möchten, und befolgen Sie dabei die Beispielschemata in jedem Unterordner.

Example: To specify a Test Case, use the sample schema below:

{
  "testCases": [
    {
      "id": "string (100)",
      "version": "string (100)",
      "name": "string (100)",
      "inputParams": "string",
      "description": "string",
      "automationId": "string (100)",
      "automationTestCaseName": "string (100)",
      "automationProjectName": "string (100)",
      "foreignRef": "string",
      "connectorTestCaseId": "string",
    }
  ]
}

Stellen Sie sicher, dass Sie die Daten zwischen den Daten in Klammern mit den Daten ändern, die Ihrem Testfall entsprechen.

1. Nach dem Erstellen von JSON-Dateien für jedes Objekt aus einem Projekt fügen Sie sie dem entsprechenden Unterordner im Objektordner hinzu. Sie können die JSON-Dateien beliebig benennen, aber die Namen der Unterordner müssen gleich bleiben. Beispiel: Fügen Sie die JSON-Dateien, die Daten über Testfälle enthalten, dem Testfall- Unterordner hinzu.
   Wichtig:

   If you have a large number of objects to import, split them into multiple files, such as testcases-1.json, and testcases-2.json. We recommend adding a maximum number of 500 files per subfolder.

2. Add the attachment files associated with the objects under the attachments folder, using the following folder hierarchy: /attachments/object-id/file name.
   • object-id – ersetzen Sie dies durch die ID des zugeordneten Objekts.
   • file name – ersetzen Sie dies durch den Namen des Anhangs.

Wer kann Projekte importieren?

Jeder Benutzer mit einer gültigen Test Manager-Lizenz kann Projekte importieren.

Weitere Informationen finden Sie unter Benutzer- und Gruppenzugriffsverwaltung.

Importieren eines Projekts in den Test Manager

Bereiten Sie die exportierte TMH-Datei vor, und überprüfen Sie dann die Projektimportdetails im Test Manager.

Wichtig:

Wenn Sie Ihre THM-Dateien für den Import vorbereiten, empfehlen wir, eine Dateigröße zu verwenden, die 2 GB nicht überschreitet. Wenn Sie die Dateigröße innerhalb dieses Grenzwerts halten, können Sie vermeiden, dass der Importprozess zwischendurch abgebrochen wird.

1. Melden Sie sich beim Test Manager an.
2. Klicken Sie auf Projekt importieren.
3. Fügen Sie die TMH-Datei hinzu. Projektdetails werden automatisch abgerufen und im Abschnitt Objekte im Projekt aufgeführt, sodass Sie sie überprüfen können, bevor Sie den Importprozess starten.
4. (Optional) Bearbeiten Sie den Projektnamen, das Präfix und die Beschreibung.
5. Die Option Automatisierungsinformationen für Testfälle einschließen wird automatisch ausgewählt, sodass Sie die Automatisierung und andere relevante Informationen importieren können. Beispielsweise wird eine mit einem Testfall verknüpfte Automatisierung mit allen Details und Testfallschritten in den Test Manager importiert.
6. Überprüfen Sie die Informationen und klicken Sie auf Importieren , um den Prozess zu starten.
   Hinweis:

   Das Importieren des Projekts dauert in der Regel etwa 10–15 Minuten, aber bei größeren Projekten kann es länger dauern.

Das importierte Projekt wird auf der Seite Projekte ausgegraut angezeigt, bis der Prozess abgeschlossen ist.

Importieren in ein vorhandenes Projekt in Test Manager

1. Melden Sie sich beim Test Manager an.

2. Wählen Sie Projekt importieren aus.

3. Fügen Sie die TMH-Datei hinzu, die Sie hierheruntergeladen haben

   Projektdetails werden automatisch abgerufen und im Abschnitt Objekte in der Projektdatei aufgeführt, sodass Sie sie überprüfen können, bevor Sie den Importprozess starten.

4. Wählen Sie Vorhandenes Projekt unter Ziel aus.

5. Wählen Sie in der Dropdownliste Projekt das Zielprojekt aus, in das die Daten importiert werden.

   Tipp:

   • Wenn Sie über größere TMH-Dateien verfügen, können Sie sie in mehrere Dateien aufteilen und diese separat in dasselbe Zielprojekt importieren.
   • Wenn Sie mehrere Projekte exportieren, können Sie sie wieder in ein vorhandenes Projekt importieren.

6. Die Option Automatisierungsinformationen für Testfälle einschließen wird automatisch ausgewählt, sodass Sie die Automatisierung und andere relevante Informationen importieren können. Beispielsweise wird eine mit einem Testfall verknüpfte Automatisierung mit allen Details und Testfallschritten in den Test Manager importiert.

7. Überprüfen Sie die Informationen und wählen Sie Importieren , um den Prozess zu starten.

   Warnung:

   Das Feld Testergebnisse ist immer 0, da Testergebnisse nicht exportiert werden.

   Wenn der Import eines vorhandenen Projekts abgeschlossen ist, erhalten Sie die Benachrichtigung Projektimport abgeschlossen über das Ereignis.

8. Wählen Sie die Benachrichtigung aus, um zur Registerkarte Anhänge des neuen Projekts zu wechseln, wo Sie Folgendes sehen können:

   1. Protokolle für die Migrationsschritte (ZIP-Datei)
   2. Protokolle für die migrierten Objekte (ZIP-Datei)
   3. Importzusammenfassung (TXT-Datei) – zeigt die Gesamtzahl der Entitäten und wie viele von ihnen importiert oder übersprungen wurden.

Schritte nach dem Import

Schritte nach dem Import

Überprüfen Sie den Importprojektbericht, der im Test Manager als Benachrichtigung angezeigt wird, nachdem der Prozess abgeschlossen ist. Die PDF-Datei mit der Importzusammenfassung zeigt den Status der importierten Objekte. Sie können einzelne Objekte untersuchen, die nicht in die CSV-Datei mit dem Objektmigrationsprotokoll importiert wurden. Wenn der Projektimport fehlschlägt, wenden Sie sich an den UiPath®-Support.

Anzeigen von Automatisierungsinformationen

So zeigen Sie Informationen über die Automatisierung an, die einen bestimmten Testfall generiert hat:

1. In the Import project page, select Include automation information for test cases at the bottom.

2. Finish the import, and filter through the imported test cases, applying the automationcleared label filter.

3. Open every returned test case, and go to the Details tab to retrieve the information about the automation that generated the test case.

   Abbildung 1. Die Dropdownliste Beschriftungen, die die Beschriftung „Automatisierung gelöscht “ anzeigt

Die auf der Registerkarte Details angezeigten Automatisierungsinformationen umfassen:

• Automatisierungs-ID
• AutomationProjectName
• AutomationTestCaseName