Visual Automation Builder

Learn about how Couchdrop's visual workflow builder works

Overview

The Automation Builder provides a visual way to define the order in which actions run in a Couchdrop Automation.

Actions are arranged as a tree. Actions moving down the tree are Primary Actions, while actions branching to the right are Sub-actions.

Understanding this structure is important because it determines which file each action operates on and the order in which Couchdrop processes the workflow.

Automations have two main pathways. Moving down the tree are primary actions. Moving to the right are sub-actions.

Primary Actions

Primary Actions run vertically down the workflow and operate on the original file.

For example, if a Primary Action copies a file, any Sub-actions attached to that Copy action operate on the copied file rather than the original.

Because Primary Actions continue to reference the original file, some actions are not available at this level where their use could interfere with later processing. For example, Rename File is not available as a Primary Action.

Sub-actions

Sub-actions branch to the right of another action.

A Sub-action operates on the output of its parent action. If the parent action creates another file, such as with a Copy action, the Sub-action operates on that new file.

If no additional file has been created, the Sub-action operates on the original file.

This lets you build dependent sequences where each action works with the result of the previous action.

If a Sub-action fails, Couchdrop will not continue processing any child actions beneath it.

Processing Order

Couchdrop processes Automation actions top-to-bottom, then left-to-right.

This means an action and its Sub-actions are completed before Couchdrop continues to the next Primary Action.

The Automation Builder indicates processing order using letter groups and numbered actions.

All actions in the A group are processed first in numerical order. Couchdrop then processes the B group, followed by subsequent groups.

For example, a workflow may be processed as:

A1 → A2 → A3 → B1 → B2 → C1

The visual hierarchy therefore represents both the relationship between actions and the order in which they run.

All A group actions will occur first in numerical order, followed by the B group, and so on.

Modifying an Automation

Once an action has been added, its action type cannot be changed directly. To use a different action, delete the existing action and add a replacement.

You can insert a new action between existing actions using the plus icon between steps. Couchdrop will adjust the subsequent steps and processing order automatically.

Deleting an action also deletes any Sub-actions beneath it. If an action has child actions, Couchdrop displays a warning showing how many actions will be removed before you confirm the deletion.