All operation for data sources management is performed by administrators on a portal.
You can read more about how to use data source in add-in.
Data Source Structure #
Data Source has 3 parts:
- Input from end user – represented as input variables
- Request preparation and sending to external system – defined by external system url and parameters binding from user input
- Processing response and sending data to end user – represented by parameters binding to output variables that are returned to end user
Passing user input to external system request is done by simple variables substitution, using ${} to separate variables. For parsing JSON response from external system, JMESPATH is used.
How to create Data Source #
Example is based on countries api, available at https://restcountries.com/
1. Define external system url and request structure
2. Map user input: Create input variable for each url param
3. Map external system response to output variables
Create other output variables:
Data Source Testing #
Administrator can test integration on the same page.
There are four tabs that represent:
- Which input end user sees:
- How HTTP request look like:
- How HTTP response look like:
- Which output end user will see:
So it’s not just defining of the integration, but it’s possible to completely test it.
Next, you can use this data source in your templates. Read more about how to use data source in add-in.
