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 (Erstellungszeit,Aktualisierungszeit) werden beibehalten.
• 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.

Wer kann Projekte importieren?

Jeder Benutzer mit einer gültigen Test Manager-Lizenz kann Projekte importieren.

For more information see User and Group Access Management.

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

Results: A ZIP file is downloaded, that has the schema of different testing artifacts in the TMH file. The ZIP file contains the following folders and files:

• 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. After creating JSON files for each object from a project, add them to the corresponding subfolder in the objects folder. You can name the JSON files however you want, but the names of the subfolders must stay the same

   Example: Add the JSON files that contain data about Test Cases to the testcases subfolder.

   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.

Wer kann Projekte importieren?

Jeder Benutzer mit einer gültigen Test Manager-Lizenz kann Projekte importieren.

For more information see User and Group Access Management.

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 aufgeführt, sodass Sie sie überprüfen können, bevor Sie den Importprozess starten.

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 die Automatisierung 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–15 Minuten, aber bei größeren Projekten kann es länger dauern.

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