JiraSupport Extension for TestComplete

About

You use the JiraSupport extension to create and update Jira issues and attach files to them directly from your TestComplete tests. After you install the extension to TestComplete, you will get the Jira object that has methods for creating and updating Jira issues.

Requirements

• Atlassian Jira Server ver. 5.0 - 7.12 or Jira Cloud.
• To attach files to issues in Jira, their issue type must allow attachments.

Installation

1. Download the GitHub repository to the computer where TestComplete is installed.

2. Double-click the build.bat file from the downloaded repository. It will create the installation file (\out\JiraSupport.tcx).

3. Double-click the JiraSupport.tcx file. This will invoke the Installing Extension dialog that displays the target installation folder. Click OK to install the extension into TestComplete.

4. In TestComplete, select File > Install Script Extensions from the main menu. In the subsequent Script Extensions dialog, click Reload to update the list of available script extensions.

5. Select Runtime Objects > Jira Object to enable the installed extension:

   Click OK to save the changes.

Usage

// JavaScript

// Create a Task item in Jira
function IssueToJira()
{
  // Log in to Jira
  Jira.Login("https://mycompany.atlassian/net", "John.Smith@mycompany.com", "c40Mwj3PovmZPFZbmIiwB8C6"); 
  // Create an object that defines task properties
  var jiraData = Jira.CreateNewIssueData("MyJiraProjectKey", "Task").
                         setField("summary", "This is a sample task summary").
                         setField("description", "Sample task description").
                         setField("customfield_10700", "Normal"); 
  // Post the issue to Jira
  var key = Jira.PostIssue(jiraData);
}

Important: To interact with Jira custom fields, use their identifiers instead of the field names. In the code above, it is customfield_10700.

To call this function from keyword tests, use the Run Code Snippet operation.

Methods

Method	Description
Login(URL, Login, Password)	Logs in to Jira.
CreateNewBugData(ProjectKey, Assignee, Priority, Summary, Description)	Creates an object that has data for creating a Jira issue of the Bug type.
CreateNewIssueData(ProjectKey, IssueType)	Creates an object that has data for creating a Jira issue of any type available in your Jira project.
PostIssue(NewIssueData)	Creates a new issue in Jira.
CreateUpdateIssueData()	Creates an object that has data for updating a Jira issue.
UpdateIssue(IssueKey, UpdateIssueData)	Updates an existing issue in Jira.
PostAttachment(IssueKey, FileName)	Attaches a file to the specified Jira issue.

More Information

For complete information on using the extension and Jira integration, see the TestComplete documentation.