How to connect the Jira Adapter for SAP Integration Suite?
The Jira receiver adapter allows you to connect to Jira to centralize the management of projects including time tracking, sprint planning, issue and bug tracking, etc. Utilize a rich catalog of CRUD operations to manage issues and projects and speed up your integrations.
Introduction to Jira
Jira is a versatile software with multiple offerings like issue tracking, bug management, and agile project management.
Jira Adapter Features
- Jira Operations Support: Offers support for all issue tracking and project operations.
- Ease of Access and Connectivity: Allows you to save connection-related details on the adapter, thereby providing a convenient mode for establishing connections to any external systems.
- Dynamic configuration with headers and properties: Assigning dynamic values to different properties allows enhanced flexibility to your integration flows
- Support for JQL Query: You can perform search operations and querying using Jira Query Language (JQL) parameters.
How to use the Jira Adapter?
You can use the Jira Adapter to perform all the major issue and bug-tracking operations, with the added functionality of JQL-based querying to interact with the Jira server.
In this blog, we are going to demo the Create issue operation to create an issue in Jira.
Create an issue in Jira
Before we begin, it is assumed that you have set up Jira and have the user credentials to connect to it.
A sample of the integration flow is shown in the figure below.
How to Connect to the Jira Adapter?
To connect to Jira, utilize the following Connection configurations.
Parameter | Description |
Address | Specify the login endpoint to your Jira endpoint url. Example: https://your-domain.atlassian.net |
Authentication | Select Basic as an authentication method to connect to the Jira endpoint with a username and password. |
Basic Credentials Alias | Specify the user credentials to be stored as a security artifact in Security Material. |
Reuse Connection | Enable to reuse the connection. This option enables the reuse of connection objects from the internal connection pool, which in turn improves the network turnaround time for multiple communications to the same end point. |
Connection Timeout (in ms) | Specify the maximum waiting time (in milliseconds) for the connection to be established. Example: 6000 |
Response Timeout (in ms) | Specify the maximum waiting time (in milliseconds) for a response message. Example: 6000 |
Create Payload for the Jira Issue
Create issue allows you to create a Jira issue. You can define the summary and description of the issue inside fields in the payload/body.
A sample payload is given below for reference
{ "fields": { "project": { "key": "CRD" }, "summary": "Issue Creation for Supplier", "description": "Order entry fails when selecting supplier.", "duedate": "2024-12-12", "issuetype": { "name": "Task" } } } |
Create an Issue using the Jira Adapter
Now switch to Processing and use the following configuration to create an issue.
Under Entity Issues, the operation Create issue (/rest/api/2/issue) allows you to create a Jira issue.
Save and deploy the integration flow and with successful execution, you will see a new issue is created in the respective Project.
Quick Links
For detailed information about Jira Adapter configuration, see Jira Adapter Guide.
Note: The Jira adapter is available as part of your SAP Integration Suite license.