Intro
JIRA helps teams get organized and work together to build incredible products, but product teams are just one part of your organization. With Domo, you can combine data from multiple sources into a single platform--pulling data from product development, marketing, sales, operations, and finance for a real-time, holistic view of your business. Once your data is in Domo, you can get stunning, dynamic JIRA visualizations with real-time data, on any device.
Domo's JIRA connector allows you to connect to your JIRA account to extract data from JIRA. You can import data including issue tracking, completed tickets per team, ticket resolution time, and project management metrics, using either custom or predefined queries. To learn more about the JIRA API, see https://developer.atlassian.com/jira...e-query-issues.
The JIRA Rest API Connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking Cloud App in the toolbar at the top of the window.
You connect to your JIRA account in the Data Center. This topic discusses the fields and menus that are specific to the JIRA connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Primary Use Cases |
|
Primary Metrics |
|
Primary Company Roles |
Product managers |
Average Implementation Time |
This can vary wildly depending on the implementation and the user's level of knowledge of their JIRA system. |
Ease of Use (on a 1-to-10 scale with 1 being easiest) |
7 |
Best Practices
-
You should usually use "Replace" with the JIRA connector, as "Append" does not work well.
-
If the query is for data across a long time period, scheduling should be kept to a minimum (once a day). For shorter queries, more frequent updates are appropriate.
Prerequisites
To connect to your JIRA account and create a DataSet, you must have the following:
-
The username and password/API key you use to log into JIRA. The Jira cloud users must use an API Key. You can create one here: http://id.atlassian.com
-
The URL for your company's JIRA instance
-
The JQL query you will use to pull data (if you are building a custom report)
Credentials are received upon account creation. A JIRA Admin is likely to have created username and passwords for most users in your company if you use an on-premise JIRA implementation.
SSO
Single Sign-On (SSO) credentials will NOT work. However, you can work around SSO limitations by doing the following:
-
Have your JIRA administrator create a local account with a username and password specifically for API use.
-
Create an API key at http://id.atlassian.com/.
-
On the JIRA connector page in Domo, enter the API key you created instead of the password. (Depending on the account, you may need to enter your username or JIRA account email address as the username.)
Connecting to Your JIRA Instance
This section enumerates the options in the Credentials and Details panes in the JIRA Rest PAI Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your JIRA instance. The following table describes what is needed for each field:
Field |
Description |
---|---|
Username |
Enter the username you use to log into your JIRA instance. |
Password |
Enter the password you use to log into your JIRA instance. The Jira cloud users must use an API Key. You can create one here: http://id.atlassian.com |
Server URL |
Enter the URL for your JIRA instance (for example, onjira.mycompany.com). |
Once you have entered valid JIRA credentials, you can use the same account any time you go to create a new JIRA Rest API DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.
Menu |
Description |
||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report |
Select the report you want to run. The following reports are available:
|
||||||||||||||||||
JQL Query |
Enter a JQL query to pull custom data. Jira Documentation.
|
||||||||||||||||||
Data Option |
|
||||||||||||||||||
Filter Type | Select to include or exclude specific fields from the returned dataset. | ||||||||||||||||||
Group Name | Enter the group that contains the users you wish to retrieve. This report requires an Administrator account. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.
Troubleshooting
-
Jira requires a fair amount of configuration from the side of the JIRA admin to ensure that API access is enabled. Common issues include setting the timeouts too short or not providing sufficient resources to the JIRA server.
-
If users have trouble understanding how to format JQL, the easiest thing is to log into the JIRA front end. Via the search bar, JIRA provides a tool that can construct a JQL query with preset filters. After constructing your query, if you hit the Advanced button, JIRA presents you with your selections in JQL format.
Comments
0 comments
Please sign in to leave a comment.