Versions Compared

Key

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

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 Assets (formerly Insight)on Jira Cloud.

Aura divider
summaryLearn more
paramsJTdCJTIydHlwZSUyMiUzQSUyMnRleHQlMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhUGFwZXJQbGFuZSUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTI0JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0ExOCUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiUyQyUyMnRleHQlMjIlM0ElMjJMZWFybiUyMG1vcmUlMjIlN0QlMkMlMjJib3JkZXIlMjIlM0ElN0IlMjJ0b3AlMjIlM0FmYWxzZSUyQyUyMnJpZ2h0JTIyJTNBZmFsc2UlMkMlMjJib3R0b20lMjIlM0F0cnVlJTJDJTIybGVmdCUyMiUzQWZhbHNlJTJDJTIyY29sb3IlMjIlM0ElMjIlMjMzMzMlMjIlMkMlMjJzdHlsZSUyMiUzQSUyMnNvbGlkJTIyJTJDJTIyd2lkdGglMjIlM0ExJTdEJTJDJTIyc2l6ZSUyMiUzQSU3QiU3RCU3RCU3RA==
Table of Contents
minLevel2
maxLevel6
outlinefalse
typelist
printablefalse
Aura divider
summaryConnect Custom Charts to Insight
paramsJTdCJTIydHlwZSUyMiUzQSUyMmljb24lMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhLWNoYXJ0LWNvbHVtbiUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTE4JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0EyNCUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiUyQyUyMnRleHQlMjIlM0ElMjJDb25uZWN0JTIwQ3VzdG9tJTIwQ2hhcnRzJTIwdG8lMjBJbnNpZ2h0JTIyJTdEJTJDJTIyYm9yZGVyJTIyJTNBJTdCJTIydG9wJTIyJTNBZmFsc2UlMkMlMjJyaWdodCUyMiUzQWZhbHNlJTJDJTIyYm90dG9tJTIyJTNBdHJ1ZSUyQyUyMmxlZnQlMjIlM0FmYWxzZSUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc3R5bGUlMjIlM0ElMjJzb2xpZCUyMiUyQyUyMndpZHRoJTIyJTNBMSU3RCUyQyUyMnNpemUlMjIlM0ElN0IlN0QlN0QlN0Q=

Connect Custom Charts to Assets

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

  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

Aura divider
summaryTroubleshooting the Connection
paramsJTdCJTIydHlwZSUyMiUzQSUyMmljb24lMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhLWNoYXJ0LWxpbmUlMjIlMkMlMjJjb2xvciUyMiUzQSUyMiUyMzMzMyUyMiUyQyUyMnNpemUlMjIlM0ExOCU3RCUyQyUyMnRleHQlMjIlM0ElN0IlMjJjb2xvciUyMiUzQSUyMiUyMzMzMyUyMiUyQyUyMmZvbnRTaXplJTIyJTNBMjQlMkMlMjJ0ZXh0QWxpZ24lMjIlM0ElMjJsZWZ0JTIyJTJDJTIyZm9udFdlaWdodCUyMiUzQSUyMmxpZ2h0ZXIlMjIlMkMlMjJ0ZXh0JTIyJTNBJTIyVHJvdWJsZXNob290aW5nJTIwdGhlJTIwQ29ubmVjdGlvbiUyMiU3RCUyQyUyMmJvcmRlciUyMiUzQSU3QiUyMnRvcCUyMiUzQWZhbHNlJTJDJTIycmlnaHQlMjIlM0FmYWxzZSUyQyUyMmJvdHRvbSUyMiUzQXRydWUlMkMlMjJsZWZ0JTIyJTNBZmFsc2UlMkMlMjJjb2xvciUyMiUzQSUyMiUyMzMzMyUyMiUyQyUyMnN0eWxlJTIyJTNBJTIyc29saWQlMjIlMkMlMjJ3aWR0aCUyMiUzQTElN0QlMkMlMjJzaXplJTIyJTNBJTdCJTdEJTdEJTdE

Troubleshooting the Connection

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.

Aura divider
summaryAura Divider
paramsJTdCJTIydHlwZSUyMiUzQSUyMmljb24lMjIlMkMlMjJzdHlsZSUyMiUzQSU3QiUyMmFsaWdubWVudCUyMiUzQSU3QiUyMmhvcml6b250YWwlMjIlM0ElMjJjZW50ZXIlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIybmFtZSUyMiUzQSUyMmZhLWNoYXJ0LXBpZSUyMiUyQyUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyc2l6ZSUyMiUzQTE4JTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzMzMzJTIyJTJDJTIyZm9udFNpemUlMjIlM0ExNCUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIyYm9sZCUyMiUyQyUyMnRleHQlMjIlM0ElMjJBdXJhJTIwRGl2aWRlciUyMiU3RCUyQyUyMmJvcmRlciUyMiUzQSU3QiUyMnRvcCUyMiUzQWZhbHNlJTJDJTIycmlnaHQlMjIlM0FmYWxzZSUyQyUyMmJvdHRvbSUyMiUzQXRydWUlMkMlMjJsZWZ0JTIyJTNBZmFsc2UlMkMlMjJjb2xvciUyMiUzQSUyMiUyMzMzMyUyMiUyQyUyMnN0eWxlJTIyJTNBJTIyc29saWQlMjIlMkMlMjJ3aWR0aCUyMiUzQTElN0QlMkMlMjJzaXplJTIyJTNBJTdCJTdEJTdEJTdE

Aura inline button
summaryYouTube Tutorials
paramsJTdCJTIybGFiZWwlMjIlM0ElMjJZb3VUdWJlJTIwVHV0b3JpYWxzJTIyJTJDJTIyc2l6ZSUyMiUzQSUyMnNtYWxsJTIyJTJDJTIyc2hhcGUlMjIlM0ElMjJjaXJjdWxhciUyMiUyQyUyMnN0YXRlcyUyMiUzQSU3QiUyMmlkbGUlMjIlM0ElN0IlMjJjb2xvcnMlMjIlM0ElN0IlMjJiYWNrZ3JvdW5kJTIyJTNBJTIyJTIzZmYwMDAwJTIyJTdEJTdEJTJDJTIyaG92ZXIlMjIlM0ElN0IlMjJjb2xvcnMlMjIlM0ElN0IlMjJiYWNrZ3JvdW5kJTIyJTNBJTIyJTIzZmZmZmZmJTIyJTJDJTIybGFiZWwlMjIlM0ElMjIlMjNmZjAwMDAlMjIlMkMlMjJvdXRsaW5lJTIyJTNBJTIyJTIzZmYwMDAwJTIyJTdEJTdEJTdEJTJDJTIyaWNvbiUyMiUzQSU3QiUyMnBvc2l0aW9uJTIyJTNBJTIybGVmdCUyMiUyQyUyMmljb24lMjIlM0ElMjJmYS15b3V0dWJlJTIyJTdEJTJDJTIybGluayUyMiUzQSU3QiUyMnR5cGUlMjIlM0ElMjJsaW5rJTIyJTJDJTIydmFsdWUlMjIlM0ElMjJodHRwcyUzQSUyRiUyRnd3dy55b3V0dWJlLmNvbSUyRiU0ME9sZFN0cmVldFNvbHV0aW9ucyUyMiU3RCU3RA==
Aura inline button
summaryContact Support
paramsJTdCJTIybGFiZWwlMjIlM0ElMjJDb250YWN0JTIwU3VwcG9ydCUyMiUyQyUyMnNpemUlMjIlM0ElMjJzbWFsbCUyMiUyQyUyMnNoYXBlJTIyJTNBJTIyY2lyY3VsYXIlMjIlMkMlMjJzdGF0ZXMlMjIlM0ElN0IlMjJpZGxlJTIyJTNBJTdCJTIyY29sb3JzJTIyJTNBJTdCJTIyYmFja2dyb3VuZCUyMiUzQSUyMiUyMzI2ODRmZiUyMiUyQyUyMmxhYmVsJTIyJTNBJTIyJTIzZmZmZmZmJTIyJTdEJTdEJTJDJTIyaG92ZXIlMjIlM0ElN0IlMjJjb2xvcnMlMjIlM0ElN0IlMjJiYWNrZ3JvdW5kJTIyJTNBJTIyJTIzZmZmZmZmJTIyJTJDJTIyb3V0bGluZSUyMiUzQSUyMiUyMzI2ODRmZiUyMiUyQyUyMmxhYmVsJTIyJTNBJTIyJTIzMjY4NGZmJTIyJTdEJTdEJTdEJTJDJTIyaWNvbiUyMiUzQSU3QiUyMnBvc2l0aW9uJTIyJTNBJTIybGVmdCUyMiUyQyUyMmljb24lMjIlM0ElMjJmYS1xdWVzdGlvbiUyMiU3RCUyQyUyMmxpbmslMjIlM0ElN0IlMjJ0eXBlJTIyJTNBJTIybGluayUyMiUyQyUyMnZhbHVlJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZ0ZW1wby1pby5hdGxhc3NpYW4ubmV0JTJGc2VydmljZWRlc2slMkZjdXN0b21lciUyRnBvcnRhbCUyRjYlMkZncm91cCUyRjEwNjUlMkZjcmVhdGUlMkY0NSUyMiUyQyUyMnRhcmdldCUyMiUzQSUyMl9ibGFuayUyMiU3RCU3RA==
Aura inline button
summaryMarketplace Listing
paramsJTdCJTIybGFiZWwlMjIlM0ElMjJNYXJrZXRwbGFjZSUyMExpc3RpbmclMjIlMkMlMjJzaXplJTIyJTNBJTIyc21hbGwlMjIlMkMlMjJzaGFwZSUyMiUzQSUyMmNpcmN1bGFyJTIyJTJDJTIyc3RhdGVzJTIyJTNBJTdCJTIyaWRsZSUyMiUzQSU3QiUyMmNvbG9ycyUyMiUzQSU3QiUyMmJhY2tncm91bmQlMjIlM0ElMjIlMjM2NTU0YzAlMjIlMkMlMjJsYWJlbCUyMiUzQSUyMiUyM2ZmZmZmZiUyMiU3RCU3RCUyQyUyMmhvdmVyJTIyJTNBJTdCJTIyY29sb3JzJTIyJTNBJTdCJTIyYmFja2dyb3VuZCUyMiUzQSUyMiUyM2ZmZmZmZiUyMiUyQyUyMm91dGxpbmUlMjIlM0ElMjIlMjMyNjg0ZmYlMjIlMkMlMjJsYWJlbCUyMiUzQSUyMiUyMzI2ODRmZiUyMiU3RCU3RCU3RCUyQyUyMmxpbmslMjIlM0ElN0IlMjJ0eXBlJTIyJTNBJTIybGluayUyMiUyQyUyMnZhbHVlJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZtYXJrZXRwbGFjZS5hdGxhc3NpYW4uY29tJTJGYXBwcyUyRjEyMjA5MjUlMkZjdXN0b20tY2hhcnRzLWZvci1qaXJhLXJlcG9ydHMlM0Zob3N0aW5nJTNEY2xvdWQlMjZ1dG1fdGVybSUzRCUyNnV0bV9jYW1wYWlnbiUzREN1c3RvbSUyQkNoYXJ0cyUyQi0lMkJTZWFyY2glMkJBZHMlMjZ1dG1fc291cmNlJTNEYWR3b3JkcyUyNnV0bV9tZWRpdW0lM0RwcGMlMjZoc2FfYWNjJTNEMzQ1NzMyMzY5NiUyNmhzYV9jYW0lM0QyMDM4NzMxMjQ0JTI2aHNhX2dycCUzRDEyNzgwOTA0NjMxNSUyNmhzYV9hZCUzRDYwMTEzOTAxNTQxNCUyNmhzYV9zcmMlM0RnJTI2aHNhX3RndCUzRGF1ZC05MDA0NTY3ODc0MjAlM0Fkc2EtMTQxNzY3NjAzMjI5NSUyNmhzYV9rdyUzRCUyNmhzYV9tdCUzRCUyNmhzYV9uZXQlM0RhZHdvcmRzJTI2aHNhX3ZlciUzRDMlMjZnY2xpZCUzREVBSWFJUW9iQ2hNSXZ1cm9xY0dEX1FJVlZSUFVBUjA3ZmdRa0VBQVlBU0FBRWdMWkxmRF9Cd0UlMjIlN0QlMkMlMjJpY29uJTIyJTNBJTdCJTIycG9zaXRpb24lMjIlM0ElMjJsZWZ0JTIyJTJDJTIyaWNvbiUyMiUzQSUyMmZhLWNhcnQtYXJyb3ctZG93biUyMiU3RCU3RA==