Circuit Management and Quick Actions Guide | Online Help | Qntrl | Circuit

Manage Circuits and States

Dashboard

The Dashboard provides a centralized view to monitor and track all Circuit executions across the system. It offers a consolidated snapshot of all workflow executions and their current statuses.

To access the dashboard,

  • Navigate to Circuits in the left pane and click Dashboard.

  • This displays the following key metrics.

    • Total Executions: Total number of overall Circuit executions.

    • Success: Count of executions completed successfully.

    • Failure: Count of executions that resulted in errors.

    • Running: Number of executions currently in progress.

    • Daily Executions: A graphical view showing successful and failed executions for the current month.

    • Circuit Usage: A pie chart representing the top 5 most executed circuits.

    • Recent Executions: Displays the recent 10 executions.

      • Use filters (Total, Success, Failure, Running) to view the last 10 executions for the selected metric.

      • Click an execution name to view detailed information.

Versions       

Every time you make changes to a circuit and publish them, a new version is automatically created with changes saved. The newly published version becomes the active version and is used in all associated modules, integrations, and nested circuit states—such as circuits, boards, business rules, and external APIs.
To view and manage all versions of a circuit:

  1. Click the versions icon located at the top right of the circuit page. This will display a list of all versions created for that Circuit. 

  1. Each version includes the following details:

    • Version Name: Auto-generated name for the version.

    • Created On: Date and time when the version was published.

    • Created By: The user who published the version.

    • Actions: You can perform the following actions on each version:

      • View: Preview the version in both code and builder view (read-only).

      • Delete: Permanently delete a version (only if it's not the active published version).

    • Publish Version: By enabling this option, you can re-publish any version from this list to make it the current active version.

Notes

  • You cannot manually disable a published version. When you publish a new version, the previously published version is automatically disabled.

  • You cannot delete the currently published (active) version.

  • Publishing is allowed only when changes are made to the circuit.

  • Once a version is published, its version details are visible in the Execution Details section when the circuit is executed.

  • Version with execution history cannot be deleted.

 

Nested Circuit Execution  

When a circuit is triggered within a parent circuit, its execution details will include:

  • The execution ID of the parent circuit.

  • The version of the nested (child) circuit that was executed, provided the nested circuit has a published version.

Info
When a nested circuit runs, its published version is executed and shown.


Quick Actions in Circuit   

To manage and organize circuits in your account:

  1. Navigate to the Circuits list view page.

  2. Hover near the name of the circuit.

  3. Click on the action menu next to the name. From the action menu, you can:

    • Edit Circuit – Change the name and description of the circuit. In the pop-up, make modifications and click Update.

    • Builder View – Open the Circuit Builder to view or modify the workflow.

    • Preview – View the circuit’s visual workflow and corresponding code in a single screen.

    • Input Schema – Configure schema validation for circuit input. See Configuring Schema Properties in UI for step-by-step instructions.

    • Clone – Create a copy of the circuit. Only the configuration is cloned; associated components are reused.

    • Delete – Remove the circuit from your account.  



Filter Executions

Filter executions by status (Success, Failure, Running, Aborted). Click the filter icon next to the status and select your desired option. Only the chosen status will be displayed in the list.



Tab Switch Actions for Circuit Modules   

In the top-right corner of the Cirucit page, you'll find icons for the following actions:
  • Circuit Builder View - 

  • Execution List of Circuit - 

  • Dashboard View of Circuit Executions - 



Dashboard (Circuit specific)

The Dashboard displays the executions and their status for the Circuit. Clicking on the Dashboard icon    displays key execution metrics, including:

  • Total Executions: The overall count of all executions of the selected circuit.

  • Success: The number of processes that completed successfully.

  • Failure: The count of processes that encountered errors.

  • Running: The processes currently in execution.


Interactive Status Filtering

Each status (e.g., success, failure) is interactive. By clicking on any status, the system navigates to the Execution Logs page, displaying a filtered list of executions with the selected status.

Recent Executions

The Recent Executions section lists the ten most recent executions. Users can filter executions based on their status through a dropdown menu, displaying the top ten executions for the selected status. Clicking on an execution name takes the user to the corresponding log page for detailed execution information.

Builder View Quick actions 

Builder Tools 

On the right side of the visual workflow, you can use the following icons:

 -  Automatically arrange states within the flow diagram.

  -  Switch the view to horizontal.

 -  Validate the graph to identify errors.

 -  Reset changes and revert to previously saved edits.



 

Access the Circuit in Builder and Code View by selecting the icons at the top-right corner of the Builder view page.

 

 

To adjust the circuit size, click on the zoom in or zoom out icons located at the bottom-left corner of the Builder view.

 



Quick action in States   

To add or manage states within a circuit:

  1. Drag and drop states from the right pane onto the workflow.

  2. In Builder View, access the state action menu by clicking the action menu within a state or right-clicking on a state.

  3. From the state action menu, you can perform the following actions:

    • New State – Create a new state.

    • Duplicate State – Create a copy of the selected state with the same configuration.

    • Delete – Remove the state.

    • Input Schema – Define input JSON schema validation for the state. See Configuring Schema Properties in UI for step-by-step instructions.

    • Result Schema – Configure output validation for the state. See Configuring Schema Properties in UI for step-by-step instructions.

    • Skip Execution – Bypass the state during execution.

    • Mock Output – Provide a mock response instead of executing the state when a state execution is skipped.

For detailed schema configuration steps, refer to the Schema-Driven Data Validation and Protection.

       


Code View Tools 

The toolbar in the code editor provides the following options:
  1. Font size adjustment
  2. Undo and Redo actions
  3. Copy
  4. Clear option to erase code
  5. Find and Replace text
  6. Reset option to revert to previous changes
  7. Beautify code
  8. Keybindings settings
If you have fifty states in a circuit and wish to view the code of a specific state without scrolling, simply click on the corresponding state in the builder view to access its configuration.

 



    • Related Articles

    • Execution Logs

      A record of all tested executions is maintained in Circuit, allowing you to access and re-run specific executions anytime. Follow these steps to access the execution history of a circuit: Access Execution History Go to the left pane and click on the ...

    • Introduction to States of Circuit

      States are the building blocks of a circuit that can perform tasks, make decisions, or simply pass the output from one state to another. The state defines a specific task or process that has to be executed in that segment of the circuit. Circuit ...

    • Create and Configure a Circuit

      Circuits are visual workflows that help automate tasks across various modules in Qntrl. You can create circuits by using pre-built templates or by building them from scratch using Builder View or Code View. Common Circuit Functionalities Maximum of ...

    • Quick onboarding guide

      Introduction to Qntrl Qntrl is workflow automation software that helps organizations take the lead in automating their everyday workflows. The mainstay of organized businesses are their time-tested workflows, seasoned with practice and expertise. To ...

    • Build and Share Circuit Templates with Qntrl Studio

      Early Access Circuit Templates in Qntrl Studio is not enabled for all users. If you’d like to try it out, please email our support team for early access. Qntrl enables you to create pre-configured, ready-to-use Circuit templates that can be installed ...

    You are currently viewing the help articles of Qntrl 3.0. If you are still using our older version and require guidance with it, Click here.