Welcome, Guest Login

Support Center

Remote Query Block: REST calls

Last Updated: May 01, 2017 03:49PM EDT

Make RESTful Calls 


Introduction
This Tutorial illustrate how to make REST calls using EachScape Remote Query Block
To use Parameter in a Live Feed review the Tutorial Using Parameter in a Live Feed

First we will describe the Block then illustrate its usage 

In this Tutorial we show to build a simple username / password verification: The app calls a server which validate the user credential.
Examples of Remote Query Blocks are available through Tutorial Apps
Write into a Cloud Collection
Update Cloud Collection
Save Photos into a Cloud Collection


Remote Query Block

Configuration
Remote Query Block uses base URL which is the address of your endpoint.

It supports the following Parameters:
  • Add as many text fields as needed
  • One image
  • and/or one video per RESTful call

Choose the HTTP method (POST, GET, PUT, DELETE) used for the request, and store fields from the response in one or more variables that you have defined.

The Block will trigger a different Event (Success, Failure, No Response) depending on the response from the remote server.

The request (query) will be sent by the Remote Query Block as soon as the Block is visible on the screen.


In this screenshot, the URL is the API for EachScape Cloud Collection
 
Note
The Remote Query will automatically appends the parameters.
You do not need to add the '?' and other '&' in the string.

Important
The Remote Query response handler will NOT PARSE data sources.
To use parameters in a data source call, you need to enter these parameters as query parameters in the data source construct, please review the Tutorial:  
 
Tip
It's convenient to put the Block as the only block on its own layer. The layer containing the remote query block is added using the Add Layer Action when the event occurs that you want to trigger the remote query. The layer is removed when the request is completed using the Remove A Layer action on the Success/Failure/No Response events.


Text Parameters
You can add up to 24 Text parameters Fields to your call.
You will need to define:
  • The Name of the Parameter
  • The Value of the Parameter

Here the Parameter name is 'MaxAge' and the Value is 88.
In most cases, the value will be a variable, not a numeral like this example.

Image Parameter 
You can pass one image per call.
You MUST store the Image in a Custom Image Block.
Select that Image Block in the pull down menu for 'Image Block'.

The Image Name is the equivalent of the 'Name' for our Text Parameter, it's the name of the parameter i.e. the Key. 

Image Filename is the name of the image file on the receiving server. It's important meta data.
The End point doesn't have reference to the Image Block used in the app, the Image Filename will help link the two together.

 

Video Parameter
You can pass one video per call.
Enter the URL of the video passed at a parameter
 
 

Response Variable
You can define up to 24 Response Variable per REST call.
These EachScape variable will store the response from the Web Service.
The application will be able to use these variables internally.

We will shortly provide an example of WordPress Authentication to illustrate Response Variables.
If you need it sooner, please email us
 
Response Events 
The Remote Query Block has 3, mutually exclusive, outcome Events
  • Success
  • Failure
  • No Response

As usual, associate any EachScape Action to these Event to address the different possible outcome.
These are shown in the different app Tutorials:

Learn More
- Parametrized Datasource Calls


 

Help us improve! Rate this article:

Yes I found this article helpful

Ask a Question   

support@eachscape.com
http://assets1.desk.com/
false
eachscape
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete