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).
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.
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.
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.
NOTE: All profile settings are encrypted and stored in Zingy's cloud infrastructure.
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.
Please note that you need to re-publish your app for the connection to be available in the live version of your app.
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.
The following modifications are allowed on an existing connection:
Choose a different service profile
Modification of connection specific options (if the service offers that).
Please note that you need to re-publish your app for the modifications to take effect in the live version of your app.
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.
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.
The image below shows the process of editing the access rules.
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.
Please note that you need to re-publish your app for the access changes to take effect in the live version of your app.
Deleting a Connection
To delete a connection, click on it and select the Delete option from the popup-menu.
Please note that you need to re-publish your app for the connection to be removed in the live version of your app.
Last updated