- 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
Note: Extracting data from Atlassian is similar toextracting 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
Note: Loading data in Atlassian is similar toloading 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.