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

Abrufen der Schemaversion

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.

Vorbereiten der TMH-Datei

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