Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Aura divider
summaryData Sources
paramsJTdCJTIydHlwZSUyMiUzQSUyMnRleHQlMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhUGFwZXJQbGFuZSUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTI0JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0EzMiUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiUyQyUyMnRleHQlMjIlM0ElMjJEYXRhJTIwU291cmNlcyUyMiU3RCUyQyUyMmJvcmRlciUyMiUzQSU3QiUyMnRvcCUyMiUzQWZhbHNlJTJDJTIycmlnaHQlMjIlM0FmYWxzZSUyQyUyMmJvdHRvbSUyMiUzQXRydWUlMkMlMjJsZWZ0JTIyJTNBZmFsc2UlMkMlMjJjb2xvciUyMiUzQSUyMiUyMzMzMyUyMiUyQyUyMnN0eWxlJTIyJTNBJTIyc29saWQlMjIlMkMlMjJ3aWR0aCUyMiUzQTElN0QlMkMlMjJzaXplJTIyJTNBJTdCJTdEJTdEJTdE
Image Added

Aura divider
summaryOverview
paramsJTdCJTIydHlwZSUyMiUzQSUyMnRleHQlMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhUGFwZXJQbGFuZSUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTI0JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0ExOCUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiUyQyUyMnRleHQlMjIlM0ElMjJPdmVydmlldyUyMiU3RCUyQyUyMmJvcmRlciUyMiUzQSU3QiUyMnRvcCUyMiUzQWZhbHNlJTJDJTIycmlnaHQlMjIlM0FmYWxzZSUyQyUyMmJvdHRvbSUyMiUzQXRydWUlMkMlMjJsZWZ0JTIyJTNBZmFsc2UlMkMlMjJjb2xvciUyMiUzQSUyMiUyMzMzMyUyMiUyQyUyMnN0eWxlJTIyJTNBJTIyc29saWQlMjIlMkMlMjJ3aWR0aCUyMiUzQTElN0QlMkMlMjJzaXplJTIyJTNBJTdCJTdEJTdEJTdE

The Data Sources tab gives admins the ability to pull data into Custom Charts that is not stored directly on Jira issues. This will often require additional authentication and be restricted so you can limit which users can see the data.

Panel
panelIconIdatlassian-check_mark
panelIcon:check_mark:
bgColor#EAE6FF

Currently, the only data source available is Insight on Jira Cloud.

Aura divider
summaryLearn more
paramsJTdCJTIydHlwZSUyMiUzQSUyMnRleHQlMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhUGFwZXJQbGFuZSUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTI0JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0ExOCUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiUyQyUyMnRleHQlMjIlM0ElMjJMZWFybiUyMG1vcmUlMjIlN0QlMkMlMjJib3JkZXIlMjIlM0ElN0IlMjJ0b3AlMjIlM0FmYWxzZSUyQyUyMnJpZ2h0JTIyJTNBZmFsc2UlMkMlMjJib3R0b20lMjIlM0F0cnVlJTJDJTIybGVmdCUyMiUzQWZhbHNlJTJDJTIyY29sb3IlMjIlM0ElMjIlMjMzMzMlMjIlMkMlMjJzdHlsZSUyMiUzQSUyMnNvbGlkJTIyJTJDJTIyd2lkdGglMjIlM0ExJTdEJTJDJTIyc2l6ZSUyMiUzQSU3QiU3RCU3RCU3RA==
Aura divider
summaryConnect Custom Charts to Insight
paramsJTdCJTIydHlwZSUyMiUzQSUyMnRleHQlMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhUGFwZXJQbGFuZSUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTI0JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0EyNCUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiUyQyUyMnRleHQlMjIlM0ElMjJDb25uZWN0JTIwQ3VzdG9tJTIwQ2hhcnRzJTIwdG8lMjBJbnNpZ2h0JTIyJTdEJTJDJTIyYm9yZGVyJTIyJTNBJTdCJTIydG9wJTIyJTNBZmFsc2UlMkMlMjJyaWdodCUyMiUzQWZhbHNlJTJDJTIyYm90dG9tJTIyJTNBdHJ1ZSUyQyUyMmxlZnQlMjIlM0FmYWxzZSUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc3R5bGUlMjIlM0ElMjJzb2xpZCUyMiUyQyUyMndpZHRoJTIyJTNBMSU3RCUyQyUyMnNpemUlMjIlM0ElN0IlN0QlN0QlN0Q=

Anchor
connectinsight
connectinsight

Aura panel
summaryNote
paramsJTdCJTIyYm9keSUyMiUzQSU3QiU3RCUyQyUyMmhlYWRlciUyMiUzQSU3QiUyMmljb24lMjIlM0ElN0IlMjJzaXplJTIyJTNBMjYlMkMlMjJuYW1lJTIyJTNBJTIyZmEtZXhjbGFtYXRpb24tY2lyY2xlJTIyJTJDJTIyY29sb3IlMjIlM0ElMjIlMjNmZmZmZmYlMjIlN0QlMkMlMjJiYWNrZ3JvdW5kQ29sb3IlMjIlM0ElN0IlMjJjb2xvciUyMiUzQSUyMiUyMzY1NTRjMCUyMiU3RCU3RCUyQyUyMmhlYWRsaW5lJTIyJTNBJTdCJTIyYWxpZ25tZW50JTIyJTNBJTdCJTIyaG9yaXpvbnRhbCUyMiUzQSUyMmNlbnRlciUyMiU3RCUyQyUyMnRleHQlMjIlM0ElN0IlMjJ0ZXh0JTIyJTNBJTIyTm90ZSUyMiUyQyUyMmZvbnRTaXplJTIyJTNBMTglMkMlMjJjb2xvciUyMiUzQSUyMiUyM2ZmZmZmZiUyMiUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiU3RCU3RCUyQyUyMmJhc2UlMjIlM0ElN0IlMjJiYWNrZ3JvdW5kQ29sb3IlMjIlM0ElN0IlMjJjb2xvciUyMiUzQSUyMiUyM2ZmZmZmZiUyMiU3RCUyQyUyMmJvcmRlclJhZGl1cyUyMiUzQSU3QiUyMnJhZGl1cyUyMiUzQTglN0QlMkMlMjJib3JkZXIlMjIlM0ElN0IlMjJ3aWR0aCUyMiUzQTElMkMlMjJjb2xvciUyMiUzQSUyMiUyMzE3MmI0ZCUyMiUyQyUyMnRvcCUyMiUzQXRydWUlMkMlMjJyaWdodCUyMiUzQXRydWUlMkMlMjJib3R0b20lMjIlM0F0cnVlJTJDJTIybGVmdCUyMiUzQXRydWUlMkMlMjJzdHlsZSUyMiUzQSUyMnNvbGlkJTIyJTdEJTdEJTdE

The user must have a valid Jira Service Management license and a valid API token.

First, enable enable the Insight custom field feature, you can complete the following steps:

  1. Navigate to the Custom Charts - Settings page, and open the Data sources tab

    1. From the top navigation bar in Jira, choose Apps > Manage your apps

    2. Choose Custom Charts - Settings in the Custom Charts section of the Apps page

    3. From the Custom Charts - Settings page, choose Data sources

  2. Find the Insight custom fields panel and click the grey down arrow to expand it

  3. On the right side of the section, click the grey toggle to enable the feature (it’s enabled once the toggle turns green)

  4. In the Email box, enter the email address of the user whose permissions will be used to load the Insight custom fields

    1. (info) Reminder: This user must have a valid Jira Service Management license. They do not require any additional Insight-specific permissions.

  5. In the API token box, enter the API token for this user

    1. Atlassian documentation on creating an API token: https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/

  6. Click Test connection then Save once you’ve connection is confirmed

  7. Select the Jira Groups with users who should be able to view Insight custom field data in Custom Charts

    1. Users who are not in these groups will simply see the Insight object ID instead of the object name while viewing charts

Image Added
Aura divider
summaryTroubleshooting the Connection
paramsJTdCJTIydHlwZSUyMiUzQSUyMnRleHQlMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhUGFwZXJQbGFuZSUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTI0JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0EyNCUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiUyQyUyMnRleHQlMjIlM0ElMjJUcm91Ymxlc2hvb3RpbmclMjB0aGUlMjBDb25uZWN0aW9uJTIyJTdEJTJDJTIyYm9yZGVyJTIyJTNBJTdCJTIydG9wJTIyJTNBZmFsc2UlMkMlMjJyaWdodCUyMiUzQWZhbHNlJTJDJTIyYm90dG9tJTIyJTNBdHJ1ZSUyQyUyMmxlZnQlMjIlM0FmYWxzZSUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc3R5bGUlMjIlM0ElMjJzb2xpZCUyMiUyQyUyMndpZHRoJTIyJTNBMSU3RCUyQyUyMnNpemUlMjIlM0ElN0IlN0QlN0QlN0Q=

Anchor
troubleshooting
troubleshooting

Expand
titleTesting connection fails

There is an issue with either your API Token or email address. Double check the email address is correct and that you’ve followed the steps to create an API token for that email: https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/

Expand
titleA user is seeing the object keys instead of the object name

If all users are seeing the object keys instead of the name, that means the Data Source is not fully configured.

Make sure to add groups under the group picker to select which users should be able to view Insight objects in Custom Charts

Navigate to the Data sources tab and click ‘Test Connection’. If this check is green, then the access shouldn’t be the problem.