Jira Integration

Connect your Zeda.io workspace with your JIRA project to collaborate seamlessly with engineering teams.

In this article

Introduction

Jira is a software development product for agile teams and is used to manage engineering backlog and sprints.

The Jira <> Zeda.io integration enables product teams and product managers to collaborate efficiently with the engineering teams by passing on epics, user stories or issues directly to a Jira board from a Zeda.io workspace.

Integration actions

For keeping seamless collaboration with the tech team, the workspace is integrated with Jira. Integration with Jira can be leveraged in 3 ways:

  1. Import features via Jira - All the features in a project in Jira can be imported to the workspace after authentication with an API key, connecting with the selected project in Jira and mapping the type, importance and status. This will populate all the features present in the project in Jira into the Zeda workspace immediately. More features from different projects in Jira can be added to the workspace similarly one by one. 
  2. Send features to Jira - Any new feature created in the zeda.io workspace can be sent to the Jira by the action of Send to Jira (with mapping on status, type and importance). This action is available in the bulk actions. Check the gif attached for a clear explanation.
  3. Hourly auto sync - Workspace runs an hourly two-way sync with Jira to update any field value for the features which are mapped between Jira and Zeda.io. It also imports any feature created in Jira from the mapped project to the workspace.

Setup

To set up the Jira <> Zeda.io integration, you need to first authenticate your Jira project in your Zeda.io workspace.

This can be done from Workspace Settings > Integrations > Jira or directly from your feature dashboard in Zeda.io

Workspace Settings > Integrations > Jira

Authentication

Authenticate your Jira Project with your Zeda.io workspace by entering the following details

  • Jira URL - This is the URL of your Jira project and is usually something like - https://{your_domain_name}.atlassian.net/
  • Username - This is your own Jira username
  • API Token - To generate an API token, refer to this document.

Features <> Board mapping

While setting up the Jira integration, you would need to map your features in the Zeda.io workspace to the same or different boards in Jira to enable the product managers to collaborate with different engineering PODs for developing products.

Status and Issue type mapping

Once the connected features in Zeda.io to your Jira Board, the mapping needs to be set up for -

  1. The Issue status in Jira with the Feature status in Zeda.io
  2. The Issue type in Jira with the Feature type in Zeda.io
  3. The Issue importance in Jira with the Feature importance in Zeda.io

Apart from just the integration with Jira, there are various places where this information is leveraged in the workspace. Some of them are:

  • Once the Jira ticket is mapped with a feature in Zeda, Jira Id will be available in the features list view across the feature.
  • Zeda.io fetches the epic and fix version along with the manual import and hourly sync, which can be used for fields for any feature on Zeda.io as well. These fields are available in the Details tab of a feature.
  • Tags defined in Jira are also imported and synced with the workspace feature created

78ce95e08697541eaedecf7019906a034adda2d1

The Status and Issue type mapping will enable you to pass on Stories, Bugs, and Tasks to Jira as per your team conventions.

Import

While setting up your features in Zeda.io for the first time, you can import your backlog if it is present in your Jira board seamlessly for efficient backlog management.

  1. To import Jira tickets, navigate to the features dashboard after the Jira authentication is done.
  2. Click on the "Add Feature" dropdown and select "Import features from Jira".
  3. Select the respective Jira project, select the mapping for status, type & importance fields and click next.
  4. This method will enable you to import all or only the specific issues relevant to your backlog by providing a JQL.

 

Zeda.io Feature <> Jira Issue sync

Once your JIRA board is connected with a project and you have saved the status, importance and type mapping, the sync between the features within your Zeda.io product and Jira board will start. This sync will ensure -

  • Any new feature created in your Zeda.io workspace, you can select and send to Jira to create a new Issue in the linked Jira board with details like title, description, creator name, attachments and labels
  • Any update on a linked Jira feature like changes to status, title, description, type, attachments and labels will automatically reflect on the linked feature in your Zeda.io product.
  • Any update on a feature in Zeda.io will update the linked Jira issue.

Please note that as of now, the sync between Jira and Zeda.io is hourly for every feature in your Zeda.io workspace. 

Pausing or revoking Jira Integration

At times, you may want to pause or revoke your integration to prevent the information transfer between one or all Zeda.io products and the connected Jira boards.

  • To pause the sync for a specific product, navigate to Product > Features > Jira Integration > Pause integration
  • To pause the sync for all products in your Zeda.io workspace, navigate to Settings > Integrations > Jira > Revoke