Building Workflows — Walkthrough Guide
Overview
Workflows in Vantage are visual automation pipelines that let you connect data sources, apply transformations, run AI analysis, and output results — all without writing code. The Workflow Editor provides a drag-and-drop canvas where you connect nodes together to build powerful data pipelines.
Accessing the Workflow Editor
- Click "Workflows" in the sidebar.
- Click "New Workflow" to create a new workflow, or click an existing workflow to edit it.
- The Workflow Editor opens, showing the canvas, the Node Library, and the Properties Panel.
Workflow Editor Layout
| Area | Description |
|---|---|
| Canvas | The main area where you drag, drop, and connect nodes. |
| Node Library | Left panel listing all available node types, organized by category. |
| Properties Panel | Right panel showing the settings for the currently selected node. |
| Toolbar | Top bar with run, save, undo/redo, and zoom controls. |
Adding Nodes
- Open the Node Library on the left.
- Browse categories or search for a specific node type.
- Drag a node from the library onto the canvas, or click to add it.
- The node appears on the canvas with input and output ports.
Node Categories
| Category | Nodes | Description |
|---|---|---|
| Triggers | Schedule Trigger, Logical Trigger, AI Trigger | How the workflow starts — on a schedule, on a condition, or via AI |
| Data Sources | Database, Workflow Input, File Upload, Google Drive, OneDrive | Where data comes from |
| Transformations | Aggregation, Filter, Sort, Union, Computed Column, Deduplicate, Fill/Clean, Data Validation, Data Classify | Manipulate and clean data |
| AI Nodes | AI Enrichment, AI Formatter, AI Summary, AI Compliance Check, AI Conditional, AI Transcriber, Image Analysis, PDF Extract, Text Extraction | AI-powered data processing |
| Integrations | Send Email, Calendar Event, Message (Slack/Teams), Web Scraper, API Builder | Connect to external services |
| Logic | Multi-Conditional, Compliance Check | Route data based on conditions |
| Outputs | Dashboard Output, Workflow Output, CSV/JSON Export | Where results go |
Connecting Nodes
- Hover over a node's output port (right side, small circle).
- Click and drag to another node's input port (left side).
- A connecting line (edge) appears linking the two nodes.
- Data flows from output → input along these connections.
Connection Rules
- A node's output can connect to multiple downstream nodes.
- Some nodes have multiple output ports (e.g., Conditional nodes have "true" and "false" outputs, Compliance Check has "pass" and "fail").
- The data preview shows what data is flowing through each connection.
Configuring Nodes
- Click a node on the canvas to select it.
- The Properties Panel opens on the right, showing all settings for that node.
- Each node type has different settings (see the documentation for each specific node).
- Common settings include:
- Name — A label for the node.
- Input columns — Which columns from upstream data to use.
- Configuration — Node-specific settings (query, conditions, policies, etc.).
- Batch size — How many rows to process at once (for AI nodes).
Running a Workflow
- Click the "Run" button in the toolbar.
- The workflow executes from trigger nodes through each connected node.
- Each node shows a status indicator:
- 🟡 Pending — Not yet executed.
- 🔵 Running — Currently processing.
- 🟢 Complete — Successfully finished.
- 🔴 Error — Something went wrong.
- Click any completed node to preview the output data in the Data Preview Panel.
Data Preview
The Data Preview Panel shows the output data at any point in the workflow:
- Click a completed node to see its output.
- View the data as a table with columns and rows.
- Use this to debug and verify your transformations are correct.
Saving & Managing Workflows
- Save — Click the save button in the toolbar. Workflows are auto-saved periodically.
- Rename — Edit the workflow name in the toolbar.
- Delete — Open the workflow list, click the delete icon on the workflow, and confirm.
- Duplicate — Create a copy of an existing workflow.
Example: Building a Simple ETL Workflow
- Add a Database node — Configure it to query your PostgreSQL database for customer orders.
- Add an Aggregation node — Connect it to the database node. Set it to group by
regionand sumrevenue. - Add a Filter node — Connect it to the aggregation. Filter where
revenue > 10000. - Add a Dashboard Output node — Connect it to the filter. Select the dashboard tile to display the results.
- Add a Schedule Trigger — Set it to run daily at 8 AM.
- Click "Run" to test. Verify the output at each step using Data Preview.
- Save the workflow. It will now run automatically on the schedule.