Quick Import data using qTest

Set up BrowserStack Test Management by quickly importing projects and test cases from qTest.

You can import qTest data by entering host name and API token and establishing a connection.

Perform the following steps to connect qTest with Test Management.

View and manage Import Logs

After confirming your import settings and initiating a qTest import, you can track its progress and review the outcomes of current and all previous imports from the Import Logs tab. This centralized log helps you track ongoing imports and keep a record of all completed or failed attempts for troubleshooting and analysis.

Key features of the Import Logs:

• Real-time status tracking:
  When you start an import, it will appear in the list with a corresponding status indicator. You’ll be able to see if the import is still in progress, has completed successfully, or encountered errors. The status icons and textual cues offer a quick snapshot of the current state.

• Detailed metrics per import:
  Each entry in the logs provides essential metrics about that specific import, such as:
  • Number of test cases imported: How many test cases were successfully brought over from qTest.
  • Test runs & test plans data: You can verify the accurate transfer of key project elements by the number of test runs and test plans associated with the import.
  • Project count: The number of projects affected by the import operation.

• User & timestamp information:
  The logs capture who initiated the import and when it was started. This helps maintain accountability and trace changes back to specific team members. If you have multiple team members initiating imports, this information streamlines coordination and follow-up.

• Access to detailed error information: Using the action menu (the three dots next to a specific import), you can:
  • View Report: Dive deeper into the results of a completed or partially completed import. These reports can include success metrics, error messages, and other diagnostic details.
  • Retry Import: If an import encountered errors or did not yield the expected results, quickly reinitiate the process from here. This feature streamlines troubleshooting and reduces the time spent switching between different sections of the interface.

Understand the qTest import mapping

When you import test execution data from qTest, the import process intelligently maps your project entities to the BrowserStack Test Management structure. This guide explains how your qTest Releases, Cycles, and Test Runs are translated, so you know exactly where to find your data after the migration.

Use this table as a quick reference for the qTest to BrowserStack entity mapping.

How your qTest data is mapped

Test Plans from qTest Releases

Each of your qTest Releases is migrated into a BrowserStack Test Plan. A test plan acts as a high-level container for all test executions related to that release milestone.

• Test plan name: Matches the qTest Release name.
• Dates: The start date and end date are carried over.
• Details: The Description and Release notes from qTest are combined into the Test Plan’s description field.
• Attachments: Any files attached to the Release are migrated to the Test Plan.
• Note: By default, the importer fetches execution data from qTest releases created within the last two years.

Test Runs from qTest Cycles

Each qTest Test Cycle within a Release is migrated as a distinct Test Run under the corresponding Test Plan.

• Test run name: Matches the qTest Test Cycle name.
• Description: The Test Cycle description is mapped to the Test Run’s description.
• Assignee: The Assign To field from the Test Cycle is migrated.
• Test Cases: All test cases executed within the cycle (as qTest Test Runs) are added to this BrowserStack Test Run, preserving their execution details.

Handling standalone qTest test runs

In qTest, you can add test runs directly under a Release without a Test Cycle. To preserve these, the importer groups them into a special Test Run.

A new Test Run is created with the name Ad-hoc Execution – [Release Name]. This Ad-hoc run contains all test cases that were executed under the Release but were not part of any Test Cycle. It is linked to the same Test Plan as other runs from that release.

How execution data is migrated

We ensure that no execution history is lost. For every test case within a Test Run, the following data is preserved:

• Status: The final execution status (e.g., Pass, Fail, Blocked) is migrated. The complete execution history for each test case is also retained.
• Step-Level Results: The status, actual result, and attachments for each test step are preserved. The qTest Actual Result is mapped to the Notes field for the test step in BrowserStack.
• Metadata: The execution timestamp and the tester responsible for the execution are carried over.

Handling Other qTest entities

Jira links

Your requirement and defect linkages from Jira are fully preserved.

• Requirements: Requirements linked to a qTest Test Cycle are linked to the corresponding BrowserStack Test Run.
• Defects: Defects linked to a qTest Test Case execution are linked to that test case within its BrowserStack Test Run.

Email notification

An email notification is also sent to your registered email ID when the Quick Import process completes successfully.