On-prem JIRA Data Center edition integration plugin

Owned by Yegor Dolgopolov
Last updated: Apr 01, 2023
4 min read

Contents

Overview

The Data Theorem Integration Plugin for Jira Data Center edition is designed to automate the process of importing and updating issues from Data Theorem into Jira. The main features of the plugin include:

  • Importing issues based on predefined rules and schemes

  • Synchronizing issue status between Data Theorem and Jira

  • Manual import of issues for ad-hoc analysis and troubleshooting

 

The following items are included in the Data Theorem Jira ticket:

  • App Name

  • Type of release (pre-prod or production)

  • Type of Severity (High, Medium, Low)

  • Platform (Android, iOS, WinMo)

  • Issue Description

  • Recommendation

  • Sample Code

  • Issue URL to Data Theorem Portal

  • Mobile App\Asset URL to the Data Theorem Portal

  • Required Custom fields for the Project and Issue type

  • Additional Custom Fields

A sample developer workflow is below:

  1. Jira admin defines the schedule on which Data Theorem will be synchronizing issues with the Jira instance

  2. Data Theorem scanners find a new issue

  3. Data Theorem plugin on its next sync scheduled job run creates a Jira ticket

  4. Developer fixes the issue and submits a new build to pre-prod or prod

  5. Data Theorem scans the latest build, marks issues as Closed/Fixed

  6. The Plugin on its next sync scheduled job run syncs the data to the existing Jira ticket.

Please note: Data Theorem will not close issues in the customers Jira systems, but provide notifications within existing tickets using Jira comments.

Plugin configuration

The the admin configuration panel of the plugin consist of 4 pages

General Information

The General Information section allows you to configure the Data Theorem Integration Plugin's essential settings, such as the API key, import schedule, and user permissions.

On this page, you can:

  1. Input the API key: Provide the Data Theorem API key to enable communication between the plugin and the Data Theorem system.

  2. Define the scheduled import schedule: Choose how frequently the plugin should import issues from Data Theorem, ranging from every 15 minutes to once a week.

  3. Select a user: Choose a user account that the plugin will use to create issues and comments in Jira. Ensure that this user has the necessary permissions in Jira to create and modify issues, as well as add comments.

  4. Advanced properties: Click the button to access the advanced properties page, where you can configure less common options such as proxy server parameters and set the maximum number of issues that can be created per scheduled job.

Issue Import Schemes

Issue Import Schemes define how issues from Data Theorem are mapped to Jira issue types, projects, and custom fields.

 

To create an Issue Import Scheme:

  1. Go to the Issue Import Schemes section.

  2. Click the "New Scheme" button.

  3. Configure the scheme settings, including Jira project, issue type, and field mappings.

  4. Configure Severity mappings by choosing the field that will be used for this purpose and values that correspond to each severity level of the issue

  5. Save the scheme.

 

You can edit or delete existing schemes using the corresponding actions in the Issue Import Schemes list.

Issue Import Rules

Issue Import Rules determine which issues from Data Theorem should be imported into Jira.

To create an Issue Import Rule:

  1. Go to the Issue Import Rules section.

  2. Click the "Create New Rule" button.

  3. Configure the rule settings, including the Data Theorem product, filter criteria, asset, and the associated Issue Import Scheme.

  4. Save the rule.

 

You can edit or delete existing rules using the corresponding actions in the Issue Import Rules list.

Manual Import

The Manual Import section allows you to import issues from Data Theorem into Jira on an ad-hoc basis, without relying on predefined rules or schedules.

To perform a manual import:

  1. Go to the Manual Import section.

  2. Select the Issue Import Scheme that will be used as a template for the manual import.

  3. Copy the Data Theorem portal URL of the issue and paste it into the text field

  4. Click the "Import to Jira" button.

  5. Alternatively you can test the issue scheme configuration by creating a test ticket without using the URL from the portal.

The issue will be imported into Jira using the selected Issue Import Scheme.