Test Automation

URL: POST /api/v2/automation/import-test-results

This endpoint lets you upload a ZIP/TAR.GZ file with automated test results. Once the upload is successful, RTM creates a Test Execution issue with Test Case Executions for each test result.

Examples of API Calls

Using cURL in Bash

curl -X POST 'https://your-rtm-instance.com/api/v2/automation/import-test-results' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -F 'projectKey=PROJECT_KEY' \
  -F 'file=@/path/to/test-results.tar.gz' \
  -F 'reportType=JUNIT' \
  -F 'name=Example automated test execution'
  -F 'treePath=/Automatic/e2e/moduleA'
  -F 'jobUrl=https://ci.example.com/job/123' \
  -F 'testExecutionFields={ "fields": {"labels" : ["e2etest"]} }' \
  -F 'testCaseFields={"labels": ["automated", "regression"]}'

Using Node.js (Reading Environment Variables without dotenv)

Access environment variables directly using process.env in Node.js without the dotenv package, as long as the environment variables are set before running the script.

Setting Environment Variables

Set environment variables when running your Node.js script:

RTM_API_TOKEN=your-api-token PROJECT_KEY=your-project-key RTM_URL=https://your-rtm-instance.com node script.js

If you’re using Node.js 20 or later, you can also use the –env-file flag to load variables from a .env file:

node --env-file=.env script.js

Node.js Script:

const fetch = require('node-fetch');
const FormData = require('form-data');
const fs = require('fs');

// Read environment variables
const RTM_API_TOKEN = process.env.RTM_API_TOKEN;
const PROJECT_KEY = process.env.PROJECT_KEY;
const RTM_URL = process.env.RTM_URL;

// Validate that required environment variables are set
if (!RTM_API_TOKEN || !PROJECT_KEY || !RTM_URL) {
    console.error('Error: Missing required environment variables.');
    process.exit(1);
}

// Create the FormData object
const form = new FormData();
form.append('projectKey', PROJECT_KEY);
form.append('file', fs.createReadStream('/path/to/test-results.tar.gz')); // Update with the actual path to your file
form.append('reportType', 'JUNIT');
form.append('jobUrl', 'https://ci.example.com/job/123');
form.append(
    'testExecutionFields',
    JSON.stringify({
        fields: {
            summary: 'Automated Test Execution',
            description: 'Imported from CI',
        },
    })
);
form.append(
    'testCaseFields',
    JSON.stringify({
        fields: {
            labels: ['automated', 'regression'],
        },
    })
);

// Send the POST request using fetch
fetch(`${RTM_URL}/api/v2/automation/import-test-results`, {
    method: 'POST',
    headers: {
        Authorization: `Bearer ${RTM_API_TOKEN}`, // Use the API token from environment variables
        ...form.getHeaders(), // Include headers from FormData
    },
    body: form, // Set the body to the FormData object
})
    .then((response) => {
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status} - ${response.statusText}`);
        }
        return response.json(); // Parse the JSON response
    })
    .then((data) => {
        console.log('Import Task ID:', data); // Log the response
    })
    .catch((error) => {
        console.error('Error:', error.message);
    });

Example of using .env File with Node.js 20

If you’re using Node.js 20 or newer and want to load environment variables from a .env file:

• Create a .env file in your project directory:

RTM_API_TOKEN=your-api-token
PROJECT_KEY=your-project-key
RTM_URL=https://your-rtm-instance.com

• Run your script with the –env-file flag:

node --env-file=.env script.js

Using Python

import requests
url = 'https://your-rtm-instance.com/api/v2/automation/import-test-results'
headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN'
}
files = {
    'file': open('/path/to/test-results.zip', 'rb')
}
data = {
    'projectKey': 'PROJECT_KEY',
    'reportType': 'JUNIT',
    'jobUrl': 'https://ci.example.com/job/123',
    'testExecutionFields': '{"summary": "Automated Test Execution", "description": "Imported from CI"}',
    'testCaseFields': '{"labels": ["automated", "regression"]}'
}
response = requests.post(url, headers=headers, files=files, data=data)
print('Import Task ID:', response.json())

URL: GET /api/v2/automation/import-status/{taskId}

This endpoint lets you check the status of an import task using the task ID obtained from the initial import request.

Examples of API Calls

Using cURL in Bash

curl -X GET 'https://your-rtm-instance.com/api/v2/automation/import-status/{taskId}' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Using JavaScript

const taskId = 'your-task-id'; // Replace with your actual task ID
const apiUrl = `https://your-rtm-instance.com/api/v2/automation/import-status/${taskId}`; // Update the base URL if necessary

fetch(apiUrl, {
    method: 'GET',
    headers: {
        Authorization: 'Bearer YOUR_API_TOKEN', // Replace with your actual API token
    },
})
    .then((response) => {
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        return response.json(); // Parse the JSON response
    })
    .then((data) => {
        console.log('Import Status:', data); // Log the response data
    })
    .catch((error) => {
        console.error('Error:', error.message);
    });

Using Python

import requests

task_id = 'your-task-id'
url = f'https://your-rtm-instance.com/api/v2/automation/import-status/{task_id}'
headers = {
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.get(url, headers=headers)
print('Import Status:', response.json())