Converter dados de planilha para texto simples é uma necessidade frequente quando você deseja alimentar informações em sistemas legados ou analisadores simples. Aspose.Cells Cloud SDK for Node.js fornece uma biblioteca poderosa que lida com o processamento pesado no lado do servidor. Neste guia você verá um exemplo completo em funcionamento, um fluxo de trabalho cURL para a API REST, etapas de instalação, opções de configuração e dicas de boas práticas para tornar a conversão de CSV para TXT em Node.JS fácil e confiável.

Exemplo completo e funcional de CSV para TXT em Node.JS

Este exemplo demonstra como chamar a API do Cells e salvar o arquivo TXT convertido localmente.

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

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivos e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Dividindo CSV em TXT no Node.JS

O código funciona em algumas etapas lógicas:

  1. Inicializar o cliente da API - new ApiClient() é configurado com suas credenciais e a URL base.
const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';
  1. Crie uma instância do CellsApi - este objeto expõe o método de conversão.
const cellsApi = new CellsApi(config);
  1. Leia o arquivo CSV como um fluxo - fs.createReadStream fornece os dados binários necessários para a API.
const fileStream = fs.createReadStream(inputFile);
  1. Construa o objeto de requisição - a propriedade format informa ao serviço que a saída será TXT.
const request = {
    file: fileStream,
    format: 'txt'
};
  1. Chame postConvertWorkbook - a API retorna um Buffer contendo o texto convertido, que é então gravado no disco. 
    const response = await cellsApi.postConvertWorkbook(request);
fs.writeFileSync(outputFile, response.body);

Entender cada parte ajuda a personalizar o fluxo, como adicionar tratamento de erros ou processar vários arquivos.

Preparando o Ambiente

  1. Instale o SDK com npm:
npm install asposecellscloud

  1. Certifique‑se de que você tem o Node.js 14 ou posterior instalado.

  2. Baixe o pacote mais recente da página oficial de lançamentos se preferir uma instalação manual: Aspose.Cells Cloud SDK for Node.js Download.

  3. Crie uma conta gratuita do Aspose Cloud para obter seu client ID e client secret.

Com esses pré‑requisitos atendidos, você pode executar o script de conversão imediatamente.

Converter CSV para TXT usando cURL e a API REST

Você pode obter o mesmo resultado sem escrever nenhum código, chamando diretamente os endpoints REST do Aspose.Cells Cloud.

  1. Obter um token de acesso - troque suas credenciais de cliente por um 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. Carregue o arquivo CSV de origem para o armazenamento.
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. Solicite a conversão para o formato 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. Baixe o arquivo TXT resultante.
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.txt

Para mais detalhes sobre cada endpoint, veja a Aspose.Cells API Reference.

Configurações de Conversão: Opções e Parâmetros

O exemplo usa apenas dois parâmetros, mas a API suporta configurações adicionais:

  • format – especifica o tipo de arquivo de destino. No nosso caso, está definido como 'txt'. Alterar esse valor permite exportar para outros formatos de texto simples suportados pelo serviço.
  • file – um stream que representa o CSV de origem. Você pode substituir o stream por um Buffer ou uma string base64 se isso se adequar à sua arquitetura.

Para obter uma lista completa dos parâmetros suportados, consulte a página Referência da API para postConvertWorkbook.

Dicas Práticas para Exportação de CSV para TXT

  • Validar arquivos de entrada antes de enviá‑los para a API para evitar erros inesperados de conversão.
  • Reutilizar o cliente da API em várias conversões para reduzir a sobrecarga de autenticação.
  • Transmitir arquivos CSV grandes em vez de carregá‑los completamente na memória; fs.createReadStream já faz isso.
  • Manipular o Buffer de resposta com a codificação correta (utf8) se precisar manipular o texto após a conversão.
  • Proteger suas credenciais armazenando clientId e clientSecret em variáveis de ambiente ou em um gerenciador de segredos.

Seguir estas práticas manterá sua aplicação eficiente e segura.

Conclusão

Converter CSV para TXT em Node.JS torna‑se simples com o Aspose.Cells Cloud SDK for Node.js. A biblioteca abstrai os detalhes de baixo nível, permitindo que você se concentre na lógica de negócios enquanto entrega resultados confiáveis. Lembre‑se de adquirir uma licença válida para uso em produção; você pode comprar uma assinatura ou obter uma licença temporária na página de licença temporária. Com o exemplo de código, o fluxo de trabalho cURL e as orientações de boas práticas neste artigo, você está pronto para integrar a exportação de CSV para TXT em qualquer solução Node.JS.

Perguntas Frequentes

Como faço a conversão de CSV para TXT em Node.JS usando Aspose.Cells Cloud?
Use o Aspose.Cells Cloud SDK for Node.js para chamar o método postConvertWorkbook. Forneça o fluxo do arquivo CSV e defina o formato como 'txt'. Veja o exemplo completo de código acima.

Posso converter vários arquivos CSV para TXT em uma única solicitação?
A API processa um arquivo por solicitação. Percorra seus arquivos em Node.JS e chame o método de conversão para cada arquivo.

Qual autenticação é necessária para exportação de CSV para TXT no Node.JS?
Você precisa de um ID de cliente e um segredo de cliente da sua conta Aspose Cloud. O SDK troca‑os por um token de acesso automaticamente.

Onde posso encontrar mais detalhes sobre as opções de conversão?
Consulte a documentação oficial em Aspose.Cells Cloud SDK for Node.js Documentation e a referência da API em Aspose.Cells API Reference.

Leia Mais