Overview

This article explains how to add and configure a new datasource for Custom Reports.

Add a Datasource

1. From Dashboard Hub, click and select Add Datasource. The datasource selection window displays.

2. Select Custom Report. The Custom Report configuration form displays.

   1. Provide a descriptive name for the datasource.

   2. Enter the Jira instance URL.

   3. Select an authorization type and enter any required values for that selection.

3. Click Add to create the datasource.

Add a Custom Report

1. From your dashboard, add a Custom Report.

2. In the configuration window, select Load Template.

3. Select the datasource added previously.

4. Click Open Editor. The JSON for the fields in the datasource displays and can be configured.

Configure the datasource

1. You will see datasource:// pre-populated with the URI of the datasource.

2. Optionally, define a JQL query variable using ${jql} syntax. Set the JQL query value in the designated field.

3. The response from the API will be mapped to a table.

4. Define the columns in the table by mapping attributes and fields returned by the API:

   • key: maps to the issue key.

   • fields.summary: maps to the issue summary field.

   • fields.status.name: maps to the issue status name.

5. Save the report configuration.