{{announcement.body}}
{{announcement.title}}

Serverless Integration of JIRA Using Kumologica

DZone 's Guide to

Serverless Integration of JIRA Using Kumologica

We will create a “Contact Us” HTML form that is present on most of the websites and integrate it with Jira Service Desk using the Kumologica.

· Integration Zone ·
Free Resource

In this article, we will create a “Contact Us” HTML form that is present on most of the websites and integrate it with Jira Service Desk using the Kumologica Designer flow running on AWS Lambda.

If you want to learn more about Kumologica, we’d highly recommend you check out our tutorials or subscribe to our youtube channel.

Prerequisites

Jira Service Desk

If you don’t have access to Jira Software or Jira Service Desk you can create a free account. Once the account has been created you will be given your site URL (ends with atlassian.net) for your Jira Service Desk Instance.

The Next Step is to create an API Key. Navigate to: Settings icon (in the top right corner) > Atlassian account settings > Security (in the left panel) > Create and manage API tokens >Create API Token. Enter the label for token and press Create, you will be presented API token. Copy it as you will need this token to authenticate from Kumologica flow.

Create API Token for Jira Service Desk
We will be using the General service desk (GSD) example project that has been created for us. The GSD is a project id that we will be using in Kumologica flow.

Building Orchestration Flow

Once we have access to Jira configured we can start building our Kumologica flow.

Create a New Project

Open Kumologica Designer, click the Home button and choose to Create New Kumologica Project. Enter the name (for example Jira-demo), select directory for the project, and switch Source into From Existing Flow…

jira demo

New Kumologica Project with importing flow
Copy and Paste the following flow:
JSON
 

Press Create Button.

Install Jira Plugin

Jira node is a contribution node and must be explicitly installed in Kumologica Designer. Press Add more nodes button located in the bottom left corner of the designer. You will be presented with a screen with all contribution nodes that are currently available. Choose JIRA node, press the Install button. After a few seconds, the plugin will be installed and you will be prompted to restart Kumologica Designer. Jira node will be located under a new category: Platforms after the restart.

add nodes

Kumologica Contribution Nodes screen

Edit Flow

After installing JIRA node, the imported flow will look like below:

demo flow

Jira Demo Flow
Click on the Create Issue Jira node to display its properties and change Jira Connection Details section:
  • Host URL: enter the URL that has been created for your Jira service desk instance (ends with atlasian.net)
  • Username: the user name you set up when creating an account or the username you use for your Jira instance
  • API Token: token created in the Prerequisites section

Press the Save button to return to the flow.

We have put connection details directly into properties for simplicity. We recommend to use AWS Parameter store to store secrets and use Kumologica AWS SSM Node to retrieve them.

Deploy Flow to AWS Lambda

Select the CLOUD tab on the right panel of Kumologica designer, choose AWS Profile, and press the Deploy button. This will trigger the build and deployment of flow into AWS Lambda. After a short while you should see the API gateway URL that has been created for your flow in the terminal:

terminal

Terminal after the successful deployment

Contact Us HTML Form

Below is a sample “Contact Us” HTML form, save it in local drive. Change line 18 to use the API Url that was displayed in the Kumologica Designer terminal after successful deployment to AWS Lambda. Don’t forget to append it with /issue to call the right service.

HTML

Open the HTML file in your browser, fill up details and press the  Submit button.

contact us

Contact Us HTML form
The browser should display empty JSON: {}. When you switch to your Jira Service Desk General service desk project you should see new issue created with following details:

kumo logic

Jira issue created
As you can see, the properties set in Kumologica Jira node mapped Summary into Title, Your E-Mail, and Your Message got concatenated into Description.

Conclusion

This article presented how easy Kumologica Designer flow orchestrates and integrates with Jira software using Jira node. Within a few minutes we have set up Jira Service Desk, created and deployed Kumologica flow, and finally created simple contact us HTML form that calls flow and creates issues in Jira.

Remember Kumologica is free to download and use. Go ahead and give it a try, we would love to hear your feedback.

In the meantime, if there is any specific use case that you would like to see in a future article please let us know in the comments section.

Topics:
aws, integration, jira, lambda, low code, microservice, serverless, tutorial

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}