تولید تصاویر پیش‌نمایش از داده‌های جدولی یک نیاز رایج هنگام ساخت داشبوردها یا گزارش‌های ایمیلی است. GroupDocs.Conversion Cloud SDK for Node.js یک API قدرتمند ارائه می‌دهد که می‌تواند فایل‌های CSV را به تصاویر با کیفیت بالا از نوع JPG در سمت سرور تبدیل کند. شما یاد خواهید گرفت چگونه CSV را به JPG در Node.JS با استفاده از متدهای async کتابخانه تبدیل کنید، یک مثال کامل کد را ببینید، تماس‌های معادل cURL را بررسی کنید و گزینه‌های پیکربندی برای تنظیم دقیق خروجی را کشف کنید.

تبدیل CSV به JPG در Node.JS - مثال کامل کد

این مثال نشان می‌دهد که چگونه می‌توان یک فایل CSV ذخیره‌شده در فضای ذخیره‌سازی GroupDocs Cloud را به تصاویر JPG تبدیل کرد با استفاده از API ناهمزمان کتابخانه.

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();

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (input.csv, output_images, etc.) با مکان‌های واقعی شما مطابقت داشته باشد، تأیید کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

تبدیل CSV به JPG با استفاده از cURL و REST API

اگر ترجیح می‌دهید از روش خالص REST استفاده کنید، می‌توانید همان تبدیل را با یک سری دستورات cURL انجام دهید.

  1. دریافت توکن دسترسی - با اعتبارهای کلاینت خود احراز هویت کنید.
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. بارگذاری CSV منبع - فایل را در ذخیره‌سازی GroupDocs Cloud خود قرار دهید.
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. درخواست تبدیل - فرمت هدف را به JPG مشخص کنید.
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. دانلود تصویر(های) تولید شده - فایل‌ها را از پوشه خروجی بازیابی کنید.
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

این دستورات یک جریان کاری کامل CSV‑به‑JPG را بدون نوشتن هیچ کدی نشان می‌دهند. برای جزئیات بیشتر، به مستندات رسمی API مراجعه کنید.

درک فرآیند تبدیل CSV به JPG در Node.JS

در زیر تجزیه و تحلیل گام به گام کد نشان داده شده قبلی آورده شده است:

  1. مقداردهی اولیهٔ کلاینت API - new ConvertApi(clientId, clientSecret) یک جلسهٔ احراز هویت شده ایجاد می‌کند.
const convertApi = new ConvertApi(clientId, clientSecret);
  1. تعریف فایل منبع - یک شیء FileInfo به input.csv که در GroupDocs Cloud ذخیره شده اشاره می‌کند.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.csv";
  1. تنظیم گزینه‌های تبدیل - ConvertOptions.format = "jpg" به سرویس می‌گوید خروجی JPG تولید کند.
const convertOptions = new ConvertOptions();
convertOptions.fileInfo = fileInfo;
convertOptions.format = "jpg";
  1. پیکربندی تنظیمات خروجی - ConvertSettings.outputPath مشخص می‌کند که تصاویر در کجا ذخیره شوند.
const convertSettings = new ConvertSettings();
convertSettings.outputPath = "output_images";
convertSettings.convertOptions = [convertOptions];
  1. اجرای تبدیل - convertApi.convertDocument(convertSettings) درخواست را ارسال می‌کند و آرایه‌ای از مسیرهای فایل‌های تولید شده را برمی‌گرداند.
    const result = await convertApi.convertDocument(convertSettings);

برای دریافت فهرست کامل کلاس‌ها و ویژگی‌ها، به مرجع API مراجعه کنید.

پیش‌نیازها و راه‌اندازی

  1. Node.js runtime - نسخه 12 یا بالاتر مورد نیاز است.
  2. GroupDocs Cloud account - clientId و clientSecret را از پورتال GroupDocs دریافت کنید.
  3. Install the SDK - دستور زیر را اجرا کنید (پکیج را از صفحه رسمی انتشار دانلود کنید):
npm install groupdocs-conversion-cloud
  1. SDK را وارد کنید در پروژه خود:
const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

برای جزئیات بیشتر درباره نصب، به صفحه دانلود مراجعه کنید.

تنظیمات تبدیل: گزینه‌ها و پارامترها

SDK چندین ویژگی را در اختیار شما می‌گذارد که می‌توانید تنظیم کنید:

  • مسیر خروجی - پوشه‌ای که فایل‌های JPG در آن ذخیره می‌شوند را کنترل می‌کند.
convertSettings.outputPath = "output_images";
  • قالب هدف - اگر به نسخهٔ JPEG نیاز دارید، "jpg" را به "jpeg" تغییر دهید.
convertOptions.format = "jpeg";
  • ابعاد سفارشی - می‌توانید عرض و ارتفاع (در صورت پشتیبانی) را مشخص کنید تا تصاویر با اندازه دقیق تولید شوند.
convertOptions.width = 800;   // example width in pixels
convertOptions.height = 600;  // example height in pixels
  • اجرای ناهمزمان - متدهای SDK وعده‌ها (promises) را برمی‌گردانند، که به شما امکان می‌دهد تبدیل را در جریان‌های کاری ناهمزمان بدون مسدود کردن حلقه رویداد ادغام کنید.
await convertApi.convertDocument(convertSettings);

این گزینه‌ها به شما امکان می‌دهند تا جریان کار CSV‑to‑JPG را مطابق نیازهای خاص خود برای خودکارسازی یا ادغام تنظیم کنید.

نتیجه‌گیری

تبدیل CSV به JPG در Node.JS به‌صورت ساده‌ای با GroupDocs.Conversion Cloud SDK for Node.js انجام می‌شود. این کتابخانه بار سنگین را در ابر مدیریت می‌کند و به شما امکان می‌دهد بر منطق کسب‌وکار و یکپارچه‌سازی تمرکز کنید. به‌خاطر داشته باشید که اعتبارنامه‌های ابری خود را ایمن کنید، فرمت خروجی مناسب (JPG یا JPEG) را انتخاب کنید و تنظیماتی مانند ابعاد یا مسیرهای خروجی را مطابق با جریان کاری خود تنظیم کنید. برای استقرارهای تولیدی به یک لایسنس پرداختی نیاز خواهید داشت؛ می‌توانید جزئیات قیمت‌گذاری را بررسی کنید و لایسنس موقت را از صفحه لایسنس موقت دریافت کنید. با کدها و مثال‌های cURL ارائه‌شده، آماده‌اید تا خودکارسازی CSV‑to‑JPG را به هر سرویس بک‌اند اضافه کنید.

پرسش‌های متداول

  • چگونه می‌توانم CSV را به JPG در Node.JS تبدیل کنم بدون نوشتن منطق تجزیه سفارشی؟
    SDK CSV را مستقیماً از ذخیره‌سازی GroupDocs Cloud می‌خواند و هر ردیف را به عنوان تصویر رندر می‌کند، بنابراین نیازی به ابزارهای خارجی ندارید. فقط مثال کد یا جریان کار cURL را دنبال کنید.

  • آیا امکان تبدیل CSV به JPEG به جای JPG در بک‌اند وجود دارد؟
    بله. convertOptions.format = "jpeg" را در کد تنظیم کنید یا در درخواست REST از format=jpeg استفاده کنید. هر دو فرمت برای تبدیل بک‌اند در Node.JS پشتیبانی می‌شوند.

  • آیا می‌توانم تبدیل را به صورت ناهمزمان اجرا کنم تا از مسدود شدن سرورم جلوگیری کنم؟
    مطمئناً. تمام متدهای SDK وعده (promise) برمی‌گردانند، بنابراین می‌توانید از await استفاده کنید یا هندلرهای .then() را وصل کنید. این امکان اجرای غیرمسدود، مقیاس‌پذیر CSV‑به‑JPG را فراهم می‌کند.

  • کجا می‌توانم نمونه‌های بیشتری از تبدیل CSV به تصویر پیدا کنم؟
    مستندات رسمی مستندات شامل نمونه‌های اضافی است و انجمن جامعه در GroupDocs Conversion Forum مکان خوبی برای پرسش سوالات است.

بیشتر بخوانید