Connections

Connection defines between which connectors do we want to do requests, what kind of requests and specify mapping between them. This is a core element of the application. The list of connections displays only a title.

On the right top corner you can see or icon. Clicking on it the application creates a webhook for the specific connection.

Due to it the user can trigger this connection using only url. To get this url, just click on the word WEBHOOK. The url is stored in the buffer. Now you can paste it where you need.

Adding/updating connection consist of three steps: direction, mode, and methods. There is an explanation tour for creating connection. The direction page has two fields: title and connectors.They are both required. The title must be unique, it is checking before going to the next page. The connectors are two: from connector and to connector.

The mode step has one required field - mode. It can be expert or template. If template is chosen, their will be appeared a select field, where you can select a template that you need or delete it.

if you come back to this step from the next step, choosing another mode will affect on the adding, that is why you need to confirm your choice.

The methods step has two areas: methods and mapping fields. There is also a possibility to add this connection to the templates. Clicking on the Add Template button appears a window where should be provided a name.

The methods area is divided into two parts: left and right. On the left side you see elements belongs to from connector and on the right to to connector. There are two types of elements: method and operation.

Method represents the request to the connector with defined parameters. Each method has his own color that generates automatically. Parameter can be a simple text, a pointer or an object. The pointer is value that refers to the result of the method above. To be able to make a pointer, just type $ sign in input field. To go back to a simple text field, remove this $ sign. The pointer is a field with three data: pointer sign $, method value and param value. Method value is a select box which values generates from created methods above. Selecting it, the corresponded color appears in the pointer.

The param value is a simple text. Clicking on it, you will see the popup input field wider.

The object field is for json data. They can be typed by hand or imported.

If you want to import, just click on the Import button and insert data into textarea.

All parameters can be hidden pressing on the title of the method or on the arrow. Clicking on this icon you can delete a method.

Operation can be loop - or if - . Loop has two parameters: method and param. Method is a select field. Values come from the selected methods with according colors. Param is a text field. Loop operation goes through the array. It means, the param value should be an array with [] in the end.

The if operation checks if the statement is true then fulfill the instructions inside. It has three parameters: method, param, relational operator, and compare statement. The relational operator can be >=, >, <=, <, ==, !=.

Values for Method for To Connector come not only from selected methods in To Connector, but also from From Connector.

To add a new method or operation, click on this button. There will be a menu. M means method and O means operation. Click one of it and select item. If you are inside operation than you can create in or out of the instructions.

The mapping area display the mapping between the From and To Connectors through the parameters. First of all you add a new From Connector parameter. You can do it it two ways: typing the name in Type Param field or clicking on icon. In Type Param fields appearing values as you type in. If you type a dot . after, it shows you a list of subparameters inside the property.

Clicking on you add it.

Clicking on plus icon comes a dialog box with two parameters: field type and name.

After creating a param, you can choose this param in To Connector method items clicking on the multiselect field.

Immediately after there is a new connection between chosen parameter and param where it was selected.

Each rectangle on the right side has an Enhancement. The goal of it to provide some functionality during the mapping. Clicking it opens a dialog box with next data: name, description, mode (simple or expert) and code. Simple mode provide more data: variables, constants and operators.Clicking twice on the element it appears in the code. Though, you can write very simple code expresion.

Expert mode has just a textarea where are comments in the beginning. These comments explains you what variables are assigned to which params. Use it in the code.