Documentation

Advanced Workflow Validation

nLink features a Level-2 proactive graph integrity validation engine. Unlike standard flowchart builders, nLink continuously analyzes your architecture mathematically to catch configuration flaws, dangling variables, and unreachable node silos well before execution begins.

1. Floating Nodes & Unreachable Paths

Building complex visual workflows often leads to components accidentally detaching from the primary execution thread. The nLink engine proactively mitigates this logic gap.

  • The "Orphan" Check
    Except for Triggers (which initiate the flow), every Action or Logic node must receive an incoming datastream connection. If you drag an HTTP Request Node onto the canvas but fail to connect an incoming data wire, the node becomes mathematically 'Floating'.
  • Why It Matters
    A Floating node is unreachable. The execution engine operates linearly from the Trigger. If a node is unconnected, it will never execute. The nLink studio identifies this in real-time, placing a [⚠️] Warning badge on the node to immediately notify you that the component is orphaned.

2. Advanced Fault Tolerance (Swallowing Errors)

Network requests frequently fail (e.g., 404s, 500s). By default, if a node fails due to an external timeout or fatal error, nLink forcefully terminates the entire workflow execution stream and triggers a critical system alert.

However, experienced engineers often want to logically 'catch' these errors to route to fallback mechanisms utilizing the Continue On Fail toggle.

  • Opening the Error Port
    When you enable continueOnFail within a node's configuration, nLink overrides its default crash behavior. Instead, it unlocks a hidden, secondary Error Output Port on the visual canvas, specifically dedicated to fielding caught exceptions.
  • Dangling Error Port Protection
    Enabling continueOnFail without attaching a fallback node to the new Error Port creates a 'Dangling Catch' scenario, causing the workflow to silently swallow the error and halt abruptly. If nLink detects that your Error Port is unconnected, it triggers a real-time reactive Warning Toast, preventing a silent execution failure.

Best Practice: Always attach a notification node (like Slack, Gmail, or a Database logger) explicitly to the Error Port when continueOnFail is toggled to actively monitor API outages.

3. The Architecture Publish Gatekeeper

nLink's compilation engine guarantees system-wide validity before pushing a local draft logic matrix into a production runtime state.

Workflow Validation Sequence:
==========================================
1. Evaluate Graph Nodes Count > 0
2. Detect at least One Mandatory Trigger Node [Schedule, Webhook, Zalo OA]
3. Evaluate Input/Output Integrity Checksum

STATUS: [PASSED] -> Granted Publish Rights

Trigger Nodes Are Mandatory: nLink disallows compilation and refuses Publish commands if the canvas lacks a valid, recognized Trigger Node. A complex graph of Actions is fundamentally inert if the engine lacks an explicit HTTP listener or Temporal Cron job to initiate the execution stream.