JSON Verisini Diske İkili (Binary) Dosya Olarak Yazma

Genel Bakış

Bu n8n workflow'u, JSON formatındaki verileri alıp, bunları ikili (binary) bir formata dönüştürerek yerel dosya sisteminize kaydetmenizi sağlar. 'İkili Dosya Yazma' düğümünün doğrudan JSON verisiyle çalışamaması sorununu, özel bir 'Fonksiyon' düğümü kullanarak aşar. Bu, özellikle yapılandırılmış verileri diskte depolamanız veya belirli bir dosya formatında dışa aktarmanız gerektiğinde kullanışlıdır.

Gereksinimler

• Çalışır durumda bir n8n kurulumu (yerel, bulut veya Docker).
• Herhangi bir harici API anahtarı veya kimlik bilgisi gerekmez, ancak dosya yazma işlemi için n8n'in çalıştığı sunucuda uygun dosya sistemi izinleri olmalıdır.

Kurulum Adımları

1. Workflow'u İçe Aktarın: Bu workflow'u n8n arayüzünüze içe aktarın. Genellikle 'Workflow'lar' sekmesinden 'Yeni' butonuna tıklayıp 'Boş Workflow' seçeneğini seçtikten sonra, sağ üstteki üç nokta menüsünden 'İçe Aktar' seçeneğini kullanabilirsiniz.
2. Örnek Veriyi Özelleştirin: Workflow'daki ilk düğüm (genellikle bir 'Set' veya 'Function' düğümü olabilir), diske yazılacak örnek JSON verisini içerir. Bu veriyi kendi ihtiyaçlarınıza göre özelleştirebilir veya başka bir düğümden (örneğin bir HTTP Request, Veritabanı veya başka bir uygulama entegrasyonu) gelen verilerle değiştirebilirsiniz.
3. 'Make Binary' Düğümünü İnceleyin: 'Make Binary' adlı 'Fonksiyon' düğümü, JSON verisini ikili formata dönüştüren kritik kodu içerir. Bu düğümün içindeki JavaScript kodu, gelen JSON verisini alır ve 'binary' veri türüne dönüştürerek bir sonraki 'Write Binary File' düğümüne aktarır. Kod genellikle şöyle bir yapıya sahiptir:

   const jsonString = JSON.stringify(items[0].json);
   const buffer = Buffer.from(jsonString, 'utf8');
   return [{ json: {}, binary: { data: { data: buffer, mimeType: 'application/json' } } }];
   

   Bu kod, JSON objesini bir string'e dönüştürür, ardından bu string'i bir Buffer'a (ikili veri) çevirir ve 'binary' alanına ekler.
4. 'Write Binary File' Düğümünü Yapılandırın: Bu düğüm, ikili veriyi diske yazmaktan sorumludur. Aşağıdaki ayarları kontrol edin:
   • File Name: Yazılacak dosyanın adını belirtin (örn: data.json). Dinamik dosya adları için ifadeler kullanabilirsiniz (örn: {{ $now.toFormat('yyyy-MM-dd-HH-mm-ss') }}.json).
   • File Path: Dosyanın kaydedileceği dizin yolunu belirtin (örn: /tmp/ veya /var/www/html/data/). n8n'in bu yola yazma izni olduğundan emin olun.
   • Overwrite: Mevcut dosyaların üzerine yazılıp yazılmayacağını belirleyin.
5. Workflow'u Aktive Edin: Tüm ayarları yaptıktan sonra, workflow'u sağ üst köşedeki 'Aktif' (Active) anahtarını kullanarak etkinleştirin. Ardından, manuel olarak çalıştırabilir veya bir tetikleyici (örneğin bir 'Cron' düğümü) ekleyerek belirli aralıklarla otomatik olarak çalışmasını sağlayabilirsiniz.

Kullanım Senaryoları

• Senaryo 1: API Yanıtlarını Yedekleme: Belirli bir API'den gelen JSON yanıtlarını düzenli olarak alıp, diskte tarih damgalı JSON dosyaları olarak yedeklemek. Bu, veri geçmişini tutmak veya hata ayıklama amacıyla kullanılabilir.
• Senaryo 2: Yapılandırma Dosyası Oluşturma: Bir n8n workflow'u içinde dinamik olarak oluşturulan veya değiştirilen bir yapılandırma JSON dosyasını, başka bir uygulamanın okuyabileceği bir dizine kaydetmek.

İpuçları ve Öneriler

• Güvenlik: Dosya yazma izinlerini dikkatli yönetin. n8n'in çalıştığı kullanıcının yalnızca belirli dizinlere yazma izni olduğundan emin olun.
• Hata Yönetimi: 'Write Binary File' düğümünden sonra bir 'If' veya 'Error Trigger' düğümü ekleyerek dosya yazma işlemlerindeki olası hataları yakalayabilir ve bildirim gönderebilirsiniz.
• Dinamik Dosya Adları: Dosya adlarını dinamik hale getirmek için ifadeler kullanın. Bu, her çalıştırmada benzersiz dosyalar oluşturmanıza yardımcı olur ve veri kaybını önler.
• Veri Tipi Kontrolü: 'Fonksiyon' düğümüne girmeden önce verinin gerçekten JSON formatında olduğundan emin olmak için bir 'JSON' düğümü kullanabilirsiniz.