Tableau Connector Pro for Jira app integrates with Insight in Jira Service Management. This integration further extends the capabilities of Insight asset and configuration management in Jira cloud and DC/Server to visualize the required data for actionable insights in Tableau. With this integration, you can import Insight Attributes and Insight Types field information to Tableau Desktop.
| Info |
|---|
|
| Note |
|---|
Steps to integrate Tableau Connector Pro for Jira and Insight in Jira Service Management
| Info |
|---|
| If you are using Jira Software Cloud Premium or Enterprise, then Insight asset and service management functionality is already included Pre-requisite to use Insight (Assets):
|
Steps to integrate Tableau Connector Pro for Jira and Insight in Jira Service Management
| Info |
|---|
|
Navigate to Jira > Tableau Pro > My Connector URL and copy the Tableau Web Data Connector URL. For more information, refer toMy Connector URL.
2. Navigate to Tableau Desktop > Web Data Connector.Enter the Tableau Web Data Connector URL to Tableau Desktop as a Data Source to import the data into Tableau. For more information, refer to Import into Tableau.
...
4. A form displays the Jira and JSM fields. The Insight Attributes and Insight Types list the Insight fields.
Import the Insight data
Tableau Connector Pro for Jira Cloud
a. To import the Insight data, you need to set up the Email and API Token once. Enter the Email and API Token to grant access to Insight dataand select the required Insight fields for the data source. Click Continue.
...
| Info |
|---|
|
Insight Attributes
...
| Info |
|---|
|
to know more about Asset Query Language syntax and usage. Refer to 
Select the required Insight Attributes to import.
...
d. To import the Insight data, click Continue. To know about the checks performed before importing Insight data, refer to Form validation.
Tableau Connector Pro for Jira Data Center
a. To import the Insight data, select the required Insight fields for the data source and click Continue.
...
| Info |
|---|
|
Select the required Insight attributes to import.
...
d. Click Continue. To know about the checks performed before importing Insight data, refer to Form validation.
Data imported in Tableau Desktop
The Insight data gets imported and appears in a table format in Tableau.
...
| Anchor | ||||
|---|---|---|---|---|
|
On the click of Continue, the form is validated for the Email and API Token and the AQL syntax in sequence before importing the Insight data.
...
The AQL syntax is validated once the Email and API Token pass the validation check. The error message is displayed if the AQL syntax is not valid. For more information about error handling, refer to AQL syntax validation.
...
| Anchor | ||||
|---|---|---|---|---|
|
Assets Query Language (AQL) is a language format used in Assets in Jira Service Management to create search queries for one or more objects.
Basic syntax
The basic syntax of an AQL query is <attribute> <operator> <value/function>. The query returns one or more objects when the attributes of these objects match the operator and value specified.
...
Example | Query | ||
|---|---|---|---|
Limit the search result to a specific object schema name. |
| ||
Limit the search result on object schema ids. |
| ||
Limit the search result to a specific object type. |
| ||
Limit the search result on object type ids. |
| ||
Search all attributes on all objects for a relevant match. |
| ||
Limit the search to the object having any inbound references to it. |
| ||
Find an object by object Id. |
|
| Anchor |
|---|
...
|
...
|
The Assets app manages the AQL syntax validation and error messages.
...
Example | Query provided with invalid syntax | Error message | ||
|---|---|---|---|---|
Limit the search result to a specific object schema name. |
|   | ||
Limit the search result on object schema ids. |
|   | ||
Limit the search result to a specific object type. |
|   |