Projekt importieren

You can import projects from external sources to conduct testing operations through Test Manager. Use this feature to transfer entire testing projects from different Application Lifecycle Management (ALM) systems to Test Manager.

Wie es funktioniert

Importing the project follows a schema that converts external system projects (e.g., testing applications) into a format that can be read by Test Manager. This includes objects such as requirements, test cases, test sets, test results, labels, custom fields, preconditions, postconditions, and attachments. The import process is done asynchronously.

Überlegungen

• New Object IDs (GUIDs) are generated during import in Test Manager.
• Zeitstempel (Created Time,Updated Time) werden beibehalten.
• Erstellt vonund Aktualisiert von beziehen sich auf den Benutzer, der die Projektimportanforderung eingereicht hat. Der ursprüngliche Benutzer, der das Artefakt im ALM-System erstellt hat, wird nicht beibehalten.
• Dateianhänge, die die Größenbeschränkungen (90 MB) überschreiten, werden übersprungen.

Wer kann Projekte importieren?

Any user having a valid Test Manager License can import projects.

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. Go to Swagger, using the Test Manager endpoint that you currently use. To connect Swagger to your Test Manager, visit API References
2. Wechseln Sie zur ProjectMigrationSchema- Anforderung.
3. Führen Sie GET /api/v2/migration/schema/versions aus und kopieren Sie die im Antworttextgenerierte Version.
4. Geben Sie die kopierte Schemaversion als Parameter für GET /api/v2/migration/schema/{schemaVersion} ein und führen Sie die API aus.
5. Wählen Sie Datei herunterladen im Abschnitt Antworttext aus .

Ergebnisse: Eine ZIP-Datei wird heruntergeladen, die das Schema der verschiedenen Testartefakte in der TMH-Datei enthält. Die ZIP-Datei enthält die folgenden Ordner und Dateien:

• Ein Anhangsordner – enthält Unterordner, die den Anhängen entsprechen, die jedem Objekt zugeordnet sind. Die Objekt-ID ist der Ordnername (Testfälle, Testsätze, Anforderungen, Testausführungen usw.).
• An objects folder - contains subfolders corresponding to all types of objects available in Test Manager.
• Eine JSON-Manifestdatei – enthält grundlegende Metadaten zu Ihrer WebExtension.
• Eine readme.txt -Datei – enthält Anweisungen zum Vorbereiten von Daten, die in den Ordnern gespeichert werden.

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.

Beispiel: Um einen Testfall anzugeben, verwenden Sie das folgende Beispielschema:

{
  "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 in Klammern mit den Daten ändern, die Ihrem Testfallentsprechen.

1. Nachdem Sie JSON-Dateien für jedes Objekt aus einem Projekt erstellt haben, 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 zu Testfällen enthalten, zum Unterordner testcases hinzu .

   Wichtig: Wenn Sie eine große Anzahl von Objekten importieren müssen, teilen Sie sie in mehrere Dateien auf, z. B. testcases-1.json und testcases-2.json . Wir empfehlen, eine maximale Anzahl von 500 Dateien pro Unterordner hinzuzufügen.
2. Fügen Sie die Anhangsdateien hinzu, die den Objekten unter dem Ordner „ Anhänge “ zugeordnet sind, und verwenden Sie dabei die folgende Ordnerhierarchie: /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?

Any user having a valid Test Manager License can import projects.

Weitere Informationen finden Sie unter Benutzer- und Gruppenzugriffsverwaltung.

Importing a project in Test Manager

Prepare the exported TMH file and then review the project import details in 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. Sign in to Test Manager.
2. Klicken Sie auf Projekt importieren.
3. Fügen Sie die TMH-Datei hinzu. Projektdetails werden automatisch abgerufen und im Abschnitt Objekte im Projekt aufgelistet, damit Sie sie überprüfen können, bevor Sie mit dem Importprozess beginnen.
4. (Optional) Bearbeiten Sie den Projektnamen, das Präfix und die Beschreibung.
5. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.
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 bis 15 Minuten, bei größeren Projekten kann es jedoch länger dauern.

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

Importing into an existing project in Test Manager

1. Sign in to Test Manager.
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 der Projektdatei aufgelistet, damit Sie sie überprüfen können, bevor Sie mit dem Importprozess beginnen.

4. Wählen Sie Vorhandenes Projekt unter Zielaus.
5. Wählen Sie das Zielprojekt, in das die Daten importiert werden, aus der Dropdownliste Projekt aus.
   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. Include automation information for test cases is automatically selected so you can import automation and other relevant information. For example, an automation linked to a test case will be imported to Test Manager with all the details and test case steps.
7. Überprüfen Sie die Informationen und wählen Sie Importieren aus, 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 eine Benachrichtigung „Projektimport abgeschlossen“ über das Ereignis.

   
   

   

   
   
8. Wählen Sie die Benachrichtigung aus, um zur Registerkarte Anhänge des neuen Projekts zu wechseln, auf der Sie Folgendes anzeigen 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

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. If the project import fails, contact UiPath® Support.

Anzeigen von Automatisierungsinformationen

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

1. Wählen Sie auf der Seite Projekt importieren unten die Option Automatisierungsinformationen für Testfälle einschließen aus.
2. Schließen Sie den Import ab, und filtern Sie durch die importierten Testfälle, indem Sie den Automationcleared -Beschriftungsfilter anwenden.
3. Öffnen Sie jeden zurückgegebenen Testfall, und wechseln Sie zur Registerkarte Details , um die Informationen über die Automatisierung abzurufen, die den Testfall generiert hat.
   Abbildung 1. Die Dropdownliste Beschriftungen mit der gelöschten Automatisierung
   

   

   
   

Die auf der Registerkarte Details angezeigten Automatisierungsinformationen umfassen:

• Automatisierungs-ID
• AutomationProjectName

• AutomationTestCaseName