Jira provides bug tracking, issue tracking, and project management functions.

Connect Jira with Devo SOAR

1. Navigate to Automations > Integrations.

2. Search for Jira.

3. Click Details, then the + icon. Enter the required information in the following fields.

4. Label: Enter a connection name.

5. Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.

6. Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).

7. Remote Agent: Run this integration using the Devo SOAR Remote Agent.

8. URL: URL of the Jira server.

9. User: User name to log in with.

10. Password or API Token: Password or API Token to log in with.

    • API Token is recommended. Also, only API Token will work if third-party sign-in is enabled in JIRA. For more information on how to generate an API token, click here.

11. After you've entered all the details, click Connect.

Actions for Jira

Create Issue

This action creates a ticket with the specified details whenever the parent table has any results. The parent table's data is put into the ticket's description field.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of result:

• has_error: True/False

• error: message/null

• result: created ticket details

Create Issue V2

Creates a Jira issue for each row in the input table.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of result:

• has_error: True/False

• error: message/null

• result: created ticket details

Create Issue with Optional Fields

Creates a Jira issue for each row in the input table.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of result:

• has_error: True/False

• error: message/null

• result: created ticket details

Add Comment

Adds a comment to an existing Jira issue for each row in the input table.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of result:

• has_error: True/False

• error: message/null

Query Issues

This action queries Jira for tickets that match the given JQL.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of result:

• has_error: True/False

• error: message/null

• other key fields of result

Get Issue

This action retrieves the Jira ticket for a given issue key.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of result:

• has_error: True/False

• error: message/null

• other key fields of result

Update Status

This action updates the status of a given issue key.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing result.

``` {json}"data":{ "has_error":false "result":"Transition successful" "error":NULL }

Get Account ID of Jira Users

Jinja template to be provided in Other Fields to set Assignee:

``` {json}{ "assignee": { "accountId": "{{account_id_column}}" } }

Add Watcher

This action returns the list of watchers for the issue with the given key.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

JSON containing the following items:

``` {json}{ "has_error": false, "result": "Added successfully", "error": null }

Release Notes

• v5.0.0 - Updated architecture to support IO via filesystem

• v4.4.1 - Added 3 actions: Get Watchers, Add Watcher and Remove Watcher.

• v4.3.1 - Bug fix : Truncate text being sent to the description field to the allowable limit in Create issue, Create issue v2, Create issue with optional field and Update issue actions.

• v4.3.0 - Changes field type of query field in Query Issues action

• v4.2.0 - Modified Update Status action for returning data in Json

• v4.1.1 - Added Delete Attachment action.

• v4.1.2 - Modified Query Issues action for getting any number Issues.

• v4.1.3 - Modified Query Issues action for valid response when getting 0 results in response.