Connecting to Bitbucket (extractor)

Important

Any references to third-party products or services do not constitute Celonis Product Documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice.

Celonis does not warrant the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems.

The Celonis Bitbucket extractor integrates the Celonis Platform with your Atlassian Bitbucket Cloud instance to retrieve repository data through the REST API. It supports the following basic features:

Prerequisites

This section details important prerequisites or prerequisite knowledge for using this extractor.

Bitbucket authentication methods

The Bitbucket Cloud REST API uses basic authentication or OAuth2:

Basic authentication: Provide a username and password.
OAuth2: Provide a client ID and client secret.

For both authentication methods you must also supply the project and repository name as parameters.

Available Bitbucket Cloud endpoints

Method	Endpoint	Description
GET	Branches	Retrieve data about branches.
GET	Commits	Retrieve data about commits.
GET	Hooks	Retrieve data about hooks.
GET	Pull Requests Pull Request Activity Pull Request Commits	Retrieve data about pull requests.
GET	Tags	Retrieve data about tags.

Further Bitbucket Cloud information

For more information about Bitbucket Cloud, see: Bitbucket Cloud Documentation - REST APIs.

Configuring the Bitbucket extractor

This section describes the basic setup of configuring the Bitbucket extractor. To configure the extractor:

In the Celonis Platform left navigation, select Data > Data Integration.
On the Data Pools screen, select the data pool where you want to integrate the extractor. This opens the Data Integration window.
Note
If you have not yet configured a data pool for this data set, see Creating and managing data pools.
In the Input section, select the Connect to Data Source tile. This opens the Add Data Connection window.
Note
If this is not the data pool's first connection, the Data Connections window opens below. Select + Add Data Connection to add a new connection.
In the Add Data Connection window, select Connect to Data Source. This opens the in-tool connection catalog.
In the connection catalog, select the Bitbucket extractor. This opens the configuration window.
In the configuration window, provide the requested data for each field.
(Optional) Toggle the Advanced settings option to open the advanced configuration options. Read through each option and update as needed.
Select the Test Connection button to confirm the extractor can connect to the host system. If the test fails, adjust the data in the configuration fields as needed.
Once the test connection passes, select the Save button to continue. This returns you to the Data Integration window.

You have now connected the Bitbucket extractor to your host system. To create and execute data jobs, see Extracting and transforming data.