Tablo verilerinden önizleme görüntüleri oluşturmak, gösterge panoları veya e-posta raporları oluştururken yaygın bir gereksinimdir. GroupDocs.Conversion Cloud SDK for Node.js sunucu tarafında CSV dosyalarını yüksek kaliteli JPG görüntülerine dönüştürebilen güçlü bir API sağlar. Kitaplığın async yöntemlerini kullanarak Node.JS’te CSV’yi JPG’ye nasıl dönüştüreceğinizi öğrenecek, tam bir kod örneğini görecek, eşdeğer cURL çağrılarını keşfedecek ve çıktıyı ince ayar yapmak için yapılandırma seçeneklerini keşfedeceksiniz.

CSV’yi Node.JS’te JPG’ye Dönüştür - Tam Kod Örneği

Bu örnek, kütüphanenin async API’si kullanılarak GroupDocs Cloud depolama alanında saklanan bir CSV dosyasının JPG görüntülerine dönüştürülmesini gösterir.

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

// Replace with your actual GroupDocs Cloud credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

async function convertCsvToJpg() {
    // Initialize the Conversion API
    const convertApi = new ConvertApi(clientId, clientSecret);

// Source CSV file stored in GroupDocs Cloud storage
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.csv";

// Conversion options: CSV -> JPG
    const convertOptions = new ConvertOptions();
    convertOptions.fileInfo = fileInfo;
    convertOptions.format = "jpg";

// Conversion settings (output folder in storage)
    const convertSettings = new ConvertSettings();
    convertSettings.outputPath = "output_images";
    convertSettings.convertOptions = [convertOptions];

try {
        const result = await convertApi.convertDocument(convertSettings);
        console.log("Conversion completed. Generated files:");
        result.forEach(file => console.log(file.path));
    } catch (err) {
        console.error("Conversion failed:", err);
    }
}

convertCsvToJpg();

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını (input.csv, output_images vb.) gerçek dosya konumlarınızla eşleşecek şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde kurulduğunu doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgelere bakın veya yardım için destek ekibi ile iletişime geçin.

CSV’den JPG’ye Dönüştürme cURL ve REST API Kullanarak

Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm bir dizi cURL komutuyla gerçekleştirilebilir.

  1. Erişim belirteci alın - istemci kimlik bilgilerinizle kimlik doğrulaması yapın.
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. Kaynak CSV’yi yükleyin - dosyayı GroupDocs Cloud depolamanıza yerleştirin.
curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/your/input.csv"
  1. Dönüşümü isteyin - hedef formatı JPG olarak belirtin.
curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?format=jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo":{"filePath":"input.csv"}}'
  1. Oluşturulan görüntü(leri) indirin - çıktı klasöründen dosyaları alın.
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output_images/your_image.jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o your_image.jpg

Bu komutlar, herhangi bir kod yazmadan tam bir CSV‑to‑JPG iş akışını gösterir. Daha fazla ayrıntı için, resmi API belgelerine bakın.

Node.JS’de CSV’den JPG’ye Dönüşüm Sürecini Anlamak

Aşağıda, daha önce gösterilen kodun adım adım açıklaması bulunmaktadır:

  1. API istemcisini başlat - new ConvertApi(clientId, clientSecret) kimlik doğrulamalı bir oturum oluşturur.
const convertApi = new ConvertApi(clientId, clientSecret);
  1. Kaynak dosyayı tanımlayın - bir FileInfo nesnesi, GroupDocs Cloud’da depolanan input.csv dosyasına işaret eder.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.csv";
  1. Dönüşüm seçeneklerini ayarla - ConvertOptions.format = "jpg" hizmetin JPG çıktısı üretmesini sağlar.
const convertOptions = new ConvertOptions();
convertOptions.fileInfo = fileInfo;
convertOptions.format = "jpg";
  1. Çıktı ayarlarını yapılandır - ConvertSettings.outputPath görüntülerin nereye kaydedileceğini belirler.
const convertSettings = new ConvertSettings();
convertSettings.outputPath = "output_images";
convertSettings.convertOptions = [convertOptions];
  1. Dönüştürmeyi çalıştır - convertApi.convertDocument(convertSettings) isteği gönderir ve oluşturulan dosya yollarının bir dizisini döndürür.
    const result = await convertApi.convertDocument(convertSettings);

Sınıfların ve özelliklerin tam listesi için, API referansına bakın.

Önkoşullar ve Kurulum

  1. Node.js runtime - version 12 veya üzeri gereklidir.
  2. GroupDocs Cloud account - GroupDocs portalından clientId ve clientSecret alın.
  3. Install the SDK - aşağıdaki komutu çalıştırın (paketi resmi sürüm sayfasından indirin):
npm install groupdocs-conversion-cloud
  1. SDK’yı içe aktar projenizde:
const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

Kurulumla ilgili daha fazla ayrıntı için, indirme sayfasına bakın.

Dönüştürme Ayarları: Seçenekler ve Parametreler

SDK, ayarlayabileceğiniz çeşitli özellikler sunar:

  • Output Path - JPG dosyalarının depolandığı klasörü kontrol eder.
convertSettings.outputPath = "output_images";
  • Hedef Biçim - "jpg" değerini "jpeg" olarak değiştirin, eğer JPEG varyantına ihtiyacınız varsa.
convertOptions.format = "jpeg";
  • Özel Boyutlar - destekleniyorsa genişlik ve yüksekliği belirtebilir, tam boyutta görüntüler oluşturabilirsiniz.
convertOptions.width = 800;   // example width in pixels
convertOptions.height = 600;  // example height in pixels
  • Asenkron Yürütme - SDK yöntemleri promise döndürür, böylece dönüşümü asenkron iş akışlarına bloklamadan olay döngüsünü engellemeden entegre edebilirsiniz.
await convertApi.convertDocument(convertSettings);

Bu seçenekler, CSV‑to‑JPG iş akışını belirli otomasyon veya entegrasyon ihtiyaçlarınıza göre özelleştirmenizi sağlar.

Sonuç

Node.JS’te CSV’yi JPG’ye dönüştürmek, GroupDocs.Conversion Cloud SDK for Node.js ile oldukça basittir. Kütüphane, bulutta ağır işleri halleder ve iş mantığı ile entegrasyona odaklanmanızı sağlar. Bulut kimlik bilgilerinizi güvence altına almayı, uygun çıktı formatını (JPG veya JPEG) seçmeyi ve iş akışınıza uygun olacak şekilde boyutlar veya çıktı yolları gibi ayarları düzenlemeyi unutmayın. Üretim dağıtımları için ücretli bir lisansa ihtiyacınız olacak; fiyatlandırma detaylarını inceleyebilir ve geçici bir lisans alabilirsiniz geçici lisans sayfası. Sağlanan kod ve cURL örnekleriyle, CSV‑to‑JPG otomasyonunu herhangi bir backend servisine eklemeye hazırsınız.

FAQs

  • Node.JS’de özel ayrıştırma mantığı yazmadan CSV’yi JPG’ye nasıl dönüştürürüm?
    SDK, CSV’yi doğrudan GroupDocs Cloud depolamasından okur ve her satırı bir görüntü olarak render eder, bu yüzden harici araçlara ihtiyacınız yok. Sadece kod örneğini veya cURL iş akışını izleyin.

  • CSV’yi arka uçta JPG yerine JPEG olarak dönüştürmek mümkün mü?
    Evet. Koddaki convertOptions.format = "jpeg" ayarını yapın veya REST isteğinde format=jpeg kullanın. Her iki format da Node.JS’te arka uç dönüşümü için desteklenir.

  • Sunucumu engellemeden dönüşümü asenkron olarak çalıştırabilir miyim?
    Kesinlikle. Tüm SDK yöntemleri promise döndürür, bu yüzden await edebilir veya .then() işleyicilerini ekleyebilirsiniz. Bu, engellemeyen, ölçeklenebilir CSV‑to‑JPG otomasyonunu sağlar.

  • CSV’den görüntüye dönüşümlerine dair daha fazla örnek nerede bulabilirim?
    Resmi belgeler ek örnekler içerir ve GroupDocs Conversion Forum topluluk forumu sorular sormak için iyi bir yerdir.

Read More