Connecting Bold BI to Jira data source

Bold BI dashboard designer supports connecting Jira web services through REST API.

Choose Jira data source

To configure the Jira data source, follow the below steps:

1. Click the Data Sources button in the configuration panel to add a new data connection.

   

2. Click CREATE NEW to launch a new connection from the connection panel.

3. Select the Jira connection in the connection panel.

   

NOTE: You can also create a data source from the home page by clicking the Data Sources menu from left menu panel and Create Data Source from the data sources page.

Create Jira data source

Once you click the data source, the NEW DATA SOURCE configuration panel opens. Follow the below steps to create Jira data source.

1. Enter a name and description (optional) for the data source.

2. Enter a valid Jira REST API in the URL textbox. Refer the Jira API documentation for more details.

3. Choose one of the Request Body type to make a request, either JQL or Raw Query.

4. Choose a time interval for Refresh Settings using the combo box, to trigger the Rest API request periodically to keep the data in sync with our dashboard.

5. Select JSON data type in Data Format combo box.

6. Choose Basic http Authentication under Authentication Type and input a valid Username and API Token.

   

You can also edit the connection information set here using the Edit Connection option.

Request Body Types

JQL

1. Enter your domain name in the Domain URL textbox.

   Example: https://<:your_domain>.atlassian.net

2. Enter a valid JQL Query in JQL field.

   Example: project = weather

3. If you need to add custom fields in JQL filtering, then enable Include Custom Fields and provide the custom fields in enabled text box.

4. In Max Rows, enter the maximum number of rows to be fetched from the Jira data source. This value is used to fetch the data from Jira data source via pagination.

How to get the Custom field ID value from Jira?

1. In your Jira account, Go to the JQL query search under Filters -> Advanced Search.

2. Type a Custom field in the JQL search box and you can view the respective Custom field ID in the dropdown as shown in the following image.

3. You can add the Custom field ID values in the Datasource connection window to retrieve the custom fields data.

   The syntax for adding Custom Fields,

   customfield_<Custom Field ID>

   Here, the Epic Link and Epic Name custom fields are added in the following image.

NOTE:

• The Custom field IDs must be separated by using a comma.
• If you have a Jira Admin account, you can also view the Custom fields ID by the ways mentioned in this link.

How To retrieve any field in Jira

To retrieve any field, including custom fields in Jira and pass the field details to the Include Custom Fields text box, follow these steps:

For Simple Data Type Fields:

• Add the desired simple data types field, such as text, number, or date, to the Custom Fields section.

Example: To fetch the value of the project -> name field, add project to the Custom Fields.

For Nested Fields:

• Split the nested field name using a colon : to identify the nested fields.

• Syntax: <FieldName>:<InnerFieldName>:<Key> For example: To fetch the ID of the status Category of the status. status:statusCategory:id

  

Note:

• When accessing the inner fields of a nested field in Jira, separate the field names with colons (:).
• For fetching a custom field with a specific field ID, follow the same procedure by specifying the Custom field ID followed by a colon and the field ID. For example: "customfield_10018:id".
• Multiple values can be passed as default, nested array, or custom fields in the Include Custom Fields text box, and the values should be separated by commas (,). For example: "customfield_10018:id, status:statusCategory:id".
• When fetching the inner fields of an array, only the first element of the array will be fetched based on the field’s value.

Raw Query

1. Enter a valid URL in the URL field textbox.

   Example:https://<:your_domain>.atlassian.net/rest/api/2/project

2. Select GET method for the REST API in Method combo box.

How do I get API Token for connecting Jira data source?

1. Log in to Generate API Token.
2. Click Create API token.
3. From the dialog that appears, enter a memorable and concise Label for your token and click Create.
4. Click Copy to clipboard, then paste the token to your script, or elsewhere to save.

Additional information

Setting up the URL

1. Replace <:your_domain> with your domain name in the URL.

2. For instance, to get the tasks/issues under specific project, replace your JQL Query in the textarea.

   Sample Domain URL: https://abcde.atlassian.net

   Sample JQL: project = weather

For more information on the API endpoints available for this data source, refer to their official API Documentation

Sample JQL queries

List tasks based on status modified

project = weather AND status CHANGED FROM “In Progress” TO “Open”

List tasks based on status on specified week

project = weather AND status was “In Progress” DURING (startOfWeek(), endOfWeek())

List tasks based on resolution

project = “weather” AND resolution changed to “Done” by currentUser() during (startOfYear(), endOfYear())

List tasks based on fixVersion

project = weather AND fixVersion = latestReleasedVersion(weather)

Preview and data import

• Click Preview & Connect to connect with the configurations set.

• The Choose Schema(s) dialog opens. The schema represents the key fields of data retrieved from Jira Rest API request. This dialog displays a list of schemas in treeview and its corresponding values in grid for preview. Select required schema(s) from treeview to use in designer and click Connect.

  

• Now, the data design view page with selected table schema opens. Drag and drop the table.

• Click Save to save the data source with a relevant name.

Related links

Blog Post

Data Transformation

Editing a Data Connection

Dashboard Designer Walkthrough

Jira Integration