Connecting to Jira Cloud (extractor)
The Celonis Jira Cloud extractor integrates the Celonis Platform with Atlassian Jira Cloud to retrieve project, issue, board, and workflow data via the REST API. It supports the following basic features:
Prerequisites
This section details important prerequisites or prerequisite knowledge for using this extractor.
The Jira Cloud REST API uses basic authentication. To connect to your Jira Cloud instance, you need to provide your instance URL, a username, and a password.
Note
The password must be a Jira API token. For more information see the Jira API token documentation.
The default Jira Cloud extractor allows you to retrieve data from the tables and columns list here.
The following tables and their related APIs are available:
Table | API |
|---|---|
applicationProperties | /rest/api/2/application-properties |
applicationRole | /rest/api/2/applicationrole |
board | /rest/agile/1.0/board |
board$backlog | /rest/agile/1.0/board/%s/backlog |
board$epic | /rest/agile/1.0/board/%s/epic |
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 |
configuration | /rest/api/2/configuration |
dashboard | /rest/api/2/dashboard |
field | /rest/api/2/field |
groups | /rest/api/2/groups/picker |
issue | /rest/api/2/search |
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 |
projectCategory | /rest/api/2/projectCategory |
projectType | /rest/api/2/project/type |
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 |
The following column types are supported by the Jira Cloud extractor:
Any
Array
Date
Datetime
Number
Option
Option-with-child
String
User
Version
Note
For all other column types, you must change the type from custom field to a string for it to be visible.
Data access: The 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 Celonis Platform is secured through HTTPS, which allows for an encrypted exchange of information.
For further information about the Jira Cloud REST API, see: Atlassian Developer - REST API.
Configuring the Jira Cloud extractor
This section describes the basic setup of configuring the Jira Cloud extractor. To configure the extractor:
Note
For configuration, the Jira Cloud extractor requires a bearer token be used for the Password field. For more information, see Jira Cloud authentication methods.