The integration of IBM Doors with Jira ensures that the product management and application development teams are on the same page when it comes to customer expectations and deadlines.
On this page, we will look at the bi-directional integration of Requirement from IBM Doors and Story from Jira.
How To Create An Integration Between IBM Doors – Jira
To create an integration between IBM Doors and Jira, you need to:
- First, install OpsHub Integration Manager.
- Kindly setup a VM (new or an existing one) for installing OpsHub Integration Manager. Here are pre-requisites for installation.
- The steps for installation of OpsHub Integration Manager are given here.
Integration configuration is the process of defining the flow, conditions, time, and parameters for integrating the entities between two systems. Follow the steps given below to integrate IBM Doors and Jira.
Click the Integrate button shown in the image below.
Once you come to the mapping page from the integration page, following details are automatically populated in the Mapping section.
Note: For the first integration that you are configuring, we would recommend you take only mandatory fields for mapping first and later edit the mapping to add more fields.
- If you wish, change the name for the mapping in the Name field.
- Now, click the Create from Scratch button to define the mapping from scratch.
- Click Auto Map to automatically map all fields with same name. OpsHub Integration Manager will allow you to remove or add more fields before saving mapping.
- OpsHub Integration Manager will load fields available in the selected entity and project fields. For reference, please look at the image below.
- Now from the drop-down shown in the image below, select the Mandatory fields option for IBM Doors first.
- The API of IBM Doors doesn’t support mandatory fields to be fetched here, so you can directly look it up on its API. However, for the purpose of this integration, we will not have any mandatory fields mapped from IBM Doors to Jira.
- Now go to Jira. Jira has a mandatory field: Summary.
- Map the Summary field in Jira to the OH_Default field in IBM Doors.
Note: If Mandatory fields in one system don’t have a corresponding value in the other system, map the mandatory field in the system with the OH_Default field in the other system.
- Now, proceed with mapping additional fields that you want to sync.
- On the right panel, the mapped fields are displayed in this manner.
- If you want to synchronize a field only in one direction, then you can disable sync of a field by clicking or .
- The look-up type field, project, is marked with the value mapping icon .
Note: Value Mapping is used to map the values for the Lookup Type fields.
- Click against the Projects fields to map their corresponding values.
- From the Value Mapping pop-up that opens after clicking , select the corresponding values from both systems by clicking them. We select Demo Module 1 from IBM Doors and DemoProject from Jira.
- Click Save in the Value Mapping pop-up to save the mapping.
- It’s time to save the mapping now. Click the Create Mapping button to create & save the mapping.
- Once you save the mapping successfully, you will get the following pop-up at the bottom of the page.
- You will be further re-directed to the Integration page.
Now, once you have set the basic integration in place, you can edit the integration to map entities such as comments, attachments, and relationships.