Створення зображень‑попередніх переглядів з табличних даних є поширеною вимогою при створенні інформаційних панелей або електронних звітів. GroupDocs.Conversion Cloud SDK for Node.js надає потужний API, який може перетворювати файли CSV у високоякісні зображення JPG на боці сервера. Ви дізнаєтеся, як конвертувати CSV у JPG у Node.JS, використовуючи асинхронні методи бібліотеки, переглянете повний приклад коду, дослідите еквівалентні виклики 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 тощо), щоб вони відповідали вашим реальним розташуванням файлів, перевірте, що всі необхідні залежності встановлені правильно, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Перетворення 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‑to‑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";
  • Цільовий формат - змініть "jpg" на "jpeg", якщо вам потрібен JPEG варіант.
convertOptions.format = "jpeg";
  • Користувацькі розміри - ви можете вказати ширину та висоту (якщо підтримується), щоб створювати зображення з точним розміром.
convertOptions.width = 800;   // example width in pixels
convertOptions.height = 600;  // example height in pixels
  • Асинхронне виконання - методи SDK повертають обіцянки, що дозволяє інтегрувати конвертацію в асинхронні робочі процеси без блокування циклу подій.
await convertApi.convertDocument(convertSettings);

Ці параметри дозволяють налаштувати процес CSV‑to‑JPG відповідно до ваших конкретних потреб в автоматизації або інтеграції.

Висновок

Конвертування CSV у JPG у Node.JS просте за допомогою GroupDocs.Conversion Cloud SDK for Node.js. Бібліотека виконує важку роботу в хмарі, дозволяючи вам зосередитися на бізнес‑логіці та інтеграції. Не забудьте захистити ваші хмарні облікові дані, вибрати відповідний формат виводу (JPG або JPEG) та налаштувати параметри, такі як розміри або шляхи виводу, відповідно до вашого робочого процесу. Для продакшн‑розгортань вам знадобиться платна ліцензія; ви можете ознайомитися з деталями цін і отримати тимчасову ліцензію на temporary license page. Завдяки наведеному коду та прикладам cURL, ви готові додати автоматизацію перетворення CSV‑to‑JPG у будь‑який бекенд‑сервіс.

FAQs

  • Як конвертувати CSV у JPG у Node.JS без написання власної логіки парсингу?
    SDK читає CSV безпосередньо з сховища GroupDocs Cloud і відображає кожен рядок як зображення, тому вам не потрібні зовнішні інструменти. Просто дотримуйтесь прикладу коду або cURL‑workflow.

  • Чи можливо конвертувати CSV у JPEG замість JPG у бекенді?
    Так. Встановіть convertOptions.format = "jpeg" у коді або використайте format=jpeg у REST‑запиті. Обидва формати підтримуються для конвертації у бекенді в Node.JS.

  • Чи можу я виконувати конвертацію асинхронно, щоб уникнути блокування мого сервера?
    Абсолютно. Усі методи SDK повертають проміси, тому ви можете await їх або приєднати обробники .then(). Це забезпечує неблокуючу, масштабовану автоматизацію CSV‑to‑JPG.

  • Де я можу знайти більше прикладів перетворень CSV у зображення?
    Офіційна документація містить додаткові приклади, а спільнотовий форум на GroupDocs Conversion Forum є хорошим місцем для запитань.

Читати далі