Configuring an External Data Source

TABLE OF CONTENTS

• Example Data Source configuration
• Adding a Data Set for an External Data Source 

If your App needs to call out to external systems to retrieve or send data, then you have to configure an External Data Source., so that your App is able to send requests to its API.  Because CafeX manages the external APIs for you, you do not have to write code to authenticate, maintain, and establish the connection. Your App needs a Data Set to interact with the External Data Source.  This article describes both of these features.

The External Data Source allows you to configure several aspects of a RESTful API.  Before you configure an External Data Source, you have to be familiar with RESTful services.

To create a new External Data Source:

1. Go to Configure > External data sources.
2. Select any of the External Data Sources.
3. Click Edit data source ().
4. Under Configuration, is a JSON definition for the endpoint that your App uses to access the API.
5. Schema, there is a JSON definition of information your App uses.

When you configure an External Data Source, you can use Extract Schema to have CafeX call the endpoint and parse the data object.   The response schema provides the App Studio with a definition of response objects that your App references.

Example Data Source configuration

The following API definition provides you with information about a domain name registrations

Example Response:

{			
    "domains": [{		
        "domain": "cafex.com",		
        "create_date": "2023-08-27T09:01:38.517344",
        "update_date": "2023-08-27T09:01:38.517347",		
        "country": "US",	
        "isDead": "False",	
        "A": ["54.173.157.104"],
        "NS": ["ns-1284.awsdns-32.org", "ns-1733.awsdns-24.co.uk", "ns-433.awsdns-54.com", "ns-634.awsdns-15.net"],	
        "CNAME": null,	
        "MX": [{	
            "exchange": "aspmx.l.google.com",	
            "priority": 10		
        }],		
        "TXT": ["status-page-domain-verification=04x69wwf5683"]		
    }],	
    "total": 1,	
    "time": "1210",
    "next_page": null		
}

The following Configuration is all that this Data Source requires.

Data Source configuration can include the following attributes:

As this is a GET request, use Extract Schema to test the endpoint and automatically generate the schema for your App to use:

Adding a Data Set for an External Data Source 

To perform operations on an External Data Source, you have to collect parameters and use them to evaluate a Data Set in your App. The Data Set provide your Apps with a consistent way to interact with data. 

For a guide that uses Components, Data Sets, and External Data Sources, see: Enhancing your App

To add a Data Set to search on:

1. In App Studio, go to Explorer > App.
2. On the Appearance and Configuration panel, click Configuration.
3. Click Add Data set.
4. Complete the form and select the appropriate Data Source. 
5. Click Add

Your Components in your App can make use of the Data Set.

If your Data Set requires inputs, because your Data Source has URL parameters, you have to associate a new Form Component with the Data Set before you set the field on the original Data Set.