Flow Control Nodes

Flow control nodes are essential for managing the logic and execution flow of your workflows in ANDRON. These nodes help you create dynamic, conditional, and iterative processes.

Start Node

The Start Node serves as the entry point for every workflow, defining the initial state and input parameters.

Configuration

• Name: Optional label for the start node
• Initial Data: Optional initial data passed to the workflow
• Input Schema: Optional JSON schema to validate input data

Example

{
  "type": "start",
  "name": "Workflow Initialization",
  "initialData": {
    "userId": null,
    "processType": "default"
  }
}

Use Cases

• Workflow initialization
• Setting default workflow parameters
• Input validation before processing

End Node

The End Node marks the completion of a workflow, providing a status and optional final output.

Configuration

• Name: Optional label for the end node
• Status: Workflow completion status
  • success: Workflow completed successfully
  • failure: Workflow encountered an error
  • partial: Workflow partially completed
• Output Data: Optional final workflow output

Example

{
  "type": "end",
  "name": "Process Completion",
  "status": "success",
  "output": {
    "totalProcessed": 42,
    "elapsedTime": "00:05:23"
  }
}

Use Cases

• Signaling workflow completion
• Aggregating final results
• Logging workflow outcomes

Condition Node

The Condition Node enables branching logic based on evaluated conditions.

Configuration

• Condition Type:
  • equals
  • notEquals
  • greaterThan
  • lessThan
  • greaterThanOrEqual
  • lessThanOrEqual
  • contains
  • startsWith
  • endsWith
• Left Operand: First value to compare
• Right Operand: Second value to compare
• True Path: Workflow path if condition is true
• False Path: Workflow path if condition is false

Example

{
  "type": "condition",
  "name": "Check User Role",
  "condition": {
    "type": "equals",
    "leftOperand": "{{user.role}}",
    "rightOperand": "admin"
  },
  "truePath": "admin_workflow",
  "falsePath": "user_workflow"
}

Use Cases

• Role-based routing
• Data validation
• Conditional processing

Delay Node

The Delay Node introduces a timed pause in workflow execution.

Configuration

• Duration: Time to pause (in milliseconds, seconds, minutes)
• Unit:
  • ms (milliseconds)
  • s (seconds)
  • m (minutes)
  • h (hours)

Example

{
  "type": "delay",
  "name": "Processing Pause",
  "duration": 30,
  "unit": "s"
}

Use Cases

• Rate limiting
• Simulating real-world processing times
• Implementing retry mechanisms

Loop Node

The Loop Node enables iteration over collections or repeated execution.

Configuration

• Iteration Mode:
  • forEach: Iterate over each item in a collection
  • repeat: Fixed number of iterations
  • while: Continue until a condition is met
• Collection: Array to iterate over
• Iteration Limit: Maximum number of iterations
• Break Condition: Optional condition to exit loop early

Example

{
  "type": "loop",
  "name": "Process Users",
  "mode": "forEach",
  "collection": "{{users}}",
  "iterationLimit": 100,
  "breakCondition": {
    "type": "equals",
    "leftOperand": "{{currentUser.status}}",
    "rightOperand": "blocked"
  }
}

Use Cases

• Batch processing
• Parallel task execution
• Conditional iterations

Error Handling

• Each node includes built-in error tracking
• Errors propagate through the workflow
• Configurable error handling paths
• Detailed error logs available in workflow run history

Performance Considerations

• Start and End nodes have minimal computational overhead
• Condition and Loop nodes are optimized for large datasets
• Delay nodes use efficient scheduling mechanism
• Configurable iteration and timeout limits prevent infinite loops