Webhooks
Create a Webhook
To create a new Webhook:
Click Webhooks in the left pane and click New Webhook.
Fill in the following details:
Type: Select Standalone (the only supported type for Circuit).
Name: Enter a name for the webhook.
URL: Specify the API URL of a third-party or Zoho application.
Method: Select the API method type (POST/GET). The default is POST.
Preview: Review the complete webhook URL to be sent to the third-party application (not editable).
Append Custom Parameters:
Specify the parameter name and its corresponding value for the webhook.
This key/value pair is mainly used to send authentication tokens, API keys, security tokens, etc.
Custom Headers:
Specify the header name and the corresponding value for the webhook.
This can be used to send cookies, User-Agent, Referrer, and so on.
Click Save.
Once created, the webhook will appear under the Associated Components in the Webhooks section.
Refer to Qntrl's Webhook help page for detailed configuration instructions.
While importing Circuit template, only the associated webhooks will get imported.
Edit a Webhook
To edit a Webhook:
Click on the Webhooks section in the left pane.
From the list, click the name of the webhook to be edited.
Make modifications and click Save.
Delete a Webhook
To delete a Webhook:
Click the Webhooks section in the left pane.
Hover over the webhook name, click the action menu, and select Delete.
In the prompt window, confirm your delete action.
Functions
Create a Function
Create a new Function:
Write Function Script:
Test and Deploy Function:
Functions must be deployed before use in Circuits.
While importing a Circuit template, only the associated functions will be imported.
Manage Existing Functions
Click on Functions in the left pane.
Hover over the function name and click on the action menu.
Choose from the following options:
Edit: Modify the function code and redeploy. Only the deployed version will be executed in Circuit.
Preview: View the function script without making changes.
Delete: Remove the function.
Connections
Connections enable integrations with Qntrl and external services. You can create connections to both pre-configured and custom services.
Create a Connection
Navigate to the Connections section in the left pane.
Click the Create Connection button.
Pick Your Service:
Default Service: Select a service from the frequently used services provided.
Custom Service: Create your own service by selecting the custom service option.
For more details about connections in Qntrl, click here.
Connect with a default service:
Choose a pre-configured service from the list of frequently used options.
Under the Default Services tab, choose a third-party or internal Zoho service.
In the next section, provide the required service details and click Create and Connect.
You will be redirected to the service page to authenticate the connection.
Once authentication is successful, the service will be ready to use.
Connect with a Custom Service:
In addition to the pre-configured services we provide, users can connect with other third-party services by creating a custom connection.
Navigate to the Custom Service tab and click Create Service.
Enter the necessary connection and authentication details to set up a new service.
Click Create Service.
Once authentication is successful, the service will be ready to use.
For more detailed information on connecting with custom services, click here.
Edit / Delete a Connection
You can edit or delete existing connections by hovering over the desired connection.
To Edit: Click the edit icon, make necessary changes, and then click Update.
To Delete: Click the delete icon and confirm your action to remove the connection.
Revoke a connection
To discontinue an integration, you can revoke the associated connection.
In the left pane, click My Connections.
Hover over the connection you wish to revoke.
Select the Revoke option.
Revoking a connection removes authorization but doesn't delete the connection record the service will still be listed on the Connections page. You can re-establish the connection at any time.
Tables
Create a Table
Navigate to the Tables section in the left pane and click Create Table.
Define Table Structure:
Table Name: Enter a name that describes the table.
Description: Add a brief explanation of the table's purpose.
Columns:
Column Name: Enter the name of the column.
Field Type: Select the field type from the drop-down menu. Supported field types include: single line text, multi-line text, date and time, decimal, number, email address, and link.
Add or Remove Columns: Click the + or - icon next to the column to add or remove it.
Column Settings: Click the settings icon and configure column settings (mandatory, default value, minimum/maximum values).
Click Save to create the table. Once created, you can manually enter data or import it into the table.
For more details on creating and managing tables, visit the Tables help page.
Edit/Delete a Table
You can modify or remove existing tables:
Schedules
Create a Schedule
Navigate to the Schedules section in the left pane and then click the New Schedule button.
Define Schedule Details:
Name: Provide a relevant name for the schedule.
Frequency: Choose how often the schedule should run (e.g., Weekly).
Execute On: Specify the day of the week when the function should be executed.
Start Date and Time: Set the initial start date and time for the schedule execution.
Expiry: Select the condition after which the schedule should expire.
Set Execution Limit: Determine the number of times the schedule should run before expiring.
Set Expiry Date: Select the specific date after which the schedule will expire.
Never: Allow the schedule to run indefinitely.
Callback Type: Choose whether the schedule should trigger a Function or a Circuit.
Once selected, a dropdown will display the available functions or circuits. Select the appropriate one from the list.
Click Save to create the schedule.
For more detailed information on schedules and configuring them with multiple frequencies, visit the Schedules help page.
Managing Schedules
In your Studio portal, select Circuit in the left pane and select the desired template. Click Schedules in the left pane.
Edit: Select the desired parameter from the list in the left pane, make the necessary modifications, and click Save.
Delete: Hover over the name of the schedule, click the delete icon, and confirm your delete action in the prompt window.
Navigate to the Group section in the left pane and click New Group.
Fill in the Group Details:
Group Name: Provide a descriptive name for the group.
Description: Provide a brief explanation of the group's purpose.
Click Save.
Manage Existing Groups
Click on Group in the left pane.
Hover over the group name and click on the action menu.
Choose from the following options:
Edit: Edit the group name and description and click Save.
Delete: Remove the group by selecting Delete.
ConfigStore
Adding a Parameter in ConfigStore
Navigate to the ConfigStore in the left pane and click Add Parameter.
Fill in the Parameter Details:
Parameter Name: Assign a unique name to the parameter.
Value: Enter the parameter value for testing purposes. This value will not be exported.
Default Value: Specify a default value to prevent failures. Note that only the default value will be exported to a customer org.
Type: Choose how to store the parameter value in the database
Default String - String Values will be stored as plain text.
Encrypted String - String values will be stored encrypted.
Click Save to store the new parameter.
Once created, the created parameters will get listed in the left pane:
All: All the parameters will get listed
Grouped: Parameters will be listed category-wise.
Associating Parameters
Use the format ${parameter's_link_name} to associate the created parameter within Circuit.
Managing Parameters
Edit a Parameter
- Click the ConfigStore in the left pane.
Select the desired parameter from the list in the left pane.
Make the necessary modifications
click Save.
Delete a Parameter
- Click the ConfigStore in the left pane.
- Hover over the name of the parameter.
Click the delete icon next to the parameter name
Confirm your delete action in the prompt window.
Bridge
Create a Bridge
To create a new bridge:
Click Bridge in the left pane of your circuit template and click New Bridge.
Fill in the bridge details:
Name: Provide a unique name for the bridge.
Modules: Select one of the modules from the drop-down list. The task related to the selected module alone will be executed through this message. Task Engine and DB Engine modules will be associated by default while creating a bridge.
Task Engine - To execute API tasks in third-party or internally hosted app
DB Engine - To perform SQL queries in a database hosted in a closed network
SSH Engine - To connect a remote Linux/Unix machine and to execute required commands
PowerShell Engine - To connect a remote Windows machine and to execute required commands
File Management - To transfer files from one location to another
AD Engine - Connects and performs secured operations in Active Directory
Description: Give a detailed description of the bridge purpose.
Click Save.
Refer to Qntrl's Bridge help page for detailed configuration instructions.
If the Bridge is not associating during connector or credential creation, ensure the relevant modules configured in the component are selected.
The created Bridge cannot be exported and is intended solely for template creation purposes.
After installing the template, a new or existing Bridge must be manually associated.
Edit a Bridge
To edit a bridge:
Click on the Bridge section in the left pane.
From the list, click the name of the bridge to be edited.
Make modifications and click Save.
Delete a Bridge
To delete a bridge:
Click the Bridge section in the left pane.
Hover over the bridge name, click the action menu, and select Delete.
In the prompt window, confirm your delete action.
Scripts
Create a Script
Navigate to the Scripts section in the left panel of your circuit template and and click New Script.
Fill in the new script details:
Name: Give a name with a file extension to identify the script (e.g.: display.sh/display.ps1).
Description: Provide a description that serves for later reference.
Script Type: Choose the type of script.
Shell Script - For UNIX OS
PowerShell Script - For Windows OS
Script File: If the script is available in a local file, you may attach it in this field, and it will be executed in the message.
Content: Alternatively, the commands that need to be executed can be given directly in this field.
Click Save. A new script will be created.
For more details on creating and managing tables, visit the Scripts help page.
Edit a Script
To edit an existing script:
In your circuit template, navigate to the Scripts section in the left pane.
Click on the script name you want to edit.
Make the required modifications and click Save.
Delete a script
To remove a script:
In your Circuit template, navigate to the Scripts section in the left pane.
Hover over the name of the script you want to delete, click the action menu, , and click Delete.
Confirm the delete action.
Connectors
Create a Connector
To create a new connector:
Click Connectors in the left pane and click New Connector.
Fill in the new connector details:
Name: Provide a unique name for the connector.
Type: Select the Type of connection. Currently Qntrl supports only JDBC.
Credential: Select the credential name that has the credentials to connect to the intended database.
SQL Type: Select the type of your SQL database
SQL Server
MySQL
PostgreSQL
Oracle
Connection Timeout: Specify the maximum timeout limit beyond which the connection will expire.
Query Timeout: Specify the maximum timeout limit beyond which the query execution will be suspended.
Host Name: Enter the hostname in which the DB is hosted.
Port: Enter the port number in which the DB runs.
Database Name: Enter the database name to be connected.
Instance: This field appears if the SQL Type is SQL Server. Enter the DB instance name.
Click Save.
Refer to Qntrl's Connectors help page for detailed configuration instructions.
Edit a Connector
To edit a connector:
Click on the Connectors section in the left pane.
From the list, click the name of the connector to be edited.
Make modifications and click Save.
Delete a Connector
To delete a connector:
Click the Connectors section in the left pane.
Hover over the connector name, click the action menu, and select Delete.
In the prompt window, confirm your delete action.
Credentials
Create a Credential
To create a new credential:
Click Credentials in the left pane and click New Credential.
Fill in the new credential details:
Name: Provide a unique name to identify the credential.
Type: Choose the type of credential.
API Key - If the Credential type is an API key, mention the API token.
JDBC - For the JDBC Credential type, the username and password need to be provided.
OAuth 2.0 - If the Credential type is OAuth 2.0, select the existing DRE connections.
SSH - Provide the username and password of the machine where the Shell script has to be executed.
Powershell - Provide the username and password of the machine where the Powershell script will be executed.
Active Directory - Specify the User DN and Password of the Active Directory.
Use Credentials from Bridge: Select this if you have previously saved credentials in a bridge.
Click Save.
Refer to Qntrl's Credentials help page for detailed configuration instructions.
For security reasons, certain properties, such as usernames, tokens, and passwords, cannot be exported. These sensitive fields must be reconfigured manually in the target environment after the component is imported.
Edit a Credential
To edit a credential:
Click on the Credentials section in the left pane.
From the list, click the name of the credential to be edited.
Make modifications and click Save.
Delete a Credential
To delete a credential:
Click the Credentials section in the left pane.
Hover over the credential name, click the action menu, and select Delete.
In the prompt window, confirm your delete action.