Introduction to Jira integration
huminos provides integration with JIRA to get progress updated without having to switch away. huminos’s Jira integration allows users to connect their goals and have them automatically update progress when Jira is updated. Admin on huminos platform can create a connection between huminos and Jira.
Enabling the Jira integration
Step 1. Go to the integrations menu inside the Admin section of the huminos platform (Admin -> Integrations). Under Progress Tracking Integrations, select Jira.
Step 2: Click Add Connection.
Step 3: Enter the Jira Connection Name, Jira Domain, and the API Key generated from Jira. The instructions for generating an API token for your Jira cloud account is described here.
Step 4: Click Save.
While in most cases one connection is enough, huminos allows you to connect with multiple Jira instances. Click Add connection’ to add another instance. You can add names to your connections to differentiate them. These names are displayed to members when they link their OKRs to Jira.
On successful app integration, you will start seeing Connect to a data source option while adding/updating your objectives.
Connecting the Jira connection to an OKR
Once you have configured the connection, the next step is to start linking OKRs to the stories or epics in Jira.
-> While creating or editing an OKR, click on Connect to data source. From the drop down menu, select Jira.
-> Select a connection, and add a JQL query to match any issues that would relate to the objective or key result. This also means that as more issues in Jira match the query, they keep getting linked to the progress of the objective or key result.
-> Choose the tracking metric using which you want to measure the progress.
-> Click save and continue with creating your objective
A JQL query can be copied from Jira. Search for issues you want to link to your objective using available filters on Jira. Next, click on the ‘Advanced’ option and Jira automatically converts your search to a JQL query. You can copy and paste the query string into your integration with huminos.
Refer to the data beneath for more details on the Jira tracking metrics supported.
- Number of completed issues - Progress is calculated based on the total number of completed issues fetched using JQL
- Number of hours spent - Progress is calculated based on the total number of hours spent within the list of issues fetch with JQL
- Number of Issues - Progress is calculated based on the total number of issues fetched using JQL
- Remaining Estimate - Progress is calculated based on the total number of hours remaining within the list of issues fetch with JQL
- Progress of an issue - Progress is calculated based on the percentage of resolved issues within the list of issues fetch with JQL
huminos pulls in new updates from Jira every 60 minutes. However, you can also manually refresh to pull in any new changes.
Remove huminos Jira Integration
Admin on the huminos platform can disable or delete a Jira connection from the admin -> Integration section.
- Click on the Jira integration
- Click on the Delete icon to delete jira connection
- Click on the Green toggle button to disable the connection