About Openflow Connector for Jira Cloud¶
Note
The connector is subject to the Connector Terms.
This topic describes the basic concepts of Openflow Connector for Jira Cloud, its workflow, and limitations.
The Openflow Connector for Jira Cloud ingests Atlassian Jira issues data to Snowflake. It uses the Jira Cloud REST API and Jira Query Language (JQL) to retrieve data, which is then stored in a Snowflake table. Data ingestion occurs in two phases:
An initial load, where all data is retrieved during the initial API call.
Incremental loads, which merge updates and new data into the destination table and use timestamps from previous calls to limit the result to the issues that were updated since the last load.
Use this connector if you’re looking to do the following:
Extract Jira issues and project details for cross‐team visibility and deeper insights
Workflow¶
A Jira Cloud administrator performs the following tasks:
Generates an API token within the Jira instance with the necessary scopes (
read:jira-work
andread:jira-user
) This token will be used by the connector for authentication.Defines the criteria to search issues, such as project name, created field, and updated field.
A Snowflake account administrator performs the following tasks:
Downloads the connector definition file and imports it into the Snowflake Openflow canvas.
Configures the connector:
Provides the Jira API token.
Specifies the Jira instance URL.
Defines the criteria for the issues being ingested, by providing JQL query or, for simpler cases just the project name.
Sets the database and schema names in the Snowflake account.
Runs the connector flow in the Openflow canvas. Upon execution, the connector performs the following actions:
Creates an API call to fetch issues from the configured Jira instance.
Extracts relevant data, such as issue creation dates, statuses, and assignees.
Creates the configured destination table in the Snowflake database if the API call returned at least one result.
Loads the processed data into the specified Snowflake table.
Snowflake Business users can then access views, and perform operations on the data downloaded from Jira Cloud to destination tables.
Limitations¶
Each connector instance can be associated with only one JQL search query.
Timestamps in connector properties reflect the timezone of Jira Cloud, potentially resulting in discrepancies with the user’s local timezone. The Jira Cloud timezone is fetched once and kept in the state of the FetchJiraIssues processor. Updating the connector’s timezone requires clearing the state of this processor.
The connector is unable to reflect deletions in the target Snowflake tables as the Jira Cloud REST API does not return information about data deletion.
Basic authentication using an email and API token is the only supported authorization method. As a result the connector can only ingest data accessible by the owner of the API token.
The FetchJiraIssues processor is single threaded, and designed to work on the primary node.