×
×
×
×

Circuit Workflows in DEX

A Circuit automates a task as a series of steps that run one after another, such as checking a condition, running your own code, waiting, and then taking the next action. You build it by dragging steps onto a canvas, so you can see the whole flow at a glance.

Circuits run in the cloud. They do not need the DEX agent and do not run on your managed devices. Use them for tasks that are not tied to a single device, such as calling another application, processing data, or sending updates on a schedule.

Circuit workflow page showing the Device and Circuit selectors in DEX

For automations that run on your devices (for example, cleaning up disk space or restarting a device), use a Device workflow. See Managing Workflows in DEX.

Device Workflow vs Circuit

Device workflowCircuit
Runs onYour managed devices, through the DEX agentThe cloud, with no agent or device
Use it forDevice tasks such as clean-up, restarts, fixes and user promptsTasks not tied to a device, such as calling other applications, processing data or raising tickets
Built withStages: Sensor, Switch, Script, Function, Engage, Send Mail, Delay, Restart and EndSteps: Function, Branch, Wait and Circuit
Custom codeScripts (PowerShell, VBScript, Batch, Shell) and the Function stageFunctions in JavaScript or Deluge, created in the Functions tab
PlatformAll Platforms, Windows or MacNot applicable
Ways to createCreate New, Choose from Extension or ZiaCreate New
Deployment targetsDevices or groupsNone
Deployment modesImmediate, Scheduled or Trigger (on an alert)Immediate or Scheduled
ResultsFor each device: the status of every stageFor each run: the canvas shows each step’s status and its input and output
Available inCloud and On-PremiseCloud only

Create a Circuit

  1. Go to DEX > Workflows and select Circuit.
  2. Click + Create Workflow and select Create New.
  3. Enter a name and description, then click Done. The workflow is created as a Draft and the circuit canvas opens.
  4. Drag the steps you need from the left pane onto the canvas, and set up each step in the right-hand pane.
  5. Click Save to make the workflow Active so that it can be deployed. To finish it later, click Save as Draft.
Circuit tab with the Create Workflow menu and Create New option

Add a Function to a Circuit

  1. Open your Circuit. The circuit canvas opens.
  2. From the left pane, drag the Function step onto the canvas, between the steps where it should run.
  3. Click the step and choose your function from the list. All functions from the Functions tab appear here.
  4. Add any input values the function needs.
  5. Optionally, choose what happens if the function fails: try again, or continue to the next step.
  6. Click Save.
Circuit canvas with a Function step between Start and End
Function step configuration showing the available JavaScript and Deluge functions

Run a Circuit from Another

If several workflows share the same steps, build those steps once as their own Circuit and call it from the others.

  1. Open your Circuit. The circuit canvas opens.
  2. From the left pane, drag the Circuit step onto the canvas.
  3. Click the step and choose the Circuit to run.
  4. Add any input values it needs.
  5. Click Save.
Circuit step configuration showing the available Circuits

To learn more about each step and its settings, see Zoho Circuit help.

Deploy a Circuit

Saving a Circuit does not run it. To run it, create a Circuit deployment.

  1. Open the Circuit and click its Deployments tab.
  2. Click Create Deployment.
  3. Enter a name and description.
  4. Choose when it runs: Immediate runs it once, right away. Scheduled runs it on the dates and time you choose.
  5. Click Create.
Circuit deployment dialog showing Immediate and Schedule deployment modes
Circuit Deployments tab showing a newly created deployment in progress

Note: You do not select devices or groups, because a Circuit does not run on devices. Only Active workflows can be deployed. Click Save, not Save as Draft, before you create a deployment.

View Run Details

Circuit run details showing the step graph, status, input, and output

Open the deployment to see each run and its status. Click a run to see its details. The canvas shows each step and whether it passed or failed, with the data that went in and out of it.

Note: A Scheduled deployment shows In progress until its last scheduled run is complete.

Example: Create a Ticket for Missing Critical Patches

Every day, check for critical patches that have been missing for more than 7 days, and open one ticket in your service desk that lists them.

  • Function “Find missing critical patches”: gets the critical patches that have been missing for more than 7 days.
  • Branch: if any are found, go to the next step. If none are found, go to Success.
  • Function “Create ticket”: creates one ticket in your service desk that lists the patches and the affected computers.
  • Success: ends the workflow.

Deploy the workflow as Scheduled to run daily. No devices are needed. Each run appears in the deployment with its status.

Frequently Asked Questions

What is the difference between a Device workflow and a Circuit?
A Device workflow runs on your managed devices through the DEX agent. A Circuit runs in the cloud and does not involve any device. See Device workflow vs Circuit above.
Do I need the DEX agent on my devices to use Circuit?
No. Circuit runs in the cloud, so no agent or device is needed.
Which languages can I use to write functions?
JavaScript and Deluge.
Can I use the same function in more than one Circuit?
Yes. Create the function once in the Functions tab and add it to any Circuit with the Function step.
Can one Circuit run another?
Yes. Add a Circuit step and choose the workflow to run.
How do I run a Circuit automatically on a schedule?
Create a Circuit deployment and choose Scheduled. Set the start date, time and end date.
How do I know if my Circuit worked?
Open its deployment. Each run shows In progress, Completed or Failed. Click a run to see what happened at each step.
Can I use Circuit in Endpoint Central On-Premise?
No. Circuit is available only in Endpoint Central Cloud.