You can integrate Deepfactor with Jira Cloud or Jira Server and raise Jira tickets for alerts directly from the Deepfactor Portal by following the process below:
From the left-side navigation menu, Click ‘Integrations’.
- On the left-sidebar, navigate to ‘Project Management'.
To integrate Deepfactor with your Jira Cloud account, follow the steps below:
Click “Connect JIRA Cloud.”
This will take you to an authorization screen on your Jira cloud.
After you click "Accept," you will be redirected to Deepfactor, and your Deepfactor account will now be integrated with Jira.
Integrate Deepfactor with Jira Server
To integrate Deepfactor with your Jira Server account, follow the steps below:
Create an application link in your Jira Server using the steps outlined in the following article
On your Deepfactor Portal UI, under Jira Server, click “Configure Jira Server.”
- Enter the details from Step 1 and click “Save.”
- Enter the credentials.
- Click "Login."
- Click “Allow” to grant Deepfactor access.
After you click ‘Allow,’ you will be redirected to Deepfactor, and your Deepfactor account will now be integrated with Jira.
Map your Application to Jira Project
Once you have successfully integrated Jira with Deepfactor, you can map your Jira Projects with Deepfactor applications.
Create Jira Issues
You can now create a Jira for each Deepfactor alert on the alert detail page.
To create a JIRA:
- On the alert detail page, click the “Create Jira” icon.
Create JIRA pop-up window appears.
- Click the "Edit" icon.
- From the Jira Project drop-down, select a JIRA project.
- Click "Save."
- Depending upon the mandatory fields set in your Jira project settings, a form with those fields will be shown on the Deepfactor UI. Please enter the values in the create jira form to create a jira issue.
- Click "Create Jira."
After a Jira ticket is created, you will see the link of the Jira ticket on the alert detail page in the Deepfactor Portal.
Handling Mandatory fields
In Jira project settings, you can specify mandatory fields which are required to create a Jira issue in that project. Once you select the project and issue type in the create jira form, Deepfactor calls a Jira API to get the list of mandatory fields and renders them in the form for you to fill so we can create a Jira issue in that project. However, Deepfactor does not handle certain required field value types listed below:
type: array, items:json (Ex: Sprint, user)
type: array, items: issuelinks
If Deepfactor cannot handle any of the mandatory fields, an error will be shown on the UI along with the names of such fields. In order to create Jira issues from Deepfactor in such a project, you can either mark those fields as non-mandatory or set default values for them.