JDBC TUTORIAL

How to Connect Tableau to JIRA

Updated: 02 Feb 2024

Leverage JIRA data with Tableau

JIRA is a leading project management tool which tracks the development and maintenance of world-class, enterprise software. Business analytics tools such as Tableau, Tibco, and SAP Lumira can be used to visualize the data consumed by JIRA, transforming it into valuable business insights. However, a key challenge in visualizing JIRA data with analytics tools is the ability to connect to and securely access your JIRA data. The Autonomous REST Connector from Progress DataDirect offers a secure, flexible solution for connecting Tableau to JIRA. This tutorial walks you through the process of connecting Tableau to JIRA using the JDBC connector (or driver) on Windows. The following topics are covered:

  • Download and install Autonomous REST Connector for Windows
  • Select the JIRA model and create a connection
  • Connect Tableau to JIRA

Download and install Autonomous REST Connector for Windows

  1. Navigate to the Autonomous REST Connector for JDBC page and select the Windows connector to download.
  2. The Autonomous REST Connector for JDBC provides JDBC connectivity to Jira and many other REST APIs.

  3. When prompted, provide your details, such as name and email address; then, click DOWNLOAD. The download link is sent to you via email.
  4. Download the connector zip file and extract its contents into a temporary directory; then, double-click the installer program:
    • PROGRESS_DATADIRECT_JDBC_INSTALL.exe
  5. Follow the prompts to complete the installation.

Select the JIRA model and create a connection

  1. Open the Autonomous REST Composer by selecting the Autonomous REST Composer (JDBC) icon from your desktop or the Windows Start menu. The Autonomous REST Composer opens in your default web browser.

    Note: The Autonomous REST Composer is the Autonomous REST Connector's interface for selecting or building REST API models.

  2. Type JIRA in the search field; then, select the JIRA model. The Connection tab for the JIRA model opens.

  3. Provide a value for the Server Name property. The value should be the host name portion of the HTTP endpoint to which you send requests. It should not include the preceding portion of the URL: https://. For example, a JIRA endpoint would take the following form: mycompany.atlassian.net.
  4. From the Authentication Method drop-down, select Basic. Then, provide values for the following properties.

    Note: The Autonomous REST Connector supports basic authentication to connect to the JIRA API. Basic authentication is supported with the user of an Atlassian account email address and an API token. For details, refer to Basic auth for REST APIs in the Atlassian Developer documentation.

    • User: Enter your Atlassian account email address.
    • Password: Enter your API token. API tokens can be created from the Atlassian API Tokens page.
  5. Set the values for any optional properties that you want to configure.
  6. To test your configuration:
    1. Click Test Connect or select the SQL Editor tab from the side menu.
    2. From the SQL Editor screen, expand AUTOREST in the Schema Tree pane to view a list of tables showing JIRA data exposed by the connector.
    3. In the Editor pane, specify a query that you would like to test.
    4. Click Execute.

      Note: If successful, the driver will return your results in the Results pane.

  7. Download your model file:
    1. Select the Configure Endpoints tab.
    2. Optionally, add, remove, or edit endpoints that are used to return data for use with SQL-based applications.
    3. Click Download to save your model file.

    Note: When configuring the connection to JIRA in Tableau, you will need to specify the fully qualified path to your JIRA model file in the Tableau connection URL. The connection string generated by the Autonomous REST Composer does not automatically provide a location.

  8. As you provide values for properties, the Composer generates a connection string. You may use this connection string as the basis for the Tableau connection to JIRA. Take the following steps to prepare the Tableau connection URL:
    1. On the Set Authentication tab, click the copy button and paste the connection string into a text editor.
    2. Replace the server name information (servername=progresssoftware.atlassian.net) with the fully qualified path to your JIRA model file using the Config property (Config='C:\Users\windows-user\Downloads\Jira.rest'). The revised connection string may be used as the Tableau connection URL. For example:
      jdbc:datadirect:autorest:Config='C:\Users\windows-user\Downloads\Jira.rest';authenticationmethod=Basic;user=atlassian-email-address;password=atlassian-api-token;

Connect Tableau to JIRA

Before you begin, you must have Tableau Desktop installed. You may download and install Tableau Desktop from the Tableau Desktop Trial page.

  1. Navigate to the \lib\xx subdirectory of the Progress DataDirect installation directory; then, locate the autorest.jar file. This is the Autonomous REST Connector driver jar file.
  2. Copy the autorest.jar file into the following directory:
    C:\Program Files\Tableau\Drivers
  3. Open Tableau. From the Connect menu, select Other Databases (JDBC).
  4. In the Other Databases (JDBC) dialog, provide values for the following fields; then, click Sign In.
    • URL: Copy and paste your connection URL into this field. For example:
      jdbc:datadirect:autorest:Config='C:\Users\windows-user\Downloads\Jira.rest';authenticationmethod=Basic;user=atlassian-email-address;password=atlassian-api-token

      Note: The connection string generated by the Autonomous REST Connector may be used as the basis of the Tableau connection URL. The connection string must be modified such that server name information (ServerName=progresssoftware.atlassian.net) is replaced with the fully qualified path to your JIRA model file using the Config property (Config='C:\Users\windows-user\Downloads\Jira.rest'). Downloading the JIRA model file is described in Step 7 in the preceding section.

    • Dialect: Select SQL92 (the default) from the drop-down box.
    • Username: Enter your Atlassian account email address if you did not include it in the connection URL.
    • Password: Enter your API token if you did not include it in the connection URL.
  5. The Data Source window appears. In the Schema field, select the schema for the service you want to use.
  6. In the Table field, the tables stored in the selected schema are now exposed and available for selection.

Result: You have successfully accessed your data and are now ready to create reports with Tableau. For more information, refer to the Tableau product documentation at http://www.tableau.com/support/help.

Contact us

Thank you for taking the time to consider the Progress DataDirect solution for connecting Tableau to JIRA. Please contact us for additional information. You may also refer to the following resources for more information:

The Autonomous REST Connector provides JDBC and ODBC connectivity to Jira, GitHub, Azure, and many other REST APIs.

Connect any application to any data source anywhere

Explore all DataDirect Connectors

Need additional help with your product?

Get Customer Support