Jira Integration in Domino

Attention

To use this feature:

  • Your Domino deployment must be configured to use Jira.
  • A Jira administrator must configure this integration within Jira.
  • Your Jira account must have the necessary privileges to modify tickets within Jira. Otherwise, you’ll encounter errors within Domino if you try to use this feature.

To learn more about how to configure your Domino deployment to use Jira, please read: Jira Admin Configuration.

Overview

With Domino’s Jira integration, you can perform common Jira actions from your Domino project.


Connecting Domino and Jira

To use this feature, you’ll first need to connect your Domino and Jira accounts, and then authorize your Domino account to take action in Jira on your behalf.

  1. Navigate to the Overview section in Domino.
  2. Click on the Manage tab.
  3. Click on the Add Credentials button. You’ll be redirected to Jira’s authentication page. Enter your Jira credentials and authorize read and write access for Domino.

The connection between your Domino and Jira accounts will persist until you clear your Domino-related browser cookies.

Jira_Credentials_Screenshot.png


Linking a Jira Ticket to Your Domino Project

Once you’ve connected your Domino and Jira accounts, you’ll have the option to link a Jira ticket to your Domino project. Only a single Jira ticket can be linked to a Domino project at any given time.

To link a Jira ticket to the Domino project, you can search by its Jira key or title text, browse among issues assigned to you, or browse issues in a given Jira project.

Linking a Jira ticket to your Domino project will automatically pull in the ticket’s metadata (description, comments, etc.) into Domino. Any changes made to a Jira ticket from within Domino will also be reflected in Jira.

If a Jira ticket is modified from within Jira after it has been linked to a Domino project, you’ll need to sync the changes using the Sync button in the Manage tab in Domino.

Link_Jira_Ticket.png


Jira Subtasks or Child Issues Become Domino Goals

Recall that a Domino project can be linked to a single Jira ticket. If that ticket has child issues or Subtasks associated with it they will automatically become Domino goals when linked in your project. The Domino-Jira linkage is bidirectional – you can add, edit, or delete goals from within Domino and have those changes reflected in Jira (and vice versa).

If your Jira workflow commonly utilizes Epics with child issues like Tasks, Stories, Bugs, etc., we recommend you link the Epic issue to your Domino project. The child issues (Tasks, etc.) within the linked Epic will automatically become Goals in the Domino project.

If your Jira workflow does not typically utilize Epics, or if a single Epic usually maps to multiple data science projects, then it would be best to link a Jira ticket of type Task or Story to your Domino project. If the Task contains Subtasks then the Subtasks automatically become Goals in the Domino project.

The following operations on a Domino Goal will be reflected in the corresponding Jira ticket, and vice versa:

  • Creating a new goal
  • Editing the goal title or description
  • Deleting an existing goal
  • Changing status

To learn more about goals in Domino, please read: Project Goals in Domino 4.


Unlinking a Jira Ticket from Your Domino Project

  1. Navigate to the Overview section in Domino.
  2. Click on the Manage tab.
  3. Click on the button and click Unlink Ticket to unlink the Jira ticket.

After a ticket has been unlinked from your Domino project, you can decide to keep or discard any associated goals in your project. You can also link the ticket to another Domino project, if desired.

Attention

Be sure to discard any goals that were created in your project as a result of unintentionally linking the wrong Jira ticket to your Domino project. If you do not discard these goals, they will be kept and added to the set of goals of a subsequent Jira ticket.


Limitations

  • Currently, images, Markdown, and any other Jira-compliant formatting are rendered as plain-text in Domino.