Atlassian connectors

Starter
Business
Enterprise
On-Premise
Add-on

Overview

Etlworks Atlassian connectors allows fast, real-time access to Atlassian data. The connectors supports most of the objects available through the Atlassian API and work like any other connector for connected app.

Etlworks partnered with CData to provide access to the Atlassian API using industry-standard JDBC protocol.

When to use Atlassian connectors

Use Atlassian connectors to create Flows that work with data in Atlassian apps. The following Atlassian apps are supported. Each app requires a separate connector:

Jira
Jira Service Management
Confluence

Alternative: Free API Connector

In addition to this native connector, Etlworks also offers a generic API Connector that can be used to connect to this platform via its public API. The API connector is free and is a good alternative when the native connector doesn’t support a specific feature or if you prefer working directly with the API.

Prerequisites

You must have active Atlassian account.

Enable Atlassian connectors for your Etlworks account. Contact support@etlworks.com to enable the connector.

Create a Connection

Step 1. In the Connections window, click +, and type in jira or confluence. Select connector for your Atlassian app. Do not select API connectors.

Step 2. Enter Atlassian URL associated with your organization: https://<yoursitename>.atlassian.net

Step 3. Select required Permissions. You can enter more than one permission as a space or column delimited list.

Step 4. Click Sign in with Atlassianto generate an OAuth token. The connector will retrieve the refresh token from the Atlassian authentication endpoint which will be used at runtime to generate the access token.

Step 5. Test and save the Connection.

Connection parameters

Use Other parameters to specify the Connection string options. Read about available Connection string options for each Atlassian Connector:

Atlassian data model

Our connectors model Atlassian entities as relational Tables, Views, and Stored Procedures.

Read about the data model for each Atlassian connector:

Work with data in Atlassian apps

Extract data from Atlassian entities

Extracting data from Atlassian is similar to extracting data from the relational database.

Step 1. Create a Atlassian Connection that will be used as a source (FROM).

Step 2. Create a destination Connection, for example, a Connection to the relational database, and if needed, a Format (Format is not needed if the destination is a database or well-known API).

Step 3. Create a Flow where the source is a connected app, and the destination is a Connection created in step 2, for example, a relational database.

Step 4. Add a new source-to-destination transformation.

Step 5. Select Atlassian Connection created in step 1 as a source Connection and select the Atlassian object you are extracting data from:

Step 6. Select TO Connection, Format (if needed), and object (for example, database table) to load data into.

Step 7. Click MAPPING and optionally enter Source Query (you don't need a query if you are extracting data from the Atlassian object unconditionally).

Step 8. Optionally define the per-field Mapping.

Step 9. Add more transformations if needed.

Load data in Atlassian app

Loading data in Atlassian is similar to loading data into a relational database.

Step 1. Create a source Connection and a Format (if needed).

Step 2. Create a destination Atlassian Connection.

Step 3. Create a Flow where the destination is a connected app.

Step 4. Add new source-to-destination transformation.

Step 5. Select FROM and TO Connections and objects (also a FROM Format if needed).

Step 6. Optionally define the per-field mapping.

Step 7. Add more transformations if needed.

Browse data in Atlassian

You must have a Atlassian Connection to browse objects and run SQL queries.

Use Etlworks Explorer to browse data and metadata in Atlassian and execute SQL queries.