jira-client-xray

An extended wrapper of the existing jira-client module, which adds support for the "Xray for Jira" Test Management plugin's REST API.

Installation

1$ npm install --save jira-client-xray

API

Create A Client

1var JiraApiWithXray = require('jira-client-xray');
2
3// Initialize
4var jira = new JiraApiWithXray({
5  strictSSL: true,
6  protocol: 'https',
7  username: 'username',
8  password: 'password',
9  host: 'jira.somehost.com',
10  base: 'jira',
11  xrayVersion: '1.0'
12});

The constructor options parameter is a superset of the jira-client module's constructor's options parameter. It contains all of those configuration options, plus the following additional properties:

• xrayVersion (string) - The REST API version of the "Xray for Jira" plugin. Defaults to '1.0'.

Import Test Execution Results

For deeper documentation, please view our ESDoc-generated documentation.

Response Schema

The HTTP response object (referred to as the "testExecIssueId" in all subsequent examples) returned from the Promise for each of the following import methods is as follows:

1{
2  "testExecIssue": {
3    "id": "10000",
4    "key": "DEMO-123",
5    "self": "http://www.example.com/jira/rest/api/2/issue/10000"
6  }
7}

Jira Issue Customization Request Schema

The JSON schema for the issueData parameter that is an optional part of some of these API calls is as follows:

Xray JSON

1jira
2  .importExecResultsFromXray(testExecResults)
3  .then(function(testExecIssueId) { /* ... */ });

Cucumber JSON

Results Only

1jira
2  .importExecResultsFromCucumber(testExecResults)
3  .then(function(testExecIssueId) { /* ... */ });

With JIRA Issue Customization

1jira
2  .importExecResultsFromCucumber(testExecResults, issueData)
3  .then(function(testExecIssueId) { /* ... */ });

Behave JSON

Results Only

1jira
2  .importExecResultsFromBehave(testExecResults)
3  .then(function(testExecIssueId) { /* ... */ });

With JIRA Issue Customization

1jira
2  .importExecResultsFromBehave(testExecResults, issueData)
3  .then(function(testExecIssueId) { /* ... */ });

JUnit XML

Results Only

1jira
2  .importExecResultsFromJUnit(testExecResults, query)
3  .then(function(testExecIssueId) { /* ... */ });

With JIRA Issue Customization

1jira
2  .importExecResultsFromJUnit(testExecResults, null, issueData)
3  .then(function(testExecIssueId) { /* ... */ });

TestNG XML

Results Only

1jira
2  .importExecResultsFromTestNG(testExecResults, query)
3  .then(function(testExecIssueId) { /* ... */ });

With JIRA Issue Customization

1jira
2  .importExecResultsFromTestNG(testExecResults, null, issueData)
3  .then(function(testExecIssueId) { /* ... */ });

NUnit XML

Results Only

1jira
2  .importExecResultsFromNUnit(testExecResults, query)
3  .then(function(testExecIssueId) { /* ... */ });

With JIRA Issue Customization

1jira
2  .importExecResultsFromNUnit(testExecResults, null, issueData)
3  .then(function(testExecIssueId) { /* ... */ });

Robot Framework XML

Results Only

1jira
2  .importExecResultsFromRobot(testExecResults, query)
3  .then(function(testExecIssueId) { /* ... */ });

With JIRA Issue Customization

1jira
2  .importExecResultsFromRobot(testExecResults, null, issueData)
3  .then(function(testExecIssueId) { /* ... */ });

License

Copyright (c) 2018, James M. Greene (MIT License)