Zephyr Api

A simpified wrapper for making common zephyr for jira cloud api calls. This package uses native promises so all calls are thenable.

Install:

npm install zephyr_api

Auth: Save credential variable as gloabl var to be used by the module:

global.__ZAPIcreds = [process.env.ZAPI_ACCESS_KEY, process.env.ZAPI_SECRET_KEY, process.env.ASSIGNEE];

Require the module:

const ZAPI = require('zephyr_api');

Then use the available funtions :

Get a cycleId from a cyleName

ZAPI.getCycleIdFromCycleName(jiraProjectId: '156478', jiraProjectVersion: '45678', cycleName: 'myTestCycle');

Get a list of all cycles

ZAPI.getAllCycles(jiraProjectId: '45678', jiraProjectVersion: '45675');

Perform a zephyr test search

Pass in the query as a string. ZQL ref

let string = 'project=14598 AND issuetype=Test AND labels=RegressionTests';
ZAPI.zqlSearch(query: string);

Create a new cycle

The cycleId parameteter is optional and allows you to copy cycle info from an existing cyle.

let bodyData = {
    'name': `Name of your test cycle`,
    'build': 'Latest Build',
    'environment': 'dev',
    'description': `Enter your cycle description here`,
    'startDate': Date.now(), // or w/e you want
    'endDate': Date.now() + 600000,  // or w/e you want
    'projectId': yourProjectId,
    'versionId': yourVersionId
};
ZAPI.createNewCycle(body: bodyData, cycleId: '5458678945264654643524685764654');

Create a new execution

ZAPI.createExecution(cycleId:'45676456456484688945465446' , projectId: '14578', versionId: '14578', issueId: '15623', testStatus: '0', assignee: '[e-mail]');

Get execution statuses

These are the pass / fail statuses

ZAPI.getExecutionStatuses();

Get execution info

ZAPI.getExecutionInfo(issueId: '14578', projectId: '12345', cycleId: '123121245644456677', executionId: '545645465465489756487');

Get test steps for a given test

ZAPI.getTestSteps(issueId: '14578', testId: '12345', projectId: '12356');

Update a step result

ZAPI.stepResultUpdate(stepResultId: '1654612368546454', issueId: '12345', executionId: '45648676545263567456', status: '0');

Update a test step

ZAPI.testStepUpdate(testStep: 'User logs in', testData: 'User Credentials', expectedResult: 'User is able to log in', stepNum: '1', testId: '12345', projectId: '12356');

Delete all steps for a given test

Note: this does an api call for each step

ZAPI.deleteAllTestSteps(testId: '12345', projectId: '45678');

Get server info

ZAPI.getServerInfo();

Get license info

ZAP.getLicenseInfo();

Get general info

ZAPI.getGeneralInfo();

Get a cycles issue ids

ZAPI.getCyclesIssueIds(cycleId: string, versionId: string, projectId: string);

Reference

A lot of the ids above have similar names. Here are some examples of where to find these ids.

jiraProjectId - You can get this from the Jira API , https://docs.atlassian.com/jira/REST/cloud/#api/2/project-getAllProjects For example a GET on https://company.atlassian.net/rest/api/2/project

jiraProjectVersion - Once you get the project Id from the above call you can append it to the same url to get the different versions: For example a get on https://company.atlassian.net/rest/api/2/project/14578

cycleId - User the provided funciton above to convert the name to an id or use the provided get all cylces and parse the results to grab the id.

issueId - You can get this from the Jira API , https://docs.atlassian.com/jira/REST/cloud/#api/2/issue For example a GET on https://company.atlassian.net/rest/api/2/issue/AOE-1234

executionId - From calling the getExecutionsStatuses above

stepResultId - From having the result of an execution id and getting that execution info

Prereq: node 6.10+