ℹ️ Premium and Supreme only
The Perdoo Jira cloud integration helps agile tech teams to save time and stay on top of their OKRs. Seamlessly integrate Results in Perdoo (Initiatives or Key Results) and pieces of work in Jira Cloud (eg Issues, Epics) to guarantee always-updated goals and anticipate challenges early on.
When creating or editing a Result in Perdoo, simply pick the Jira Epic, Story, Task or Bug that should update the value of the Result. Setup is lightning fast, and Perdoo will then directly link the metrics to update your OKRs and Initiatives in real-time.
In this article:
Set up the Jira integration
There are 2 steps to set up the Jira integration. In a couple of minutes, you'll have a Result in Perdoo linked to the work you're doing in Jira. Let's go!
Step 1. Enabling the Jira integration
Note: only Superadmins can enable the integration. But once enabled, all users can link Results to items in Jira.
To enable the Jira integration, go to Configure > Integrations tab > Jira.
Step 2. Linking a Result to a Jira issue
With the integration enabled, all users can now link Results' (Initiatives or Key Results) progress to work that's being tracked in Jira.
Go the Advanced options within the Result's modal and click on the Integration dropdown to select Jira. Then in the Jira issue field search for the issue that is going to be linked to the Result.
⚠️ An issue can be an Epic, Story, Task, or Bug
Step 3. Select the Track Progress by method
After selecting the issue you can now select the relevant 'Track progress by' method for the Result linked.
It can be one of the following three. Note, that the progress method you are able to select is dependent on the issue type selected.
Issue status: when an issue is marked as "Done" in Jira, the Result's progress will be 100%. Progress is binary. This can be used for all issue types.
Epic progress by issues completed: progress is measured as % by calculating the number of issues completed divided by the total number of issues available. This progress method can only be applied for epics.
Epic progress by story points completed: progress is measured as % by calculating the number of story points completed divided by the total number of story points available. This progress method can only be applied for epics.
The Jira integration runs automatically at 1AM CET each day.
Troubleshooting the Perdoo Jira integration
The status of your integration is always shown on the integration page, with a green 🟢 or red dot 🔴 . If your dot is showing red, there is a problem with the integration, likely caused by the connection to the Jira API. There are two potential reasons for this:
Jira is down: we'd recommend checking the Jira status page.
API token expired: for example, the user left the company and the account was removed from Jira.
Also, if you change the status of your Jira issue back to In Progress, it will not revert the Result's status in Perdoo.
If this does not help with resolving the status of your Perdoo Jira integration, please contact our Support Team by emailing firstname.lastname@example.org or starting a chat at the bottom-right of your screen.