Roadmunk supports integration with JIRA by allowing you to import JIRA issues and their related metadata into a roadmap as items. When importing, you can filter issues by JIRA Project, Type, and Status. You can also add JIRA fields to a roadmap by mapping them to matching fields in Roadmunk or, when necessary, creating new ones.
Importing from JIRA
Start the import
JIRA imports must be performed in the Items Table.
1. On the View navbar, click the Import icon.
2. In the dropdown, select Import from Jira.
Log in to JIRA
1. In the Configuration tab, log in to the JIRA account by entering the JIRA Server URL, Username, and Password.
2. To check the connection before importing, click Test Connection.
3. When you're ready, click Next.
Filter JIRA issues
1. In the Filtering tab, narrow down the issues to import by setting Project, Issue Type, and/or Status filters.
2. Click Next.
Notes and recommendations:
- You can import issues from multiple JIRA Projects.
- We recommend you import only Issue Types that it makes sense to roadmap (for example, Epic, Story, Task). It's not very useful to roadmap Bugs.
- The Status filter applies across all selected Projects and Issue Types.
Roadmunk automatically maps matching or appropriate fields in JIRA to the default Roadmunk fields: Item, Description, and Date.
To import data from additional JIRA fields:
1. Click the + Add New Mapping button.
2. Map the JIRA field to a matching Roadmunk field of the same type. If no match is found, the import creates a matching Roadmunk field.
Syncing Roadmunk items with JIRA issues
Monitor sync status
There are two key differences in the Items Table when items are imported from JIRA.
- An External ID field is created to match items in Roadmunk to the corresponding issue in JIRA. This allows syncing of data between Roadmunk and JIRA. External ID is used instead of the Internal ID field that is generated when you import items from a CSV.
- The Items Table contains a Sync Indicator column .
- Green indicates the issue in JIRA and the item in Roadmunk are in sync
- Yellow indicates the issue has been modified in JIRA but is still in sync with the item in Roadmunk
- Red indicates the issue in JIRA and the item in Roadmunk are NOT in sync
To update items in Roadmunk with data from JIRA, click the JIRA button in the Items Table.
Limits and recommendations
- You can import up to 300 JIRA issues and related meta-data per roadmap
- You must have an existing login to your JIRA server. To avoid permission problems during the import, we strongly recommended that you log in to an admin account,
Platform and version support
- Full support for JIRA Software Cloud
- Support for Hosted JIRA as per requirements below
Hosted JIRA requirements
- JIRA Server should be publicly accessible so the Roadmunk server can connect
- JIRA version 6.3.15
- If the server is behind a VPN or corporate network, Roadmunk's IP address must be whitelisted
- Port forwarding is supported; ensure correct URL is entered
- SSL Certificates must be valid
Who can import JIRA issues to a roadmap?
Importing issues from JIRA to a roadmap is the same as importing items from a CSV. You must be the roadmap's Owner OR the roadmap must be shared with you as an Editor.
If a roadmap has been shared with you as Viewer, you have view-only access to the roadmap and can't import items to it. You'll see a View Only icon on the Roadmap navbar, and the Import icon on the View navbar will be grayed-out and disabled.