Перетворення даних електронних таблиць у простий текст – це часта потреба, коли потрібно передати інформацію в застарілі системи або прості парсери. Aspose.Cells Cloud SDK for Node.js надає потужну бібліотеку, яка виконує важку роботу на боці сервера. У цьому посібнику ви побачите повний робочий приклад, cURL‑процес для REST API, кроки встановлення, параметри конфігурації та рекомендації кращих практик, щоб зробити перетворення CSV у TXT в Node.JS безболісним і надійним.

Повний робочий приклад перетворення CSV у TXT у Node.JS

Цей приклад демонструє, як викликати Cells API і зберегти конвертований файл TXT локально.

const fs = require('fs');
const path = require('path');
const { CellsApi, ApiClient } = require('@aspose/cells-cloud');

async function convertCsvToTxt() {
    // Aspose Cloud authentication
    const clientId = 'YOUR_CLIENT_ID';
    const clientSecret = 'YOUR_CLIENT_SECRET';
    const config = new ApiClient();
    config.clientId = clientId;
    config.clientSecret = clientSecret;
    config.basePath = 'https://api.aspose.cloud';

const cellsApi = new CellsApi(config);

// File paths
    const inputFile = path.resolve(__dirname, 'input.csv');
    const outputFile = path.resolve(__dirname, 'output.txt');

// Prepare request
    const fileStream = fs.createReadStream(inputFile);
    const request = {
        file: fileStream,
        format: 'txt' // target format
    };

try {
        // Convert CSV to TXT
        const response = await cellsApi.postConvertWorkbook(request);
        // response.body is a Buffer containing the TXT data
        fs.writeFileSync(outputFile, response.body);
        console.log(`Conversion completed. TXT saved to ${outputFile}`);
    } catch (err) {
        console.error('Conversion failed:', err);
    }
}

convertCsvToTxt();

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, чи всі необхідні залежності правильно встановлені, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь‑якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Розбиття CSV у TXT у Node.JS

Код працює у кілька логічних кроків:

  1. Ініціалізуйте клієнт API - new ApiClient() налаштований з вашими обліковими даними та базовим URL.
const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';
  1. Створіть екземпляр CellsApi - цей об’єкт надає метод конвертації.
const cellsApi = new CellsApi(config);
  1. Прочитайте CSV-файл як потік - fs.createReadStream забезпечує бінарні дані, необхідні API.
const fileStream = fs.createReadStream(inputFile);
  1. Створіть об’єкт запиту - властивість format вказує сервісу виводити TXT.
const request = {
    file: fileStream,
    format: 'txt'
};
  1. Виклик postConvertWorkbook - API повертає Buffer, що містить конвертований текст, який потім записується на диск.
const response = await cellsApi.postConvertWorkbook(request);
fs.writeFileSync(outputFile, response.body);

Розуміння кожного елементу допомагає налаштовувати процес, наприклад, додаючи обробку помилок або обробку декількох файлів.

Підготовка середовища

  1. Встановіть SDK за допомогою npm:
npm install asposecellscloud
  1. Переконайтеся, що у вас встановлено Node.js 14 або новішу версію.

  2. Завантажте останній пакет з офіційної сторінки випуску, якщо ви віддаєте перевагу ручному встановленню: Aspose.Cells Cloud SDK for Node.js Download.

  3. Створіть безкоштовний обліковий запис Aspose Cloud, щоб отримати ваш client ID та client secret.

Після виконання цих передумов ви можете негайно запустити скрипт конвертації.

Конвертування CSV у TXT за допомогою cURL та REST API

Ви можете досягти того ж результату, не пишучи жодного коду, викликавши REST‑інтерфейси Aspose.Cells Cloud безпосередньо.

  1. Отримайте токен доступу - обміняйте ваші облікові дані клієнта на JWT.
curl -X POST "https://api.aspose.cloud/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Завантажте вихідний CSV файл у сховище.
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.csv" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: text/csv" \
  --data-binary @input.csv
  1. Запит на конвертацію у формат TXT.
curl -X POST "https://api.aspose.cloud/v3.0/cells/convert?format=txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@input.csv"
  1. Завантажте отриманий файл TXT.
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.txt

Для отримання докладнішої інформації про кожен кінцевий пункт, дивіться Aspose.Cells довідник API.

Налаштування конвертації: опції та параметри

У прикладі використано лише два параметри, але API підтримує додаткові налаштування:

  • format – вказує тип цільового файлу. У нашому випадку встановлено 'txt'. Зміна цього значення дозволяє експортувати в інші формати простого тексту, підтримувані сервісом.
  • file – потік, що представляє вихідний CSV. Ви можете замінити потік на Buffer або рядок base64, якщо це відповідає вашій архітектурі.

Для повного списку підтримуваних параметрів зверніться до сторінки API Reference для postConvertWorkbook.

Практичні поради щодо експорту CSV у TXT

  • Перевірте вхідні файли перед відправкою їх до API, щоб уникнути неочікуваних помилок конвертації.
  • Повторно використовуйте клієнт API під час кількох конвертацій, щоб зменшити навантаження на автентифікацію.
  • Стрімити великі CSV-файли замість повного завантаження їх у пам’ять; fs.createReadStream вже робить це.
  • Обробляйте буфер відповіді з правильним кодуванням (utf8), якщо потрібно маніпулювати текстом після конвертації.
  • Захистіть свої облікові дані шляхом зберігання clientId та clientSecret у змінних середовища або менеджері секретів.

Дотримуючись цих практик, ви забезпечите ефективність та безпеку вашого застосунку.

Висновок

Перетворення CSV у TXT у Node.JS стає простим завдяки Aspose.Cells Cloud SDK for Node.js. Бібліотека абстрагує низькорівневі деталі, дозволяючи зосередитися на бізнес‑логіці, забезпечуючи надійні результати. Не забудьте отримати дійсну ліцензію для використання у продакшн‑середовищі; ви можете придбати підписку або отримати тимчасову ліцензію на сторінці тимчасової ліцензії. Завдяки прикладу коду, робочому процесу cURL та рекомендаціям щодо кращих практик у цій статті, ви готові інтегрувати експорт CSV у TXT у будь‑яке рішення на Node.JS.

FAQs

Як виконати перетворення CSV у TXT у Node.JS за допомогою Aspose.Cells Cloud?
Використовуйте SDK Aspose.Cells Cloud для Node.js, щоб викликати метод postConvertWorkbook. Передайте потік CSV‑файлу та встановіть формат 'txt'. Перегляньте повний приклад коду вище.

Чи можу я конвертувати кілька CSV файлів у TXT в одному запиті?
API обробляє один файл за запитом. Пройдіться по ваших файлах у Node.JS і викличте метод конвертації для кожного файлу.

Яка автентифікація потрібна для експорту CSV у TXT у Node.JS?
Вам потрібен client ID та client secret вашого облікового запису Aspose Cloud. SDK автоматично обмінює їх на токен доступу.

Де я можу знайти докладнішу інформацію про параметри конвертації?
Зверніться до офіційної документації за посиланням Aspose.Cells Cloud SDK for Node.js Documentation та до довідки API за посиланням Aspose.Cells API Reference.

Read More