AltScore
Workflow Builder/User Guide

Interface Overview

The Workflow Builder V2 provides a visual canvas for designing and managing automated workflows. This guide covers the main interface components and how to navigate them effectively.

Canvas Area

The canvas is the central workspace where you build your workflow. It uses a node-based visual editor with drag-and-drop capabilities.

Key features:

  • Drag and drop nodes to reposition them
  • Zoom in/out using scroll wheel or pinch gestures
  • Pan the canvas by clicking and dragging on empty space (when in pan mode)
  • Select multiple nodes by holding Shift and clicking, or by drawing a selection box
  • Nodes display their type, name, and a brief status indicator

The canvas automatically validates connections between nodes, preventing invalid configurations such as circular dependencies or incompatible handle types.

Vertical Toolbar (Left Side)

The vertical toolbar on the left side of the canvas provides quick access to navigation and layout controls.

ToolDescription
Selection ModeClick and drag to select nodes. Default mode for editing.
Pan ModeClick and drag to move around the canvas without selecting nodes.
Zoom InIncrease canvas magnification.
Zoom OutDecrease canvas magnification.
Fit ViewAutomatically zoom and pan to show all nodes.
Auto-layoutAutomatically arrange nodes in a readable left-to-right flow.
Minimap ToggleShow or hide the minimap in the bottom corner.

Use the minimap when working with large workflows to quickly navigate to different sections. Click anywhere on the minimap to jump to that area of the canvas.

Horizontal Toolbar (Top)

The top toolbar contains workflow-level controls and actions.

Workflow Identity

  • Workflow Name: Displays the current workflow name. Click to edit.
  • Status Badge: Shows whether the workflow is Draft, Published, or has unsaved changes.
  • Version Dropdown: Switch between different versions of the workflow. The current version is highlighted.

Actions

  • Save: Save the current workflow state as a draft. Keyboard shortcut: Cmd+S (Mac) or Ctrl+S (Windows).
  • Publish: Deploy the workflow to production. Opens a confirmation dialog with version notes.
  • Execute/Test: Run the workflow with test input data. Results appear in the Properties Panel.

Publishing a workflow makes it immediately available for execution. Always test your workflow thoroughly before publishing to production.

Properties Panel (Right Side)

The Properties Panel appears when you select a node on the canvas. It provides detailed configuration options organized into tabs.

Configure Tab

The primary configuration interface for the selected task. Each task type has different options:

  • Task Name: A descriptive name for this specific instance
  • Task-specific settings: Varies based on task type (data source selection, rule configuration, output mappings, etc.)
  • Required fields: Marked with an asterisk (*) and must be completed before saving

Preview Tab

Shows the output from the last execution of this task:

  • Output Data: The JSON output produced by the task
  • Execution Time: How long the task took to complete
  • Status: Success, failure, or skipped

This tab is useful for debugging and understanding the data flowing through your workflow.

Logs Tab

Displays execution logs and test results for the selected task:

  • Execution History: List of recent executions with timestamps
  • Log Messages: Detailed logs including errors, warnings, and info messages
  • Stack Traces: Full error details when tasks fail

Advanced Tab

Contains advanced configuration options:

  • Input Mappings: Define how data from previous tasks maps to this task's inputs
  • Variable Resolution: Configure how variables are resolved at runtime
  • Retry Settings: Configure automatic retry behavior for failed tasks
  • Timeout Settings: Set maximum execution time for the task

Input mappings use JSONPath expressions to reference data from previous tasks. For example, $.tasks.fetch_borrower.output.name references the name field from a task called "fetch_borrower".

Elements Panel (Bottom)

The Elements Panel slides up from the bottom of the screen to manage workflow-wide elements. Access it by clicking the panel toggle or pressing the designated keyboard shortcut.

Available Sections

SectionPurpose
VariablesDefine workflow-level variables that can be accessed by any task
RulesManage business rules used by conditional tasks
ScorecardsConfigure scoring models for credit decisions
Mapping TablesSet up lookup tables for data transformation

Each section provides a list view with search, create, edit, and delete capabilities.

Components Menu

Add new tasks to your workflow through the Components Menu.

How to access:

  • Click the + button in the toolbar
  • Right-click on empty canvas space
  • Use keyboard shortcut Cmd+K (Mac) or Ctrl+K (Windows)

Task Categories

Tasks are organized into logical categories:

  • Control Flow: Conditional branches, loops, parallel execution, wait states
  • Actions: API calls, data mutations, notifications, document generation
  • Operations: Data transformations, calculations, aggregations
  • Utilities: Comments, debugging tools, variable setters

Click a task to add it at the default position, or drag it directly onto the canvas to place it precisely.

Use the search bar at the top of the Components Menu to quickly find tasks by name. The menu remembers your recently used tasks for quick access.

Keyboard Shortcuts

Master these shortcuts to work more efficiently:

ShortcutAction
Cmd/Ctrl + SSave workflow
Cmd/Ctrl + ZUndo last action
Cmd/Ctrl + Shift + ZRedo last action
Delete or BackspaceRemove selected node(s)
EscapeDeselect all / Close panel
Cmd/Ctrl + KOpen Components Menu
Cmd/Ctrl + DDuplicate selected node(s)
Cmd/Ctrl + ASelect all nodes

Keyboard shortcuts are displayed in tooltips when hovering over toolbar buttons. You can also access a full shortcut reference from the Help menu.

Next Steps

Now that you understand the interface, learn how to build your first workflow.

On this page