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:
Jira admin defines the schedule on which Data Theorem will be synchronizing issues with the Jira instance
Data Theorem scanners find a new issue
Data Theorem plugin on its next sync scheduled job run creates a Jira ticket
Developer fixes the issue and submits a new build to pre-prod or prod
Data Theorem scans the latest build, marks issues as Closed/Fixed
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:
Input the API key: Provide the Data Theorem API key to enable communication between the plugin and the Data Theorem system.
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.
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.
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:
Go to the Issue Import Schemes section.
Click the "New Scheme" button.
Configure the scheme settings, including Jira project, issue type, and field mappings.
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
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:
Go to the Issue Import Rules section.
Click the "Create New Rule" button.
Configure the rule settings, including the Data Theorem product, filter criteria, asset, and the associated Issue Import Scheme.
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:
Go to the Manual Import section.
Select the Issue Import Scheme that will be used as a template for the manual import.
Copy the Data Theorem portal URL of the issue and paste it into the text field
Click the "Import to Jira" button.
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.