Knowledge Base

File Drop Automation

Duration: ~25 min · Level: Intermediate

Prerequisites: Nodlyn Studio on-prem or a runtime agent with filesystem access. A folder you can write test files into.

Automate processing when files land in a shared inbox — typical for ERP exports, EDI, or legacy systems that only write CSV to disk.

Goal

When orders-*.csv appears in C:\data\inbox, read the file, send each row to an HTTP API, then archive the file.

Step 1 — File Changed trigger

  1. Add File Changed from Triggers.
  2. Inspector settings:
    • Folder PathC:\data\inbox (create the folder first).
    • File Filterorders-*.csv.
    • Change TypeCreated.

See File Changed for all properties.

Step 2 — Read File

  1. Connect Read File after the trigger.
  2. Set File Path to {{filePath}} from the trigger output.
  3. Choose FormatCSV if rows should iterate downstream.

Step 3 — Transform and HTTP

  1. Add Transform to map CSV columns to your API schema.
  2. Add HTTP Request — POST each row or batch depending on your API.
  3. Use {{$var.apiUrl}} for the endpoint base.

Step 4 — Archive processed files

  1. After success, add Move File (or Write File + delete) to move {{filePath}} to C:\data\archive\.
  2. Log failures so operators can retry from Jobs → Failed.

Step 5 — Activate on-prem

  1. Validate the workflow. File triggers require Active state on a host with folder access.
  2. Drop a test CSV into the inbox and verify Jobs → History.
Cloud note: File Changed is not available in Nodlyn Cloud — export as a runtime agent on the machine that owns the folder.

Runtime deployment

For production file drops on a server without Studio:

  1. Activate the workflow in Studio.
  2. Export Runtime with the same inbox path on the target host.
  3. Install as a Windows service or Linux systemd unit.

See also

Nodlyn Assistant
Ask me anything about Nodlyn
Hi! 👋 I'm the Nodlyn assistant. Ask me about the product, workflow components, connectors, agent runtime, agent capabilities, deployment, and more. If I don't know an answer, I'll point you to our contact form.