Skip to main content

Celonis Product Documentation

Jira Connection

To set up a JIRA data connection:

Step 1: Choose your Connection Type

Jira allows two different types of connection: Cloud or Server.

In case you want to connect to your Jira Cloud instance, you need to generate an API token with sufficient rights from your Atlassian account:

  1. Log in to https://id.atlassian.com/manage/api-tokens.

  2. Click Create API token.

  3. From the dialog that appears, enter a memorable and concise Label for your token and click Create.

  4. Click Copy to clipboard, then paste the token to your script, or elsewhere to save:

    61dd4e42bad93.png
Step 2: Only if your system is IP-blocked: Whitelist the IPs of the EMS

If your system is only reachable within a certain IP range, you need to whitelist the outbound IPs of the EMS, otherwise data cannot be extracted. The IPs of the EMS are different depending on the cluster (eu-1 or us-1). For more information, see Allowlisting Celonis IP addresses and third party domains.

Step 3: Create a Data Connection in a Data Pool
Step-by-step
  1. Enter the name of the new Jira Data Connection.

  2. Enter the URL of your Jira Instance.

  3. Enter your username. This username is your Jira Login E-mail address.

  4. Enter the API token you have created.

  5. Enter the maximum number of parallel extractions that the data connection allows.

Data Extraction

 

Data Access

The Celonis Extractor performs read-only operations on your Jira data. No writing changes (like updates, deletions) will be performed at any time during the extraction process.

Security

Transfer of the data from the Jira system to the target system is secured through HTTPS, which allows for an encrypted exchange of information.

Used API

The Celonis Cloud Extractor uses the REST API of Jira (Link).

Available Tables

Table

API

issue

/rest/api/2/search

applicationProperties

/rest/api/2/application-properties

applicationRole

/rest/api/2/applicationrole

configuration

/rest/api/2/configuration

dashboard

/rest/api/2/dashboard

field

/rest/api/2/field

groups

/rest/api/2/groups/picker

issueLinkType

/rest/api/2/issueLinkType

issueSecuritySchemes

/rest/api/2/issuesecurityschemes

issueType

/rest/api/2/issuetype

notificationScheme

/rest/api/2/notificationscheme

permissionScheme

/rest/api/2/permissionscheme

project

/rest/api/2/project/search

projectType

/rest/api/2/project/type

projectCategory

/rest/api/2/projectCategory

resolution

/rest/api/2/resolution

role

/rest/api/2/role

serverInfo

/rest/api/2/serverInfo

status

/rest/api/2/status

statuscategory

/rest/api/2/statuscategory

user

/rest/api/2/user/search?username=.

workflow

/rest/api/2/workflow

board

/rest/agile/1.0/board

board$epic

/rest/agile/1.0/board/%s/epic

board$backlog

/rest/agile/1.0/board/%s/backlog

board$issue

/rest/agile/1.0/board/%s/issue

board$spring

/rest/agile/1.0/board/%s/sprint

board$version

/rest/agile/1.0/board/%s/version