Configuration

NodeConductor can integrate with Atlassian JIRA to provide support to the end-users.

Expected structure for the JIRA project is as follows:

  • Existing issue type: Support Request (must be default issue type for the project)
  • Custom fields:
    • Impact, type: Text Field (single line)
    • Original Reporter, type: Text Field (single line)

Expected permissions:

Permission Permission code
Add Comments COMMENT_ISSUE
Edit Own Comments COMMENT_EDIT_OWN
Browse Projects BROWSE

WebHook Setup

It’s possible to track updates of JIRA issues and apply them to NodeConductor immediately.

An instruction of JIRA configuration can be found at https://developer.atlassian.com/jiradev/jira-apis/webhooks

WebHook URL should be defined as http://nodeconductor.example.com/api/jira-webhook-receiver/ and following events enabled:

  • issue created
  • issue updated
  • issue deleted

Example Setup

1. Create support service

POST /api/jira/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Authorization: Token c84d653b9ec92c6cbac41c706593e66f567a7fa4
Host: example.com

{
    "name": "JIRA Support",
    "customer": "http://example.com/api/customers/eea999ddf31540aea6bd4f591aa353d1/",
    "backend_url": "https://jira.example.com/",
    "username": "username",
    "password": "password",
    "available_for_all": false
}

2. Import support project

Make sure custom fields configured properly and “available_for_all” property is set to true.

POST /api/jira/a2f322fed8c444fab48547f595b34279/link/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Authorization: Token c84d653b9ec92c6cbac41c706593e66f567a7fa4
Host: example.com

{
    "backend_id": "SPT",
    "project": "http://example.com/api/projects/e63838e3e68f4fc4aa39617b7550cef3/",
    "impact_field": "Impact",
    "reporter_field": "Original Reporter",
    "default_issue_type": "Support Request",
    "available_for_all": true
}

3. Perform support actions

Please use a project created about to post issues.