testcomplete-qatouch

QA Touch reporter for TestComplete (SmartBear). Reads JUnit XML files exported from TestComplete and automatically creates modules, test cases, and a test run in QA Touch.

Install

npm install testcomplete-qatouch

No peer dependencies — works with any Node.js >= 16 project.

Usage

Export results from TestComplete via File > Export > JUnit XML (or use the tcDumpJUnit CLI utility), then create an upload-results.ts file:

import { TestCompleteQATouchReporter } from "testcomplete-qatouch";

const reporter = new TestCompleteQATouchReporter({
  domain:       "mycompany",
  apiToken:     "YOUR_API_TOKEN",
  projectKey:   "PROJ",
  assignTo:     "user-key",
  resultsFile:  "./TestResults/junit.xml",
  milestoneName: "Sprint 12",
  tag:          "testcomplete",
});

await reporter.run();

Run it:

npx ts-node upload-results.ts

Options

| Option | Type | Default | Description | |---|---|---|---| | domain | string | — | QA Touch subdomain | | apiToken | string | — | QA Touch API token | | projectKey | string | — | QA Touch project key | | assignTo | string | — | User key to assign the test run | | resultsFile | string | — | Path to the JUnit XML file | | testsuiteId | string? | auto | Fixed module key — skips auto-create | | milestoneName | string? | "TestComplete Automation" | Milestone name | | milestoneKey | string? | — | Existing milestone key | | createCases | boolean? | true | Auto-create missing test cases | | tag | string? | "testcomplete" | Tag applied to the test run |

How to export JUnit XML from TestComplete

1. Run your TestComplete project suite.
2. File > Export > JUnit XML Report — or use the CLI:

   tcDumpJUnit /results:"%TESTCOMPLETE_LOG%" /output:"TestResults\junit.xml"

3. Point resultsFile at the output file.

CI example

- name: Run TestComplete tests
  run: |
    "C:\Program Files\SmartBear\TestComplete\bin\TestComplete.exe" MyProject.pjs /run /exit
    tcDumpJUnit /results:"%TC_LOG_FILE%" /output:"TestResults\junit.xml"

- name: Upload to QA Touch
  run: npx ts-node upload-results.ts