Connections

In Zingy, Connections serve as bridges for your app to communicate with external entities like third-party applications, proprietary databases, and various other services.

Your app's connections can be managed through the Connections tab as shown below (use the Toolbox menu and choose the Connections option).

Zingy App Editor - Connections tab

Adding a Connection

Use the βž•Add Connection icon to create a new connection for your app.

Select the Service

The first step in creating a connection is to select the specific service you want to communicate with. Click here for a list of supported services.

New Connection: Service selection

Select the Service Profile

A service can have one or more profiles. Each profile contains settings that distinctly recognize your account with that service. Additionally, the profile may have configuration options related to the service.

As part of the step 2, select an existing profile or select -New Profile- to create one.

New Connection: Service Profile selection

When setting up a new service profile, the configuration options vary depending on the service. Please refer to the documentation section of the specific service to learn more.

You may also delete a service profile by selecting it and clicking on βž–icon that appears next to the selection dropdown.

Configure connection specific options

You will be taken to step 3, if the service offers connection specific configuration options. Please refer to the documentation section of the specific service to learn more.


Using the Connection

Operation/Commands

A service may offer one or more operations/commands. When invoked or triggered, these commands carry out specific tasks related to the service.

e.g. The Stripe payments service, provides the Initiate Payments command that sets up the ability to accept payments inside your app.

Please refer to the documentation section of the specific service to learn about the operation commands they offer.

Page Flow and Cloud Flow

The Execute Connection Command and Execute API Call blocks are available in both Page Flow and Cloud Flow. Using these blocks you can add logic to trigger the operations/commands supported by a service.

Widget Elements

For some services, there are widget elements in the Page Element Library that can be added to pages and forms.


Editing a Connection

To modify a connection, click on it and select the Edit option from the popup-menu.

Connection: Edit option

The following modifications are allowed on an existing connection:

  • Choose a different service profile

  • Modification of connection specific options (if the service offers that).


Access (Security)

Similar to the access rules for pages and databases, you can define role based access to your app's connections for every operation/command offered by the service.

Click on the connection and choose the Access (Security) option from the popup-menu.

Connection: Access (Security) option

By default all registered Users of the app and members of the Admin group are allowed to invoke all available operations/commands for the connection's service. You can change this by clicking on the Edit button (highlighted below) for the desired operation/command.

Connection: Access rules edit button

The image below shows the process of editing the access rules.

Access Rules modification showing group selection (1), role selection (2), group add button (3) and the group delete icon (4).
  • To allow a group, select it (1), choose the minimum role level (2) and click on the Add button (3).

  • To grant public access to an operation, select the "Public" group.

  • To remove a group click on the 'x' icon (4). Note: The "Admin" group cannot be removed.


Deleting a Connection

To delete a connection, click on it and select the Delete option from the popup-menu.

Connection: Delete option

Last updated