Преобразование данных таблицы в обычный текст часто требуется, когда нужно передать информацию в устаревшие системы или простые парсеры. Aspose.Cells Cloud SDK for Node.js предоставляет мощную библиотеку, которая выполняет большую часть работы на стороне сервера. В этом руководстве вы увидите полностью рабочий пример, процесс cURL для REST API, шаги установки, параметры конфигурации и рекомендации лучших практик, чтобы преобразовать CSV в TXT в Node.JS без проблем и надёжно.
Полный рабочий пример преобразования CSV в TXT в Node.JS
Этот пример демонстрирует, как вызвать API Cells и сохранить преобразованный файл 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
Код работает в несколько логических шагов:
- Инициализировать клиент API –
new ApiClient()настроен с вашими учётными данными и базовым URL.
const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';
- Создайте экземпляр CellsApi - этот объект предоставляет метод конвертации.
const cellsApi = new CellsApi(config);
- Прочитать CSV‑файл как поток -
fs.createReadStreamпредоставляет двоичные данные, необходимые API.
const fileStream = fs.createReadStream(inputFile);
- Создайте объект запроса - свойство
formatуказывает сервису выводить TXT.
const request = {
file: fileStream,
format: 'txt'
};
- Вызов
postConvertWorkbook- API возвращает Buffer, содержащий преобразованный текст, который затем записывается на диск.const response = await cellsApi.postConvertWorkbook(request); fs.writeFileSync(outputFile, response.body);
Понимание каждой части помогает настроить поток, например, добавить обработку ошибок или обработку нескольких файлов.
Подготовка среды
- Установите SDK с помощью npm:
npm install asposecellscloud
-
Убедитесь, что у вас установлен Node.js 14 или более поздняя версия.
-
Скачайте последнюю версию пакета с официальной страницы релизов, если вы предпочитаете ручную установку: Aspose.Cells Cloud SDK for Node.js Скачать.
-
Создайте бесплатный аккаунт Aspose Cloud, чтобы получить ваш client ID и client secret.
После выполнения этих предварительных условий вы можете сразу запустить скрипт конвертации.
Преобразование CSV в TXT с помощью cURL и REST API
Вы можете достичь того же результата, не пиша ни одной строки кода, вызывая напрямую REST‑конечные точки Aspose.Cells Cloud.
- Получить токен доступа - обменяйте свои клиентские учетные данные на 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"
- Загрузите исходный 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
- Запросить конвертацию в формат 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"
- Скачайте полученный файл 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 Reference.
Настройки конвертации: варианты и параметры
В примере используются только два параметра, но API поддерживает дополнительные настройки:
format– указывает тип целевого файла. В нашем случае он установлен в'txt'. Изменение этого значения позволяет экспортировать в другие поддерживаемые сервисом форматы простого текста.file– поток, представляющий исходный CSV. Вы можете заменить поток на Buffer или строку base64, если это соответствует вашей архитектуре.
Для полного списка поддерживаемых параметров обратитесь к странице API Reference для postConvertWorkbook.
Практические советы по экспорту CSV в TXT
- Проверьте входные файлы перед отправкой их в API, чтобы избежать неожиданных ошибок конвертации.
- Повторно используйте клиент API при нескольких конверсиях, чтобы снизить нагрузку на аутентификацию.
- Передавайте большие CSV‑файлы потоково вместо загрузки их полностью в память;
fs.createReadStreamуже делает это. - Обрабатывайте Buffer ответа с правильной кодировкой (
utf8), если необходимо манипулировать текстом после конвертации. - Обеспечьте безопасность учетных данных, сохраняя
clientIdиclientSecretв переменных окружения или менеджере секретов.
Соблюдение этих практик позволит вашему приложению работать эффективно и безопасно.
Заключение
Преобразование CSV в TXT в Node.JS становится простым с помощью Aspose.Cells Cloud SDK for Node.js. Библиотека абстрагирует детали низкого уровня, позволяя сосредоточиться на бизнес‑логике, обеспечивая надёжные результаты. Не забудьте получить действующую лицензию для использования в продакшене; вы можете приобрести подписку или получить временную лицензию со страницы временной лицензии. С образцом кода, cURL‑рабочим процессом и рекомендациями по лучшим практикам в этой статье вы готовы интегрировать экспорт CSV в TXT в любое решение на Node.JS.
Часто задаваемые вопросы
Как выполнить преобразование CSV в TXT в Node.JS с использованием Aspose.Cells Cloud?
Используйте Aspose.Cells Cloud SDK for 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.