Projekt importieren

Importieren Sie eine TMH-Datei aus einem externen System als neues oder vorhandenes Projekt in Test Manager und migrieren Sie Anforderungen, Testfälle, Testsätze und Anhänge.

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 vom Test Manager gelesen werden kann. Dazu gehören Objekte wie Anforderungen, Testfälle, Testsätze, Testergebnisse, Beschriftungen, benutzerdefinierte Felder, Vorbedingungen, Nachbedingungen und Anhänge. Der Importprozess erfolgt asynchron.

Überlegungen

• Neue Objekt-IDs (GUIDs) werden während des Imports in Test Manager generiert.
• Time stamps (Created Time, Updated Time) are maintained.
• 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.
• Automatisierungslinks werden während des Imports nicht übernommen, da die Verknüpfung von Automatisierungs-IDs abhängt, die für jeden Mandanten eindeutig sind.

Hinweis:

Nachdem Sie ein Projekt in einen anderen Mandanten importiert haben, heben Sie die Verknüpfung der Automatisierung jedes Testfalls auf und verknüpfen Sie sie erneut mit der entsprechenden Automatisierung in Orchestrator des Zielmandanten. Andernfalls bleiben automatisierte Ausführungen für diesen Testfall im Status „Ausstehend“ hängen.

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

The schema version is required to build the TMH file, and you retrieve it with API calls in Swagger.

Schritte

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.

Ergebnis

A ZIP file is downloaded. It contains the schema of the different testing artifacts in the TMH file.

Die ZIP-Datei enthält die folgenden Ordner und Dateien:

• 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.

Importieren eines Projekts in den Test Manager

Importing a project creates a new Test Manager project from an exported TMH file.

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.

Schritte

1. Melden Sie sich beim Test Manager an.
2. Wählen Sie Projekt importieren aus.
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. Review the Objects in project section and check the data objects included in the project file.
5. (Optional) To include automation as part of your import, select the Include automation information for test cases check box.
6. (Optional) To include the project configuration as part of your import, select the Import project configuration check box.
7. (Optional) Bearbeiten Sie den Projektnamen, das Präfix und die Beschreibung.
8. Überprüfen Sie die Informationen und wählen Sie 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.

9. Review the import project report displayed in Test Manager as a notification after the process is completed. The import summary PDF file shows the status of the imported objects. You can investigate individual objects that haven't been imported in object migration log csv file.
   Hinweis:

   If the project import fails, contact UiPath® Support.

Ergebnis

The imported project shows up in the Projects page, grayed out until the process is completed. A Project Import Completed notification confirms the import.

Importieren in ein vorhandenes Projekt in Test Manager

Importing into an existing project merges the requirements, test cases, test sets, and other artifacts of a TMH file into the target project.

Schritte

1. Melden Sie sich beim Test Manager an.

2. Wählen Sie Projekt importieren aus.

3. Add the TMH file that you downloaded here. Project details are automatically fetched and listed in the Objects in project file section so you can review before starting the import process.

4. Review the Objects in project file section and check the data objects included in the project file.

5. (Optional) To include automation as part of your import, select the Include automation information for test cases check box.

6. (Optional) To include the project configuration as part of your import, select the Import project configuration check box.

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

8. 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.

9. Ü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.

10. When the process of importing an existing project is completed, you receive a Project Import Completed notification about the event.

    

11. Select the notification to go to the Attachments tab of the new project, where you can view:

    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.

12. Review the import project report displayed in Test Manager as a notification after the process is completed. The import summary PDF file shows the status of the imported objects. You can investigate individual objects that haven't been imported in object migration log csv file.

    Hinweis:

    If the project import fails, contact UiPath® Support.

Ergebnis

The data of the TMH file is imported into the selected project, and a Project Import Completed notification confirms the import.

Anzeigen von Automatisierungsinformationen

The Details tab of an imported test case shows the automation that generated it, provided that you included automation information in the import.

Schritte

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.

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

   

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

Ergebnis

Die auf der Registerkarte Details angezeigten Automatisierungsinformationen umfassen:

• Automatisierungs-ID
• AutomationProjectName
• AutomationTestCaseName

Ähnliche Artikel

• Spezifikation des TMH-Dateiformats