JIRA Integration From .NET

A quick note on JIRA (if you don't know already) - It is used for bug tracking, issue tracking, and project management. The name "JIRA" is actually inherited from the Japanese word "Gojira" which means "Godzilla". The basic use of this tool is to track issues and bugs related to your software and Mobile apps. Reference link.

It is assumed you already have a JIRA environment setup (on-premises or cloud). For this sake of this article, we will be integrating with the cloud version but the same code will work for on-premises JIRA. For authentication to JIRA, we have 2 options 1) Passing username and password of valid JIRA user 2 ) Passing username and valid API token of Valid Jira User.

The second option is recommended because very soon the JIRA team is going to stop support for plain password authentication, so here we will do using 2nd option.

To generate an API token, refer to this link.

JIRA Setup

Project - DEM

Create 2 custom fields,

DROPDOWNCUSTOMFIELD : Type - Dropdown, Possible Value - India, USA, Canada
CUSTOMFIELDTEXT : Type - Text (free field)

Solution Setup

Created an ASP.NET application.
Added button 'Create Issue'
Added 2 File Upload Control, to save multiple attachments.
Added a simple label to show success/failure(hidden on page load)

UI would look something like this.

Let us start adding supporting methods.

Step 1

Create local variables to store username and API token and Jira URL(of our organization),

private string UserName = "[email protected]";
private string Password = "gdHlWI0PKoNlCCLzNzM0B22A";
private string Url = "https://wayneenterprise.atlassian.net/";

Password here is API token, generated using this link.

Step 2

Encoded credentials.

public static string GetEncodedCredentials(string UserName, string Password)
{
string mergedCredentials = String.Format("{0}:{1}", UserName, Password);
byte[] byteCredentials = Encoding.UTF8.GetBytes(mergedCredentials);
return Convert.ToBase64String(byteCredentials);
}

Step 3

Method to create Issue,

public void AddJiraIssue() {
try {
string JsonString = @ "{"
"fields"
" : {
""
project "": {
""
key "": ""
DEM ""
},
""
summary "": ""
Demo Jira from C#.NET "",
""
description "": ""
Demo Jira from C#.NET "",
""
issuetype "": {
""
name "": ""
Bug ""
},
""
customfield_10028 "": ""
Value that we 're putting into a Free Text Field."",
""
customfield_10027 "": {
""
value "": ""
India ""
}
}
}
";
string restUrl = String.Format("{0}rest/api/2/issue/", Url);
HttpWebResponse response = null;
HttpWebRequest request = WebRequest.Create(restUrl) as HttpWebRequest;
request.Method = "POST";
request.Accept = "application/json";
request.ContentType = "application/json";
request.Headers.Add("Authorization", "Basic " + Utility.GetEncodedCredentials(UserName, Password));
byte[] data = Encoding.UTF8.GetBytes(JsonString);
using(var requestStream = request.GetRequestStream()) {
requestStream.Write(data, 0, data.Length);
requestStream.Close();
}
using(response = request.GetResponse() as HttpWebResponse) {
if (response.StatusCode == HttpStatusCode.Created) {
var reader = new StreamReader(response.GetResponseStream());
string str = reader.ReadToEnd();
Console.WriteLine("The server returned '{0}'\n{1}", response.StatusCode, str);
var jss = new System.Web.Script.Serialization.JavaScriptSerializer();
var sData = jss.Deserialize < Dictionary < string,
string >> (str);
string issueKey = sData["key"].ToString();
showSuccess("Issue created sucessfully.");
AddAttachments(issueKey);
} else {
showError("Error returned from Server:" + response.StatusCode + " Status Description : " + response.StatusDescription);
}
}
request.Abort();
}
catch (Exception ex) {
showError("Exception:" + ex.Message);
}
}

Note

We are creating issueType as Bug,
We need to pass custom fields with id, this id can be retrieved from URL.

Go to Settings->Issues->CustomFields, we will see a list of all fields here. Edit the Target field and it will open below the page. Get Id from query string parameter.

For field type like dropdown, checkbox, radio button, we need to pass value in json object like below

"customfield_10027":{
"value" : "India"
}

You should refer to the below link to see different REST API examples provided at JIRA documentation.

https://developer.atlassian.com/server/jira/platform/jira-rest-api-examples/

In response to this web request, we will get issue key(id) which will be used further to add attachments.

Please note, we don't have any endpoint directly which creates tickets and adds attachments in a single request hence we have to make 2 separate calls.

Step 5

Add a custom model(class) to hold the file name and its content.

class JiraFile
{
public string FileName { get; set; }
public Stream Stream { get; set; }
}

Step 6 - Add the Attachments method

In this method, we will use Stream of FileUpload control to get file contents in memory and then upload directly to JIRA. This will make sure we don't have to store file at Server as we are posting file to JIRA from server-side

public void AddAttachments(string issueKey)
{
string restUrl = String.Format("{0}rest/api/2/issue/{1}/attachments", Url, issueKey);
List<JiraFile> lstStream = new List<JiraFile>();
if (FileUpload1.HasFile)
{
lstStream.Add(new JiraFile() { FileName = FileUpload1.FileName, Stream = FileUpload1.PostedFile.InputStream });
}
if (FileUpload2.HasFile) {
lstStream.Add(new JiraFile() { FileName = FileUpload2.FileName, Stream = FileUpload2.PostedFile.InputStream });
}
if (lstStream.Count > 0)
{
PostFile(restUrl, lstStream);
}
}

Step 7

Making post request to JIRA API to add attachments,

private void PostFile(string restUrl, List<JiraFile> lstStream)
{
HttpWebResponse response = null;
HttpWebRequest request = null;
String boundary = String.Format("----------{0:N}", Guid.NewGuid());
var stream = new MemoryStream();
var writer = new StreamWriter(stream);
foreach (var file in lstStream)
{
var data = new byte[file.Stream.Length];
file.Stream.Read(data, 0, data.Length);
file.Stream.Close();
writer.WriteLine("--{0}", boundary);
writer.WriteLine("Content-Disposition: form-data; name=\"file\"; filename=\"{0}\"", file.FileName);
writer.WriteLine("Content-Type: application/octet-stream");
writer.WriteLine();
writer.Flush();
stream.Write(data, 0, data.Length);
writer.WriteLine();
}
writer.WriteLine("--" + boundary + "--");
writer.Flush();
stream.Seek(0, SeekOrigin.Begin);
request = WebRequest.Create(restUrl) as HttpWebRequest;
request.Method = "POST";
request.ContentType = string.Format("multipart/form-data; boundary={0}", boundary);
request.Accept = "application/json";
request.Headers.Add("Authorization", "Basic " + Utility.GetEncodedCredentials(UserName, Password));
request.Headers.Add("X-Atlassian-Token", "nocheck");
request.ContentLength = stream.Length;
using (Stream requestStream = request.GetRequestStream())
{
stream.WriteTo(requestStream);
requestStream.Close();
}
using (response = request.GetResponse() as HttpWebResponse)
{
if (response.StatusCode != HttpStatusCode.OK)
{
var reader = new StreamReader(response.GetResponseStream());
Console.WriteLine("The server returned '{0}'\n{1}", response.StatusCode, reader.ReadToEnd());
}
}
request.Abort();
}

Step 8

Add methods to show success and failure.

private void showError(string text)
{
lblStatus.Text =text;
lblStatus.ForeColor = System.Drawing.Color.Red;
lblStatus.Visible = true;
}
private void showSuccess(string text)
{
lblStatus.Text = text;
lblStatus.ForeColor = System.Drawing.Color.Green;
lblStatus.Visible = true;
}

Now we have everything we need, so let us run (press F5).

Select files and click on 'Create Issue',

Let us go to Jira and see a newly created issue. If you see all the fields which are marked with numbers are the fields which we populated from our code.

Conclusion

Modern web development is now mostly based on REST API integration, it is a must-have skillset for developers to understand how to make REST calls. Products nowadays expose their API via REST for cross-platform integration. If we know the basics of how to call this REST API, we can integrate our code/custom application with any products which have exposed via web services or SDK. We should be referring to product developer documentation to understand what parameters are required to pass and what will be returned in the response. This article demonstrates one such use about integration JIRA software from our custom application. For advanced integration of JIRA, refer to its documentation at this link.

I hope you enjoyed reading...happy coding!!!

11 Comments

Join the conversation! Your thoughts help the community grow.

chinna g5y ago
Hi if possible could you Please share the source code
Swapna Nethi5y ago
Hello Sid, Can you give me a complete example like this for GET request as well? I am new to this and ours is Jira Server.
swatantra singh6y ago
Great Article Sid. Ideal for someone who wants to get things going... Need some help I keep getting error "The request was aborted: Could not create SSL/TLS secure channel."
- swatantra singh6y ago
  Is this project file available on GIT?
Bo Starke6y ago
Hi Siddharth, nice article - i enjoyed it. do you have any example code that would demonstrate how to update a jira issue (1 custom field) using the rest API? I wrote a C# application that does this using the Chilkat API, but my trial period has since elapsed http://rest-examples.chilkat.io/jira_-_issues/csharp/chilkat_171.cshtml
- Siddharth Vaghasia6y ago
  Hey....I think in this article itself I have provided way to update the custom field.... can you pleas check.
Chandana M6y ago
Thank you so much.Nice explanation and useful stuff too.
krimesh raiyani6y ago
Thank you for sharing
Pritesh Maturkar6y ago
It very Usefully. Thank you for sharing.
Rushi Mehta6y ago
Wow, Nice technically explained..Thanks for sharinfg
Ankur Mistry6y ago
Wow useful stuff