Temel Node'lar ve Arayüz
n8n'in en sık kullanılan trigger ve action node'ları. Node verileri (items), parametreler, çalıştırma modları.
Bu bölümde
n8n'in arayüzü tek bir tuval (canvas) ve sürükle-bırak node'lardan oluşur. Her workflow bir trigger ile başlar, sonra action node'larıyla devam eder. Bu bölümde en sık kullanacağınız node'ları (Manual, Schedule, Webhook, Set, Code) ve veriyi node'lar arasında nasıl taşıdığınızı (items, $json, $input) öğreneceksiniz.
Konular
- Trigger node'ları: Manual, Schedule, Webhook
- Set, Edit Fields, Code node'ları
- Function vs Function Item: ne zaman hangisi
- Items ve $json, $input kavramları
- Run modları: Test ve Production
- Hatalı node'u debug etme
Trigger node'ları: Manual, Schedule, Webhook
Her workflow bir trigger ile başlar. Manual Trigger: 'Execute Workflow' butonuyla başlatırsınız — geliştirme ve test için idealdir. Schedule Trigger: cron benzeri bir zamanlamayla otomatik tetiklenir (örn. her gece 02:00). Webhook Trigger: dışarıdan POST/GET isteği geldiğinde anında tetiklenir — entegrasyonların kalbidir. Doğru tetikleyici, doğru senaryo için seçilmelidir.
Set, Edit Fields ve Code node'ları
Set (veya yeni adıyla Edit Fields): veriyi değiştirir, yeni alan ekler, alan adlarını yeniden düzenler. Code node: JavaScript ile karmaşık dönüşümler, döngüler ve özel mantık yazmanızı sağlar. Genel kural: kuralın basit ifade edilebilirse Set yeterli, gerçekten kod gerektiren senaryolarda Code'a geçin.
Function vs Function Item
Code node (eski adıyla Function/Function Item) iki modda çalışır. 'Run Once for All Items' tüm veriyi tek seferde işler (Function moduyla aynı). 'Run Once for Each Item' her item için ayrı çalışır (Function Item). Toplu işlem için ilki hızlıdır; item bazlı dönüşüm gerekirse ikincisi daha temiz ve anlaşılır kod sağlar.
Items kavramı: $json, $input ve $node
n8n her node'dan çıkan veriyi 'items' dizisi olarak bir sonraki node'a verir. Her item bir { json: {...}, binary: {...} } objesidir. Bir sonraki node'da o veriye erişmek için expression yazarsınız: $json.field güncel item'ın alanını, $input.first().json.field ilk item'ın alanını, $node['NodeName'].json.field başka bir node'un çıktısını döner. Bu üç kavramı oturttuğunuzda n8n'in %80'ini çözmüş olursunuz.
Test vs Production: çalıştırma modları
n8n'de iki ayrı çalıştırma modu vardır. Test (Editor): manuel test, her node ayrı çalıştırılabilir, sonuçlar tabloya düşer. Production (Active): workflow 'Active' yapılınca trigger'lar gerçek zamanlı çalışır ve sonuçlar Executions ekranında loglanır. Önce mutlaka Test'te doğrulayın, sonra Active yapın.
Hatalı node'u debug etme
Bir node kırmızı renkte gelirse hata vardır. Önce o node'a tıklayıp Output sekmesinden hata mesajını okuyun. En sık nedenler: yanlış expression ({{ }} dışında kullanılmış), eksik credentials, API'den gelen 4xx/5xx hatası veya beklenen alanın olmaması. 'Pin Data' özelliğiyle önceki çıktıyı sabitleyip aynı veriyle defalarca test edebilirsiniz.
Bu bölümün workflow'u (n8n editör görünümü)