About Domino
Domino Data LabKnowledge BaseData Science BlogTraining

Integrate Jira

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

Important

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 privileges to modify tickets in Jira.

To learn how to configure your Domino deployment to use Jira, see Integrate With Atlassian Jira.

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

Connect Domino and Jira

You must connect your Domino and Jira accounts, and then authorize your Domino account to take action in Jira on your behalf.

  1. Go to the Overview section in Domino.

  2. Click the Tasks tab.

  3. Click Add Jira Credentials.

  4. 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

Link a Jira ticket to your Project

After you’ve connected your Domino and Jira accounts, you can link a Jira ticket to your Project. Only a single Jira ticket can be linked to a Project at any given time.

To link a Jira ticket to the Project, 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 Project automatically pulls the ticket’s metadata (such as description and comments) into Domino. Changes made to a Jira ticket from Domino are reflected in Jira.

If you change a Jira ticket from within Jira after it has been linked to a Project, you must click Sync in the Manage tab in Domino to synchronize the changes.

Link a Jira ticket

Jira subtasks or child issues become Domino tasks

A Project can be linked to a single Jira ticket. If that ticket has child issues or Subtasks associated with it, they automatically become Domino tasks when linked in your Project. The Domino-Jira linkage is bidirectional. You can add, edit, or delete tasks from Domino and those changes are reflected in Jira (and vice versa).

If your Jira workflow commonly uses Epics with child issues like Tasks, Stories, and Bugs, Domino recommends that you link the Epic issue to your Project. The child issues within the linked Epic will automatically become tasks in the Project.

If your Jira workflow does not typically use Epics, or if a single Epic usually maps to multiple data science projects, then Domino recommends that you link a Jira ticket of type Task or Story to your Domino Project. If the Task contains Subtasks then the Subtasks automatically become tasks in the Domino Project.

The following operations on a Domino task are reflected in the corresponding Jira ticket, and vice versa:

  • Create a new task

  • Edit the task title or description

  • Delete an existing task

  • Change status

  • Assign an owner

    Important
    		 You cannot use Domino task stages with Jira integration. Jira statuses replace the functionality of task stages.

To learn more about tasks in Domino, see Link tasks to work.

Unlink a Jira ticket from your Domino Project

  1. Go to the Overview section in Domino.

  2. Click the Tasks tab.

  3. Click …​ and click Unlink Ticket to unlink the Jira ticket.

After a Jira ticket is unlinked from your Domino Project, you must discard any associated Jira tasks in your Project.

Important

Discard any tasks 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 tasks, they will be kept and added to the set of tasks of a subsequent Jira ticket.