Projekt importieren

Sie können Projekte aus externen Quellen importieren, um Testvorgänge über den Test Manager durchzuführen. Nutzen Sie diese Funktion, um ganze Testprojekte aus verschiedenen ALM-Systemen (Application Lifecycle Management) zum 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 im Test Manager generiert.
• 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?

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. 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.).
• Ein Objektordner – enthält Unterordner, die allen im Test Manager verfügbaren Objekttypen entsprechen.
• 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?

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 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. Die Option Automatisierungsinformationen für Testfälle einschließen wird automatisch ausgewählt, sodass Sie Automatisierungen 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 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.

Importieren in ein vorhandenes Projekt im 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 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. Die Option Automatisierungsinformationen für Testfälle einschließen wird automatisch ausgewählt, sodass Sie Automatisierungen 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 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

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