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

Die Schemaversion ist erforderlich, um die TMH-Datei zu erstellen, und Sie rufen sie mit API-Aufrufen in Swagger ab.

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

Eine ZIP-Datei wird heruntergeladen. Sie enthält das Schema der verschiedenen Testartefakte in der TMH-Datei.

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

Beim Importieren eines Projekts wird ein neues Test Manager-Projekt aus einer exportierten TMH-Datei erstellt.

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. Überprüfen Sie den Abschnitt Objekte im Projekt und aktivieren Sie die Datenobjekte, die in der Projektdatei enthalten sind.
5. (Optional) Um Automatisierung als Teil Ihres Imports einzuschließen, aktivieren Sie das Kontrollkästchen Automatisierungsinformationen für Testfälle einschließen .
6. (Optional) Um die Projektkonfiguration als Teil Ihres Imports aufzunehmen, aktivieren Sie das Kontrollkästchen Projektkonfiguration importieren .
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. Ü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.
   Hinweis:

   Wenn der Projektimport fehlschlägt, wenden Sie sich an den UiPath®-Support.

Ergebnis

Das importierte Projekt wird auf der Seite Projekte ausgegraut, bis der Prozess abgeschlossen ist. Eine Benachrichtigung für abgeschlossenen Projektimport bestätigt den Import.

Importieren in ein vorhandenes Projekt in Test Manager

Beim Importieren in ein vorhandenes Projekt werden die Anforderungen, Testfälle, Testsätze und andere Artefakte einer TMH-Datei in das Zielprojekt zusammengeführt.

Schritte

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 hier heruntergeladen haben. Projektdetails werden automatisch abgerufen und im Abschnitt Objekte in Projektdatei aufgeführt, sodass Sie sie überprüfen können, bevor Sie den Importprozess starten.

4. Überprüfen Sie den Abschnitt Objekte in Projektdatei und aktivieren Sie die Datenobjekte, die in der Projektdatei enthalten sind.

5. (Optional) Um Automatisierung als Teil Ihres Imports einzuschließen, aktivieren Sie das Kontrollkästchen Automatisierungsinformationen für Testfälle einschließen .

6. (Optional) Um die Projektkonfiguration als Teil Ihres Imports aufzunehmen, aktivieren Sie das Kontrollkästchen Projektkonfiguration importieren .

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. Wenn der Import eines vorhandenen Projekts abgeschlossen ist, erhalten Sie die Benachrichtigung Projektimport abgeschlossen über das Ereignis.

    

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

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

    Hinweis:

    Wenn der Projektimport fehlschlägt, wenden Sie sich an den UiPath®-Support.

Ergebnis

Die Daten der TMH-Datei werden in das ausgewählte Projekt importiert und eine Benachrichtigung Projektimport abgeschlossen bestätigt den Import.

Anzeigen von Automatisierungsinformationen

Auf der Registerkarte Details eines importierten Testfalls wird die Automatisierung angezeigt, die ihn generiert hat, sofern Sie Automatisierungsinformationen in den Import aufgenommen haben.

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