Read Custom Data Sources

The list of all custom data sources can be requested.

This is required when opening forms to engage with server-side ReST API requests.

Read App Studio Custom Data Sources

POST AppStudio/ReadCustomDataSources

This is a POST method which passes both the API and session keys as headers, and a body. If successful, the custom data sources can be stored.

Headers

Name
Value

Content-Type

application/json

SiteKey

API Key

DataServicesKey

Session Key

Body

Name
Type
Description

TreeFormat

Boolean

true

Response

{
  "Success": true,
  "JSON": "base64 encoded string"
}

Base64 JSON Decoding

The JSON data is Base64 encoded. You must decode this into a JSON string and convert that into a multi-hierarchical object.

This example shows the custom variables in the App Studio configurator on the left and a matching portion of the multi-hierarchical object returned from the API.

Here is an example of a partial list of all data sources. The full list can be very large so it is not supplied here.

[
  {
    "text": "RestDb.io",
    "imageUrl": "images/trisys/app-studio/database.png?ts=202410081400",
    "items": [
      {
        "text": "Football",
        "imageUrl": "images/trisys/app-studio/folder.png?ts=202410081401",
        "items": [
          {
            "text": "Nationality",
            "imageUrl": "images/trisys/app-studio/folder.png?ts=202410081401",
            "items": [
              {
                "text": "Create Nationality",
                "imageUrl": "images/trisys/app-studio/post-30x30.png?ts=202410092000",
                "items": [],
                "request": {
                  "RequestId": "51748268-d6e4-c288-bc38-bc772a43f281",
                  "Name": "Create Nationality",
                  "Description": "Request added by Josie Musto Wed 07 May 2025",
                  "Verb": "POST",
                  "Url": "https://football-891b.restdb.io/views/CreateNationality",
                  "Authorisation": {
                    "Grid": [],
                    "Type": "Inherit from parent"
                  },
                  "Parameters": [],
                  "Headers": [],
                  "Body": {
                    "Format": "JSON",
                    "Grid": [],
                    "Json": "{\r\n  \"Name\": \"<#NationalityName#>\",\r\n  \"Country\": \"<#Country#>\",\r\n  \"FlagURL\": \"<#Nationality-Flag#>\"\r\n}"
                  },
                  "ParameterFormat": "Args",
                  "Fields": [
                    {
                      "Field": "_id",
                      "Type": "String",
                      "Values": "1 values: 681b90a278badf65000b3941",
                      "Visible": true,
                      "Caption": "_id",
                      "Key": true,
                      "KeyVariable": "Nationality-ID"
                    },
                    {
                      "Field": "Country",
                      "Type": "String",
                      "Values": "1 values: Foo Kinhel",
                      "Visible": true,
                      "Caption": "Country"
                    },
                    {
                      "Field": "Flag",
                      "Type": "Image ID",
                      "Values": "1 values: 681b90a178badf65000b3940",
                      "Visible": true,
                      "Caption": "Flag"
                    },
                    {
                      "Field": "message",
                      "Type": "String",
                      "Values": "1 values: Nationality created successfully",
                      "Visible": true,
                      "Caption": "message"
                    },
                    {
                      "Field": "Name",
                      "Type": "String",
                      "Values": "1 values: AA Which nation player represents",
                      "Visible": true,
                      "Caption": "Name"
                    },
                    {
                      "Field": "nationality",
                      "Type": "String",
                      "Values": "1 values: {\"_id\":\"681b90a278badf65000b3941\",\"Country\":\"Foo Kinhel\",\"Flag\":[\"681b90a178badf65000b3940\"],\"Name\":\"AA Which nation p...",
                      "Visible": true,
                      "Caption": "Nationality"
                    },
                    {
                      "Field": "success",
                      "Type": "Boolean",
                      "Values": "1 values: true",
                      "Visible": true,
                      "Caption": "success"
                    }
                  ]
                },
                "attr": {
                  "RequestId": "51748268-d6e4-c288-bc38-bc772a43f281"
                }
              },
              {
                "text": "Read a Nationality",
                "imageUrl": "images/trisys/app-studio/get-30x30.png?ts=202410092000",
                "items": [],
                "request": {
                  "RequestId": "2cd08f6d-6472-f1f2-d84f-b3218f057066",
                  "Name": "Read a Nationality",
                  "Description": "Request added by Josie Musto on Sunday 01 December 2024",
                  "Verb": "GET",
                  "Url": "https://restdb.trisys.co.uk/ReadNationality?ID=<#Nationality-ID#>",
                  "Authorisation": {
                    "Grid": [],
                    "Type": "Inherit from parent"
                  },
                  "Parameters": [],
                  "Headers": [],
                  "Body": {
                    "Format": "JSON",
                    "Grid": [],
                    "Json": "{}"
                  },
                  "ParameterFormat": "Args",
                  "Fields": [
                    {
                      "Field": "ID",
                      "Type": "String",
                      "Values": "1 values: 67f8e87578badf6500052231",
                      "Visible": true,
                      "Caption": "ID",
                      "Key": true,
                      "KeyVariable": "Nationality-ID"
                    },
                    {
                      "Field": "Nationality",
                      "Type": "String",
                      "Values": "1 values: German",
                      "Visible": true,
                      "Caption": "Nationality"
                    },
                    {
                      "Field": "Country",
                      "Type": "String",
                      "Values": "1 values: Germany",
                      "Visible": true,
                      "Caption": "Country"
                    },
                    {
                      "Field": "FlagUrl",
                      "Type": "Image URL",
                      "Values": "1 values: https://football-891b.restdb.io/media/67f8e87478badf6500052230",
                      "Visible": true,
                      "Caption": "Flag Url"
                    },
                    {
                      "Field": "Flag",
                      "Type": "Image ID",
                      "Values": "1 values: [\"67f8e87478badf6500052230\"]",
                      "Visible": true,
                      "Caption": "Flag"
                    }
                  ]
                },
                "attr": {
                  "RequestId": "2cd08f6d-6472-f1f2-d84f-b3218f057066"
                }
              },
              ....

Last updated