Jira integration enables you to synchronize your Jira project with your Roadmape workspace and view them in one place.

You can also create custom item types that correspond to Jira issue types. With this customization, your projects are accurately represented in Roadmape, which makes managing and prioritizing easier.

How to integrate Jira with your workspace

  1. Click Your Company Name in the top left of the sidebar menu.
  2. Then, select Workspace Settings. Go to Integrations section.
  3. Find Jira and click to see Jira Integration Settings.
  4. After, click Connect button.

First Step

For Step 1, you need to write the URL of your Jira Workspace in the input.

Be careful you need to write the URL without any paths. Example: https://myworkspace.atlassian.net

Second Step

  1. Click the Open Jira button.
  2. Click on Create API Token in your Jira Security settings.
  3. Label your token (e.g. Roadmape).
  4. Click on Create button.
  5. Copy the token.

Third Step

  1. Enter your Jira account email to the first input.
  2. Paste the API token generated by Jira to the second input.
  3. Click the Continue button.
  4. After the installation, you must select the Jira Project you want to link with Producter.

Configure Jira Integration

2-Way Sync

2-Way Sync provides automatically syncing data between Roadmape and Jira when there’s a change on either platform.

Roadmape items will need to be manually pushed if you do not enable 2-Way Sync.

Check the checkbox if you want to enable 2-Way Sync.

Enable / Disable

The Jira Integration can be disabled at any time by using the toggle. After enabling it again, Jira Integration will work properly.

Item Type Mapping

Through item type mapping, you can connect your Jira issue types to Roadmape item types.

If there is no item type you want to map in Roadmape, you can create a new item type in Items Page.

Click the +Add New button for mapping item types that have not yet been mapped to Roadmape.

Status & Field Mapping

Field mapping allows you to match Jira fields to Roadmape fields. After mapping the fields, you also need to map the options of some fields.

If you don’t want to sync certain fields with Jira, you can remove them.

In order to use Jira Integration properly, fields & status must be correctly mapped. Also you can change the mapping after the installation, too.

By following these steps, you should be able to set up a reliable and efficient two-way integration between Roadmape and Jira that will save you time and improve the productivity of your team

How to use Jira Integration

Once you have configured the integration settings, you can test the integration by creating a new item in Roadmape and making sure it is synced to Jira.

You cannot see item types that you have not mapped in Jira.

You can push Roadmape items to Jira by clicking the +Push to Jira button on the item detail page if you haven’t enabled 2-Way Sync.

You can see the pushed issue in Jira after pushing it to Jira by clicking on See this item in Jira button.

Additionally, you don’t have to create a new Jira issue for every pushing item. Instead of creating a new Jira issue, you can select an existing issue when pushing to Jira.

How to connect your Jira and map your fields