Jira
Last updated
Last updated
Integrating Luna with Jira allows you to import your Jira issues and keep them in sync in Luna bi-directionally. Linking your epics to launches in Luna will 1) give visibility to all stakeholders about upcoming launches and 2) allow you to save hours on reporting, by keeping Jira and Luna in sync.
You can connect to Jira on any of the following pages:
Sign up flow
Create a new launch page
Settings >> Integrations page
By clicking on “link” on any of these pages, you will be redirected to the Jira oAuth flow, during which you will consent to the permission scope required by the integration.
The connection between Jira and Luna is a workspace to workspace connection. It’s enough for one user (preferably admin) to connect to Jira, for all users to be able to leverage the connection in Luna.
If Jira doesn’t allow you to proceed with the permission flow, then your IT team will have to whitelist Luna.
In the ‘Settings >> Integrations’ page, click on the Jira box to access all workspace configuration settings. In that page, you can configure Jira for your launches and milestones, separately.
At the workspace level, you can choose the where (Jira project) and in which form (issue type) a launch or milestone can be pushed in Jira.
For each field mapping, you can configure the workspace level syncing settings:
Sync from Jira to Luna only.
Synd from Luna to Jira only.
2-way sync.
All Jira configurations will cascade in the following order:
Workspace level: any template or launch created will inherit workspace level Jira configurations.
Template level: all launches created using the corresponding template, will inherit the template level Jira configuration.
Launch level: all configurations will be proper to that launch.
Note: New configurations are not applied to activities done previously. They only apply to activities performed after the configurations are set.
As a user, you can import any issue that is part of a project, such as: initiative, epic, story, task and bug. We recommend you to import issues which need some level of cross-functional and vertical collaboration and visibility.
Click on ‘+ New launch’ → Jira import:
If you import one issue → you will be redirected to the launch detail page (LDP) of the imported issue
If you import more than one issue → you will be redirected to to the All Launches page, which will display the issues you have imported
If you have previously created launches that were not imported from Jira, you can still link this existing launch to a Jira issue.
In the LDP, click on hamburger menu >> Link launch
While importing issues from Jira, you can link one or more issues to a Luna template. This will allow you to create a more complete and streamlined launch, taking into consideration Jira data complemented with pre-defined modules in the template.
When created, launch data will either come from the Jira issue (data mapping table) or from the template. Some fields clash between the two sources, here’s the import logic:
Summary
The summary section will consist of both the template and the Jira issue summaries.
After creation, the summary section will remain in sync with the Jira issue description, whenever a change is made.
Labels
Labels will be added from both the Jira issue and the template.
After creation, labels coming from Jira will sync as per the above mapping. Labels coming from the template will not be impacted.
Stages
Stages will consist of both template stages and Jira statuses. These stages can be reordered and recategorised into the correct Luna category in Settings >> Stage management
The following fields will get imported in Luna and will stay in sync:
Hamburger menu
Key
Title
Summary
Summary
Description
Owner
- If no assignee in Jira, then owner is the person importing the issue
Assignee
Actual launch date
- If no due date in Jira, then launch date is this quarter’s import date
Due Date or Project target date
Actual start date
Start date or Project start date if not available then Issue creation date
Prio
Low = Lowest, Low
Medium = Medium
High = Highest, High
Priority
Hamburger menu
URL
Stage
Status
Labels
Labels
Label
Fix version
Label
Sprint
Label
Goal
Label
Product area
As a user, you can link your Jira issues to new or existing Luna milestones.
Create new milestones by importing one or more Jira issues into Luna.
Click on the “Import from Jira” CTA, in the milestones module.
From the Jira importer window, choose the Jira issue to import as milestone.
Click on the “Link milestone” CTA in the hamburger menu of an existing milestone.
From the Jira importer window, choose the Jira issue to link to the existing milestone.
Milestones data will remain in sync with any changes made to their linked issue, in Jira.
The following fields will get imported in Luna and will stay in sync with the milestones fields:
Hamburger menu
See details
Name
Summary
Owner
- If no assignee in Jira, then owner is the person importing the issue
Owner
Actual Target date
Due Date or Project target date
Actual start date
Start date or Project start date if not available then Issue creation date
Stage
Status
Child issues
List of linked child issues
At the LDP level, you can push the launch or milestone information as an issue in Jira:
Jira configs: define the Jira project and issue type that will be created in Jira.
Click on the ‘Push to Jira’ at the launch or milestone level.
The corresponding issue will be created in Jira and linked with the Luna launch or milestone. Syncing will be performed according to the defined configuration.
At the template or LDP level, you can define workflows what will automatically push the launch or milestone information as an issue in Jira:
Hamburger menu: click on ‘Set workflows’
Define the milestone, workflow condition and action
When the workflow is executed, the corresponding issue will be created in Jira and linked with the Luna launch or milestone. Syncing will be performed according to the defined configuration.
By default, syncing is enabled. In order to stop syncing your launch and milestones with Jira, you will need to opt out from the syncing option available in the LDP hamburger menu:
‘Sync with Jira” enables or disables launch level sync with Jira.
‘Sync milestones” enables or disables milestones sync with Jira.
