Meliora Testlab Integration API

Meliora Testlab Integration API offers REST/JSON-based integration interfaces over HTTP protocol. API can be used as a two-way integration point to integrate other systems.

 

How it works

apikuva

Meliora Testlab Integration API offers HTTP based endpoints which returns JSON encapsulated data. To call the endpoints, a valid API key must be included in accordance to basic auth authentication scheme. To access documentation on available endpoints, please see

    https://yourtestlab.melioratestlab.com/api

The link provides a live Swagger based documentation which you can use to make actual API calls to your Testlab instance.

 

How to get started

To call the endpoints, an API key must be configured to your Testlab instance. To configure an API key, log into your Testlab as an administrator and go to Testlab > Manage company… > API keys and add a new key. Please, take note of your API key when you register one as the key is hash encoded to the database with no way of recovering it after save your changes.

With your browser, go to https://yourtestlab.melioratestlab.com/api (or, applicable url in your own Testlab installation) and familiarize yourself to the offered endpoints and parameters required. Please note, that you can use the forms provided by the live documentation to make actual calls to your Testlab installation. For this to work, you must authenticate with the API key you have registered by entering it to the field in upper right corner and pressing “Authenticate”.

For the actual integration, implement some program code as a REST client for chosen endpoints. For technical guidelines followed and programming examples, please see below.

 

API guidelines

The REST endpoints offered follow the API guidelines as:

  • Requests and responses are in JSON format
  • All assets are identified with a numerical “id” identifier
  • Some fields are returned encoded as numerical values (Such as Test case / priority): For documentation on these values please see Webhooks / JSON payload documentation page.
  • Timestamps are in Epoch time with millisecond accuracy (“milliseconds elapsed since January 1st 1970 00:00:00 UTC”)
  • Resources are representational with HAL-compliant _links provided. The following link relations are currently in use (all optional):
    • self: link to the current item
    • swagger: link to the applicable online documentation (to this Swagger)
    • collection: link to the applicable collection the item belongs to
  • HAL: No _embedded resources are used – all data including related items (if any) are returned in response body instead
  • The JSON responses can be formatted in pretty human-readable format by appending a “pretty” parameter to the URI

 

Programming examples

 

Node.js – get issues from Testlab

The following simple Node.js based example makes a call to your Testlab and lists all issues from the Demo project. Download the source file -> get_issues_from_testlab.js.

//
// Simple nodejs example to fetch all issues from a Testlab project
//
// requires https://www.npmjs.com/package/node-rest-client, to install run
//
// # npm install node-rest-client
//

var Client = require('node-rest-client').Client;

var companyId = 'mycompany',
apiKey = '1234567890123456';

client = new Client({ user: companyId, password: apiKey });

client.registerMethod(
"getProjectIssues",
"https://" + companyId + ".melioratestlab.com/api/defect/${project}",
"GET"
);

client.methods.getProjectIssues({
path: { "project" : "TLABDEMO" },
parameters: { closed: "true", resolved: "true" }
}, function(issues, response) {
issues.forEach(function(i) {
console.log('Testlab issue ' + i.defectId + " - " + i.title);
});
});

 

Note: As explained in comments, to run the above example please install the node-rest-client dependency. In addition, remember to configure your companyId and apiKey at the beginning of the script.

# npm install node-rest-client
# node get_issues_from_testlab.js
Testlab issue TLABDEMO-1 - Removing all items for a product does not show confirmation dialog
Testlab issue TLABDEMO-2 - Customer's e-mail address is not validated correctly
...

 

Node.js – push XUnit testing results to Testlab project

The following Node.js based program posts XUnit/JUnit compatible automated results to Testlab project. Download the source file -> post_results_to_testlab.js.

//
// Simple nodejs example to push xunit results to Testlab
//
// requires node-rest-client and optimist, to install run
//
// # npm install node-rest-client
// # npm install optimist
//

XML_FILE_ENCODING = 'utf8';

// configure these to match your environment
var companyId = 'mycompany',
apiKey = 'mysecretapikey';
var url = "https://" + companyId + ".melioratestlab.com/api/testresult";

var args = require('optimist').boolean('i').boolean('s').boolean('o').boolean('t').argv;
if(args._.length == 0 || args.h || args.help || !args.p || !args.f || !args.r) {
console.log(
args.$0 + ' -- post test results to Meliora Testlab\n\n' +
'usage: ' + args.$0 + ' -p <project key> -f <test case mapping field> -r <test run title> [-c <test run comment>] [-u <test run user>] [-m <test run milestone>] [-v <test run version>] [-e <test run environment>] [-i] [-s] [-o] [-a <user to assign issues for>] xunit-results-file.xml\n\n' +
' -h print this usage\n' +
' -p key of the project in Testlab to push the results to\n' +
' -f title of the custom field in the project to use for mapping results to project\'s test cases\n' +
' -r title for the test run\n' +
' -c comment for the test run (optional)\n' +
' -u name of the user to create the test run with (optional)\n' +
' -m milestone to target the test run with (optional)\n' +
' -v version to target the test run with (optional)\n' +
' -e environment to target the test run with (optional)\n' +
' -i add issues for failed test cases ? (default: no)\n' +
' -s merge all failed test cases to a single issue ? (default: no)\n' +
' -o try to reopen existing issues ? (default: no)\n' +
' -a user to assign the opened issues for (optional)\n' +
' -t automatically create (by mapping identifier) missing test cases to Testlab (default: no)\n' +
' -x test category path where to automatically create test cases to (default: Import)\n\n' +
'Results for test cases should be provided in a XML file in JUnit compatible format.\n\n' +
'For example:\n\n' +
'<testsuite name="MyTestSuite" tests="2" failures="1" timestamp="2014-09-11T14:37:37+02:00">\n' +
' <testcase classname="cart.test" name="EventLogTest" time="2331">\n' +
' <failure message="False was not true" type="java.lang.AssertionError">java.lang.AssertionError: False was not true ...</failure>\n' +
' </testcase>\n' +
' <testcase classname="cart.test" name="SubmitOrderTest" time="1121"/>\n' +
'</testsuite>\n\n' +
'Format is widely used in unit testing and functional testing frameworks.'
);
process.exit(0);
}

// read xml file
var inputFile = args._[0];
var fs = require('fs');
var xml = fs.readFileSync(inputFile, XML_FILE_ENCODING);

var Client = require('node-rest-client').Client;
client = new Client({ user: companyId, password: apiKey });
client.registerMethod("putTestResult", url, "PUT");

var data = {
"status": "3",
"projectKey": args.p,
"testRunTitle": args.r,
"testCaseMappingField": args.f,
"xml": xml
};

if(args.c) data.comment = args.c;
if(args.u) data.user = args.u;
if(args.m) { data.milestoneIdentifier = args.m; data.milestoneTitle = args.m; }
if(args.v) data.testTargetTitle = args.v;
if(args.e) data.testEnvironmentTitle = args.e;
if(args.i) data.addIssues = 'true';
if(args.s) data.mergeAsSingleIssue = 'true';
if(args.o) data.reopenExistingIssues = 'true';
if(args.a) data.assignIssuesToUser = args.a;
if(args.t) data.importTestCases = 'true';
if(args.x) data.importTestCasesRootCategory = args.x;

console.log('\nPUT to ' + url + ' as:');
console.log(data);

client.methods.putTestResult({
headers: { "Content-Type": "application/json" },
data: data
}, function(data, response) {
// on success, we get returned with the id of the created/updated test run
console.log('\nGot response:');
console.log(data);
});

 

The example above depends on node-rest-client and optimist packages, so run the example as:

# npm install node-rest-client
# npm install optimist
# node post_results_to_testlab.js ...args...

 

Some examples on how to use this example are below. You should have your JUnit results in a file named myresults.xml to try the examples below. Before running the example please remember to configure your companyId and apiKey at the beginning of the script.

  • # node post_results_to_testlab.js -h

    Prints out the help on how to set the arguments for the script.

  • # node post_results_to_testlab.js -p TLABDEMO -r "My test run" -f "Automated" -t -x "Test Import" myresults.xml

    Log in to Testlab, go to “Test Execution” view and note that a new run “My test run” has been added and new test cases have been created to a test category “Test Import”. 

  • # node post_results_to_testlab.js -p TLABDEMO -r "My test run" -f "Automated" -t -x "Test Import" -i -s -o myresults.xml

    As above, but an issue should be created for failing test cases in your results if any.

 



 
 
Best-of-class cross-browser hosted SaaS quality and test management, testing and issue management tools to improve your quality. Site information.