Skip to content

qTest Extractor Setup — Customer Guide

Configure analytiQa to automatically extract test cases and execution data from your qTest instance.

Prerequisites

  • qTest Cloud or On-Premise instance (any plan)
  • qTest account with project admin or tester access
  • qTest Access Token (from your instance)

Step 1: Provide Your qTest URL

Tell us your qTest base URL. Examples:

  • Cloud: https://your-instance.qtestnet.com/
  • On-Premise: https://qtest.your-domain.com/

If you're unsure, log into qTest — the URL is in your browser address bar.

Step 2: Provide Your Credentials

You need:

  1. Base URL — your qTest instance URL (from Step 1)
  2. Access Token — generated from your qTest account

Don't have a token? See Getting Started → For qTest

Step 3: Choose Projects to Extract

Select which qTest projects to include. You can:

Extract data from all projects you have access to.

Option 2: Specific Projects (Wildcard Pattern)

Use a pattern to match project names. Examples:

Pattern Matches
.* All projects (same as Option 1)
Regression.* Projects starting with "Regression"
.*Sprint.* Projects with "Sprint" in the name
MyProject\|OtherProject Exact projects: "MyProject" OR "OtherProject"

Step 4: Set Date Ranges (Optional)

By default, analytiQa extracts data from the last 24 hours. You can customize:

  • Start Date: How far back to look for historical data (e.g., 2024-01-01)
  • End Date: Leave blank for "today"

Example: Extract test data from the past 3 months: - Start Date: 2025-01-20 - End Date: (blank = today, 2025-04-20)

Step 5: Choose Your Polling Interval

Select how often analytiQa should check for new data:

  • Hourly (default): Good for most teams
  • Custom interval: Specify a different frequency
  • Manual: Trigger on-demand when needed

Step 6: Review Your Configuration

Before confirming, check:

  • ✓ qTest URL is correct and accessible
  • ✓ Access token is valid
  • ✓ Project pattern matches the projects you want
  • ✓ Date range includes your needed historical data
  • ✓ Schedule works for your team

What Happens Next

  1. First extraction (5–30 minutes): analytiQa fetches all test data from selected projects
  2. Daily updates (every day at scheduled time): New test cases and executions are pulled
  3. Dashboard ready: Log in to analytiQa dashboard → qTest tab

What Gets Extracted

From each qTest project, analytiQa captures:

  • Test Cases: Name, description, status, priority, custom fields
  • Requirements: Linked requirements and traceability
  • Execution Results: Pass, fail, blocked, execution date, tester, duration
  • Defects: Linked bugs and issues
  • Test Suites: Organization and test grouping
  • Attachments metadata: File names and upload dates (not file contents)

Example Dashboards

Once data is ingested, see Common Queries & Reports for pre-built examples:

  • Test execution status (Pass/Fail/Blocked) breakdown
  • Test cases by priority and project
  • Execution trends over time
  • Defect metrics and failure rates

Troubleshooting

Issue Solution
"Invalid credentials" Double-check your qTest URL and access token. Regenerate token if needed.
"Connection timeout" Verify qTest is accessible from your network. Try the URL in a browser.
"No projects found" Your access token may have limited permissions. Ask a qTest admin to grant project tester or higher role.
"Empty results" Your date range may not include any data. Try expanding the start date.

More help? See Support & Troubleshooting.

Next Steps