Versions Compared

Old Version 7

changes.mady.by.user Derya Özdemir

Saved on

compared with

New Version 8

changes.mady.by.user Derya Özdemir

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Button handy
blankfalse
color#0052CC
nameCloud
linkhttps://appfire.atlassian.net/wiki/spaces/EIFJC/pages/10125437/Installation
width84
Button handy
blankfalse
color#EBECF0
nameOn-Prem
linkhttps://appfire.atlassian.net/wiki/spaces/EI4J/pages/11206868/Installation
width85

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#F4F5F7

This page is about Easy Integrations for Jira Cloud. Using Jira On-Prem? Click the On-Prem button above.

This example

...

demonstrates how to use Easy Integrations

...

to create an Azure DevOps work item when a Jira issue is created.

Prerequisites

Before you begin the configuration, ensure you have the following prerequisites in place:

  • Ensure you have admin privileges to your Jira instance.

  • Ensure you have access to your Azure DevOps organization or project and have the necessary permissions to create Personal Access Tokens (PATs).

  • Before you proceed, generate a Personal Access Token with the following specifications:

    • Set the token's expiration date to the maximum allowed.

    • Make sure to note down the generated PAT. You will need this token for authentication during the integration configuration. For more information, refer to the related documentation.

🎯 Index

Table of Contents
minLevel3
maxLevel

Configuration Steps

...

6
outlinefalse
typelist
printablefalse

Configuration

Follow these steps to set up the integration between Jira and Azure DevOps using Easy Integrations:

Step 1: Create an Azure DevOps Personal Access Token (PAT)

  1. Open your Azure DevOps profile.

  2. Create a Personal Access Token (PAT) with the maximum

...

  1. expiration date.

...

  1. Make sure to note the token

...

  1. for later use.

    Image Added

Step 2: Configure Jira Credentials

  1. Navigate to Apps in the Jira top menu and select Manage your apps.

  2. From the sidebar, navigate to Easy Integrations configuration.

  3. Click on the Credentials app menu item.

  4. Add a new Basic Authorization credential with the PAT information.

...

  1. Image Added

...

Step 3: Configure Easy Integrations Listener

  1. In Jira, access Easy Integrations configuration

...

  1. .

  2. Under Listeners,

...

  1. add a new Listener with the following

...

  1. details:

Field

Description

 Example value

Listener name

Give a name to track

Azure DevOps Integration

Listener is enabled

Works only when enabled

Checked

Retry attempt count

When something went wrong, number of retry count

3

Events

Only one event is enough for the example

JQL can be different, this example listens only to the Bug issues.

Event fieldExample value

JQL supported
EventsIssue created
JQLissuetype = Bug

Condition

Pre-condition of the listener.

Checked

Condition script

Let's process issues those only have description starting with Good

return lodash.startsWith(data.event.issue.fields.summary, 'Good');

Action 1

Add a new "Call a Rest API" action

Action fieldExample
Action nameCreate an Azure DevOps Ticket
ConditionUnchecked

var parameters = {};
parameters['issue key'] = data.event.issue.key;
parameters['issue summary'] = data.event.issue.fields.summary;
parameters['issue status'] = data.event.issue.fields.status.name;
return parameters;
URLhttps://dev.azure.com/{organization}/{project}/_apis/wit/workitems/$task?api-version=6.0
MethodPOST
HeadersAccept=*/*
Cache-Control=no-cache
Content-Type=application/json-patch+json

Basic
CredentialSelect the Credential that is created on second step

[
  {
    "op": "add",
    "path": "/fields/System.Title",
    "from": null,
    "value": "{{issue summary}}"
  },
  {
    "op": "add",
    "path": "/fields/System.Description",
    "from": null,
    "value": "Jira issue is {{issue key}} and status is {{issue status}}."
  }
]

Action 2

Add a new "Update a Jira issue" action

Action fieldExample
Action nameAdd Azure DevOps work-item link to Jira issue
ConditionUnchecked

Unchecked

Checked
Issue fields

We will save work item link to a text custom field



FieldSelect a text Custom Field

return data.apiData.api1.responseBody._links.html.href

Unchecked


  1. Click Save

...

  1. and then Submit to save your configuration.

...

Step 4: Create a Jira Bug Issue

  1. Create a Jira bug issue. If everything

...

  1. is configured correctly, a new Azure DevOps work item should be automatically created, and all operations

...

  1. will be logged

...

  1. in the Execution Logs.

Step 5

...

(Extra): Audit Log

The audit log will display the created Listener configuration logs

...

, and any future updates to the integration will be logged as well.

Example Screenshots

Listener screen:

...

Image Added

First Action:

...

Image Added

Second Action:

...

Image Added

Execution Logs:

...

Image Added