Troubleshoot errors during Quick import

Troubleshoot import and connection failures that occur during Quick Import from TestRail/Zephyr Scale to Test Management by interpreting error messages.

Import failure

If you modify the folder structure in TestRail/Zephyr Scale while you perform Quick Import from TestRail/Zephyr Scale to Test Management, the import process may fail.

Connection failures for TestRail

A connection failure warning may appear on the dashboard when using BrowserStack’s Test Management to perform a Quick Import from TestRail. The issue may be due to an incorrect TestRail Email Address, TestRail Host Name, or TestRail API Key.

TestRail Email address

When you attempt to Quick Import data from TestRail using the Test Management, an error message may appear: Connection failed. Please verify TestRail Email and API Key.

Resolution:

Verify credentials:

• Recheck the TestRail Email you have entered. Ensure there are no typographical errors.
• If you have recently changed your TestRail credentials, update it in the Quick Import .

TestRail Host Name

When you attempt to Quick Import data from TestRail using the Test Management, and if you have entered incorrect URL, an error message may appear: Connection failed. Please verify TestRail Host Name.

Resolution:

Verify the hostname:

• Recheck the syntax of the TestRail Host URL you have entered. Ensure there are no typographical errors.

TestRail API KEY

The following steps aim to assist in identifying and potentially resolving the error message: Connection failed. Please verify TestRail Email and API Key.. The issue may arise due to an incorrect or unsaved API key in TestRail. However, executing these steps may only sometimes solve the issue.

Do the following steps to configure the API key:

1. Log in to your TestRail account and navigate to the API KEYS tab under My Settings in the dashboard.
2. You can use one of the API keys from the saved list or click Add Key to create a new key.

3. Enter a relevant API Key name in the Name field. Click Generate Key.

   

   An API key is successfully generated. Copy and store the key in a secure location. The key is displayed once and will not be accessible later.

4. Click Add Key.

   

5. Click Save Settings.

Once you have reconfigured the API key, perform the Quick Import from TestRail again to check if the Connection failed. Please verify TestRail Email and API Key. issue has been resolved. If the issue persists, contact BrowserStack support.

TestRail non-admin user

When you perform a Quick Import of data from TestRail using the Test Management, you may encounter an error message: Access denied. Entered TestRail credentials are not of an Admin user. Try with Admin credentials. It typically occurs when the credentials used for the TestRail account lack administrative privileges.

Resolution:

To resolve this issue, ensure that the TestRail account with administrative rights is used to enable administrative privileges for non-admin user accounts.

Follow these steps to enable the admin access to the TestRail account:

1. Log into your TestRail account and navigate to the non-admin user profile on the dashboard.

2. Click the Access tab in the user dashboard.

   

3. Select This user is an administrator check box.
4. Click Save User.

Retry the Quick Import process from TestRail using the Test Management. The issue should be resolved, and you can import the data.

TestRail API is disabled

When setting up a new TestRail account, the API integration is turned off by default. If you use this new account to Quick Import data from TestRail using the Test Management , an error message: Connection failed. Please enable the API on TestRail under 'Administration > Site Settings > API'.

Resolution:

Follow these steps to enable API integration in the new TestRail account:

1. Log into your TestRail account and navigate to the Site Settings tab under the administration dashboard.

2. Click the API tab in the dashboard.

   

3. Select Enable API check box.
4. Click Save Settings.

Retry the Quick Import process from TestRail using the Test Management. The issue should be resolved, and you can import the data.

Connection error with TestRail servers

When you attempt to establish a connection with your TestRail account during Quick Import, you may encounter one of the following error messages:

1. Could not establish a connection with TestRail servers.
2. This TestRail account seems to be in maintenance mode currently. Please try after sometime.

Causes:

1. Interruptions or instability in your internet connection can prevent successful communication with TestRail servers.
2. Occasional maintenance or unexpected downtime of TestRail servers may temporarily hinder connectivity.

Resolution:

1. Check TestRail’s status page or community forums for any notices about server maintenance or downtime.
2. Retry Quick Import and try to establish the connection after sometime.

Connection failures for Zephyr Scale

JIRA Host Name

When you attempt to Quick Import data from Zephyr Scale using the Test Management, and if you have entered incorrect Zephyr-linked Jira account URL, an error message may appear: Connection failed. Please verify Jira Host Name.

Resolution:

Verify the host name:

• Recheck the syntax of the Jira Host URL you have entered. Ensure there are no typographical errors.

JIRA Email address and API Token

When you attempt to Quick Import data from Zephyr Scale using the Test Management, an error message may appear: Connection failed. Please verify Jira Email and API Token.

Resolution:

First, check your email address:

• Recheck the Zephyr-linked Jira account email you have entered. Ensure there are no typographical errors.
• If you have recently changed your credentials, update it in the JIRA Email address field.

If email is correct, verify your Jira API Token:

Do the following steps to configure the API token:

1. Log in to your Jira account and navigate to the Security tab.
2. You can use one of the API keys from the saved list or click Create API token to create a new key.

3. Enter a relevant API token name in the Label. Click Create.

   

   An API token is successfully generated.

4. Click Copy.

   

   The API token is copied to the clipboard.

5. Click Close.

Use the API token in the JIRA API Token field and perform the Quick Import from Zephyr again to check if the Connection failed. Please verify Jira Email and API Token issue has been resolved. If the issue persists, contact BrowserStack support.

Zephyr Scale API Access Token

The following steps aim to assist in identifying and potentially resolving the error message: Connection failed. Please verify Zephyr Scale API Access Token. issue that may arise due to an incorrect Zephyr Scale API Access token.

Do the following steps to configure the API key:

1. Log in to your Jira account.
2. Navigate to your account on the top right corner and click Zephyr Scale API Access Tokens.

3. Click Create access token.

   

   An Access token is successfully generated.

4. Click Copy.

   

   The access token is copied to the clipboard.

5. Click Close.

Use the access token in the Zephyr Scale API Access Token field and perform the Quick Import from Zephyr again to check if the Connection failed. Please verify Zephyr Scale API Access Token. issue has been resolved. If the issue persists, contact BrowserStack support.

Connection error with Zephyr Scale server

When you attempt to establish a connection with your Zephyr Scale account during Quick Import, you may encounter the following error message: Connection failed. This error could be because of interruptions or instability in your internet connection can prevent successful communication with Zephyr Scale.

Resolution:

• Retry Quick Import and try to establish the connection after sometime.