A data source defines the connection to data you want to fetch. One data source can be used in multiple field configurations. The use of variables helps you to keep your data source as flexible as possible.

The app allows you to connect to:

URL/REST
OAuth 2
Database
Salesforce
Local Jira
File
Merge Data Sources
Paginated Data Source
Converter

Variables

Variables are the key to making your data source more flexible and versatile. You can use specifically defined variables as placeholders which can be used in field configurations later on.

A variable is defined with surrounding curly brackets:{}

Example:

https://myapi.com?query={var1}
CODE

Variables can be used in fields like:

  • URL - URL/REST, Salesforce, Local Jira

  • Post Body - URL/REST, Local Jira

  • SQL Query - database

Examples of how to use variables in an issue context can be found in the Context Filter section.

Test Connection

After creating a data source you can check if the connection has successfully been established by clicking on Test connection. a test dialog appears. This should open a test dialog window, where you can fill in some sample data for your previously defined variables and start the test. The results with a response by the URL should be displayed immediately.

Note: shortened raw result from XXX to XXX only aaffects the displayed results in the simulation as a way to reduce traffic. Your original date source is not beeing affected nor shortened by this procedure.

Add IP’s to Allowlist

In case you need to allow an IP to let external data access your infrastructure, please add the following IP addresses to your allowlist:

Global / US:

  • 23.20.133.116

  • 3.223.177.5

Global / EU:

  • 18.194.7.117

  • 3.124.29.165

Please visit our Data Residency section to find out your region.