Data Source Guides
      Back to home
      1. Help Center
      2. Data Source Guides

      Guide: Using Jira with Databox

      HOW TO

      How to connect Jira to Databox

      IN THIS SECTION

      How to connect Jira to Databox

      To connect a Jira Account in Databox, go to  Data Manager > + New connection. Type Jira in the search bar and click on the green Connect button. 

      This will open the Authorization window, which is where you will be prompted to enter your Domain, Email and API Token. 

      Your Domain should look like "https://your-instance.atlassian.net/" You can find your Jira Instance Domain in three ways:

      Check your email Jira web interface

       Ask your administrator: If you're part of an organization using Jira, you can ask your Jira administrator for the domain.

      Once you have your Jira Domain, paste it in Databox's Activate Jira window. You will also need to enter your Email, which you use to log in to Jira. 

      To find or generate your API Token, follow the steps below:

      Atlassian Atlassian Account > Security > API Token

       Click on Create and manage API tokens to find or create your API Token. 

      API Token Activate Jira 

      Once you have pasted the Domain, Email and API Token in Databox's Activate Jira Window, click the green Activate button to authorize the Databox app.

      Which Jira permissions have API access?

      To connect a Jira Account in Databox, you must have "Global" permissions in Jira. If you do not have "Global" user permissions, you will receive an "Authentication Failed" error. 

      Learn how to manage Global permissions in Jira here. 

      Single Sign-in Option (SSO) is not currently supported. 

      How much historical data is synced when you first connect Jira to Databox?

      When you connect a new Jira Data Source in Databox, 24 months worth of historical data is initially synced. 

      Certain Metrics may have more or less historical data available. For more information about the amount of historical data available for a specific Metric, please contact our Support Team at help@databox.com.

      Pro Tip: Once your Jira Data Source is connected and actively syncing data, we store the data that's collected in our own database. This allows us to accumulate more data over time as more data syncs are made so that you can report on more historical Jira data in your Databox reports. Learn more here. 

      What time zone does Jira data sync in? 

      Jira data is synced in the time zone set in the Jira Account. For example, if your Jira Account time zone is set as EST, your Jira data will sync with Databox in EST. 

      How to access pre-built Jira Templates

       
      1. Navigate to Databoards > Public Templates
      2. In the Data Source drop-down list, select Jira
      3. To view a preview of the Template populated with dummy data, click Preview
      4. To pull the Template into your Account and re-populate it with your own Jira data, click Use Template
      5. Select the appropriate Jira Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected Jira Account and can be found on the  Databoards page

      Pro Tip: Once the Databoard is available on the Databoards page, it is completely disconnected from the public Template. Therefore, you can further customize this Databoard to meet your specific needs using the Designer.

      Popular Jira Templates

      Jira Software

      		 
      This dashboard will help you track some standard Metrics from your Jira account, including Issues by Status, Resolved Issues, and more. 

      How to build a Databoard using Jira data

      IN THIS SECTION

      Popular Jira Metrics

       

      Bugs Reported Issues Created Issues Resolved

           
      Completed Work by Projects Completed Work by Implementer Issues in Progress

      View a full list of Jira Metrics available in Databox here.

      How to build a Databoard

      1. Navigate to  Databoards > + New Databoard > Start Blank
      2. Click on the Metric Library icon on the lefthand side of the Designer
      3. Select the appropriate Jira Account from the Data Source drop-down list in the Metric Library
      4. View the list of pre-built Jira Datablocks in the Metric Library. Drag and drop your selected Datablock onto your Databoard   
      5. If a pre-built Datablock isn't available for your use case, click on the  Visualization Types icon under the Metric Library icon
      6. View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard
      7. Click on the Datablock on the Databoard to open the corresponding Datablock Settings on the righthand side of the Designer
      8. Select the appropriate Jira Data Source and Metric in the righthand Datablock Settings. This will update the Datablock and it will populate the Datablock with the corresponding data
      9. Complete steps 4-8 until your Databoard is complete

      How to use the Metric Builder for Jira

      The Metric Builder for Jira allow you to create Custom Metrics based on Assignee, Project, Priority, and more. Learn more about the Metric Builder for Jira here. 

      Additional Information

      • Single Sign-in Option (SSO) is currently not supported.