Overview
Gtmhub provides both Jira Cloud and Jira Server apps for enhancing your Jira experience. You can link your Jira items to Gtmhub OKRs by creating Tasks under an OKR. This way you represent the work that you're actually doing in Jira to support your OKR. The integration also keeps in sync the Jira issue status with the Gtmhub Task status.
This article demonstrates how to install the Gtmhub for Jira Cloud.
Features
The application has the following features:
Tracking the progress of the linked Gtmhub Objectives or KRs in your Jira issues - Stories, Bugs, Features, Epics etc.
Tracking the Jira issues updates of summary, description, status, and assignees
Apply Jira issue updates to the linked Gtmhub tasks.
A task in Gtmhub is an artifact that represents a unit of work that should be done to achieve an Objective or a KR. Therefore, Jira issues are represented as a Gtmhub tasks. The app provides two-way synchronization between Jira issues and Gtmhub tasks.
Prerequisites
You must have an active Jira account.
Installation
In the Atlassian Marketplace, go to Gtmhub for Jira Cloud and install it.
Configuration
To configure Jira, perform the following:
In Gtmhub, in the bottom of the navigation pane, click Settings.
On the Configuration tab, click Jira.
Use the Copy buttons to copy the values.
In Jira:
Navigate to your Jira account.
Click on Settings and select Apps
Search for "Gtmhub for Jira Cloud" and install it.
It is very important to configure the correct permissions set first.
Refer your Jira administrator to the Jira plugin permissions article and follow the described steps.Configure the plugin with the details you copied from your Gtmhub account.
Configure automatic Task status updates
When you link a Jira item to a Gtmhub OKR through this integration, this creates a Task under the specified OKR. The task is created with the current status of the Jira issue. If you want the Task to reflect the Jira issue status in real-time, you have to Setup a Jira webhook.
This allow status changes made in your Jira project to be automatically reflected in your Gtmhub account.
For more information, see Jira documentation > Webhook and Managing webhooks.
Contact your Jira administrator to perform the following in Jira:
In the Jira webhook setup, paste the Webhook URL copied from Gtmhub.
In the Jira webhook setup, in the Events section, under Issues, select updated and deleted.
Use
Open a Jira issue and, from the Gtmhub OKRs panel, link it to a Gtmhub Objective or KR.
You can narrow down the list of OKRs easily by searching for the Objective or KR title, owner or description.
Afterwards, you are able to:
Follow the Gtmhub OKR progress from within your Jira Cloud application
Follow the Jira issues progress from within your Gtmhub account.