Jira tracking for reviewers

TerraTrue can automatically create a Jira issue for the review team in their preferred Jira project. Enabling automatic Jira issue creation for review teams allows reviewers to track all of their tasks directly from Jira.

Available to:
TerraTrue Administrators

⚠️ Note: Before configuring review team tracking, an admin in your org must configure the Jira integration.

Turn on Jira tracking for reviewers

To get started, decide which review team is required for a launch. The Jira tracking settings must be configured per review team.

  1. Navigate to Org Settings > Review Teams
  2. Select a review team
  3. Select the Jira Tracking tab
  4. Toggle the setting Ontoggle_Jira_tracking_on.png

Step 1 (required):  Create Jira Issue

  1. Select a Jira project from the drop-down menu, then pick the Jira issue type for the review-related issue.
  2. Select Continue to proceed to the next step.step_1_create_jira_issue.png

 

Step 2 (optional): Link related Jira issue 

  1. Select an issue link type from the drop-down menu to link the review-related issue to the launch-related issue.
    This is simply a way to define how the two issues correspond to one another. For example, select reviews when a team must review the launch-related issue.
  2. Select Continue to proceed to the next step.step_2_link_jira_related_issue.png

 

Step 3 (optional): Sync review assignee

 Enabling this setting eliminates the need to manually change assignee information within both platforms. Instead, assignee updates are automatically synced bidirectionally between TerraTrue and Jira.

  1. Toggle Sync Review Assignee to Yes.
  2. Click Done to complete setup.step_3_sync_review_assignee.png

 

Sync review assignee troubleshooting

In the event there are incompatible permissions between the TerraTrue reviewer and the Jira issue assignee, messaging will appear in both platforms.

Incompatible permissions scenarios:

Reviewers assigned from TerraTrue with incompatible Jira permissions Reviewers assigned from Jira with incompatible TerraTrue permissions
They do not have a Jira account (matched by email address)

They are not a member of the review team in TerraTrue and they have not been provisioned as a “launch manager” in TerraTrue

They do not have permissions to be assigned issues in the Jira project chosen by the review team  

When a reviewer is assigned from TerraTrue who does not meet permission requirements in Jira:

  • A comment will appear in the review-related Jira issue noting that the assignee cannot be added because they do not have permissions to be assigned issues in the project.

When a reviewer is assigned from Jira who does not meet permission requirements in TerraTrue:

  •  A log is added to the TerraTrue revision history noting that the assignee has been changed in Jira to someone not on the TerraTrue review team. 
  • A comment is added to the review-related Jira issue noting that the assignee cannot be added because they are not on the TerraTrue review team.
Was this article helpful?
0 out of 0 found this helpful