ℹ️ Available on Supreme.
The Perdoo Jira cloud integration helps agile tech teams to save time and stay on top of their OKRs. Seamlessly integrate KPIs or Results (Initiatives or Key Results) in Perdoo with your work in Jira Cloud (eg Issues, Epics) to guarantee always-updated goals and anticipate challenges early on.
Enabling the Jira integration
ℹ️ This requires Superadmin rights.
To enable the Jira integration:
Click 'Enable'.
Click 'Connect'.
Allow Access.
Click Finish.
After it's enabled, you can choose to keep the integration private or shared with everyone else under 'Settings'.
How to integrate a KPI, Key Result, or Initiative to a JQL Query or individual Jira issue
When creating a KPI or Result, click on Advanced Options. If the goal already exists, you can edit from the details modal in the right side panel.
Select Connection.
Select Source Type:
Individual issue: Select Project (Optional) and Jira Issue.
Select Track progress by.
Review Preview.
Click Save & Sync now.
JQL Query
For JQL Queries, you can choose to update progress by Issue count, Percentage of issues completed, or Percentage of story points completed.
For issue count, the count of issues that your query returns is displayed when you enter your query and is what will be used to determine the value of the KPI, Key Result or Initiative - and so progress here is based on what is filtered. We have a couple options below.
Another example, we have a Key Result linked to the number of open bugs (the query is fetching the count of bugs that aren't marked as done).
Individual Issue
⚠️ An issue can be an Epic, Story, Task, or Bug.
For Individual Issues, you can select the relevant 'Track progress by' method for the Result linked.
It can only 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.
Important notes
Perdoo will check once a day for any changes — between 12-1AM CET — and will update in Perdoo if there was a change in the value.
If you'd like to update the goal at anytime, you can click "Update progress" and the latest value will be fetched, or open the integration and click "Save & Sync now".
If you change the status of your Jira issue back to In Progress, it will not revert the Result's status in Perdoo.
Troubleshooting the Perdoo Jira integration
ℹ️ This requires Superadmin rights.
The status of your integration is always shown on your Jira integrations page, with a connection status. If your connection is disconnected 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.
If this does not help with resolving the status of your Perdoo Jira integration, please contact our Support Team by emailing support@perdoo.com or starting a chat at the bottom-right of your screen.
Need help?
Contact our friendly Support team via the in-app chat at the bottom-right of your screen, or email support@perdoo.com.