Rocketlane’s Jira Integration allows you to create and sync Jira issues for your Rocketlane tasks. This helps your onboarding and engineering teams to communicate and collaborate without having to leave the systems they use everyday.

Create Jira issues, get notified of status changes and talk to your Jira team, all from within Rocketlane.

Integrating Jira with Rocketlane

1. Click Settings from the panel on the left side of the screen.
   
   
   
   
2. Go to Integrations.
   
   
   
   
   
3. Choose Jira.
   
   
   
   
4. You will be redirected to the Jira Integration page. Click on 'Login to Jira' to authenticate the Integration. 
   
   
   
   
5. You will be asked to authenticate the integration. Click Accept.
   
   
   
   
6. If you have successfully integrated your JIRA account, you will be redirected to the JIRA Integration page in Rocketlane.
   
   
   

Rocketlane's Jira Integration 

Once you have successfully integrated JIRA with Rocketlane, lets talk about the features of this integration.

Choose a Jira project

• Choose relevant Jira project while issue creation
  
  Lets you choose a Jira project when you create an issue.
  
  
  
• Create all issues under selected Jira project
  
  Lets you choose a single project under which all issues will be added in Jira.

Sync Status Field

Note: Jira issues can be corresponded with Rocketlane tasks.

Once this field is checked, Rocketlane will update its task status as the linked Jira issue status changes.

The terminologies used in a Jira status category and Rocketlane status field can be mapped as follows:

Sync custom Jira Issue status to Rocketlane task status

You can map custom Jira Issue status to Rocketlane task status and sync status updates from Jira to Rocketlane.

Sync due dates from Jira to Rocketlane

Automatically updates the due date of the Rocketlane task if the due date of Jira is updated.

Sync Comments Between Jira and Rocketlane

Comments made on Jira issues will appear as a private messages on linked Rocketlane tasks. Your team will also be able to send comments to Jira.

Creating a Jira Issue for a Rocketlane Task

Create a Jira Issue

1. Go to your project and select the task you want to create a Jira issue for.
   
   
   
   
2. Click on the 'More actions' button from the task controls and select 'Create a Jira issue'.
   
   
   
   
3. You will be redirected to the 'New Jira Issue' dialog box.
   
   
4. Click the Create button after you have customised the fields for your Jira issue.

New Jira Issue Dialog Box

Note: Jira fields from your Jira account which are necessary to create a new Jira issue will be automatically added to the 'New Jira issue' dialog box.

Project

Select the name of the Project where you want your Jira issue to be created in.

Issue Type

Select the Jira Issue Type from Story, Task or Bug.

Epic

Choose a Jira Epic from the list. A Jira Epic is a larger group of Jira issues combined together.

Summary

The summary of the issue is auto populated with the name of the task.

Description

The description of the issue is auto populated with the description of the task.

Reporter

The reporter is the team member who raises the issue.

Assignee

Assign a team member to resolve the Jira issue.

Linking a Jira Issue to a Rocketlane Task

1. Go to your project and select the task you want to create a Jira issue for.
   
   
2. Click on the 'More actions' button from the task controls and select 'Link a Jira issue'.
   
   
   
   
3. Paste the url for the Jira issue in the 'Jira issue url' section and click on the 'Link a Jira issue button'.
   
   
   

Rocketlane's Tasks as Jira Issues: Functionalities

As soon as you link create a new Jira issue or link one with a Rocketlane task, the Jira issue will be visible on the task pane under the Jira section.

You can view the issue Summary, Status, Priority and Assignee.

Click on the Jira issue and you will be redirected to the Jira portal.

Unlink Jira Issue

Lets you unlink the Rocketlane task with the associated Jira Issue. 

The Jira issue and the Rocketlane task do not cease to exist.

Go to More actions > Unlink Jira Issue.

Unlink and Delete Jira Issue
 

Lets you unlink the Rocketlane task with the associated Jira Issue and the Jira issue is deleted.

Go to More actions > Unlink and delete Jira Issue.

Syncing Jira and Rocketlane Comments 

Rocketlane to Jira comment sync

You can add a comment from Rocketlane that will be reflected for your Jira issue on the Jira portal. 

• Click on the  'Add comment in Jira' button.
  
  
• Type your comment in the text box and click the 'Send comment' button.
  
  
• You can view the comment on your Jira portal.
  
  

Jira to Rocketlane comment sync

The same applies for comments made on the Jira portal which reflect in the Rocketlane's Task conversations section.

• Go to the Jira issue on the Jira portal. In the comments section add your comment and click Save.
  
  
  
  
• You can view the comment in the Conversations section of your task.
  
  
  

Jira settings for Project Templates

In project templates you can configure for which project tasks should we create and sync Jira issues. When a project is created out of the templates, the Jira issues for the corresponding task will be automatically created as well.

1. Go to Templates > Project Templates.
   
   
2. Choose a template and click on the task you want to add a Jira issue for.
   
   
   
   
   
3. Go to the 'Jira details' section. To get started with linking a jira issue for the tasks, mark the 'Create a Jira issue for this task' checkbox.
   
   
   
   
   
4. Edit the fields for the 'Jira details' and click Save from the top right corner of the screen.

Hey! Here's hoping that this support document was useful. You can write to us at [email protected] in case of any queries.