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.

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 Become Domino Goals

In Jira, “Subtasks” are a type of issue that are associated with a parent issue. For example, if a parent issue is of type “Epic”, then its child issues are typically “Tasks” or “Bugs”. However, if a parent issue is a “Task” or “Bug”, then its child issues are typically “Subtasks”.

If you a link a Jira ticket that has subtasks, each subtask will automatically become a Domino goal in your project. Conversely, creating or deleting a goal in your Domino project will result in the creation or deletion of a corresponding subtask in Jira. 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.