Convertire i dati di un foglio di calcolo in testo semplice è una necessità frequente quando si desidera fornire informazioni a sistemi legacy o a parser semplici. Aspose.Cells Cloud SDK for Node.js fornisce una libreria potente che gestisce il lavoro pesante sul lato server. In questa guida vedrai un esempio completo funzionante, un flusso di lavoro cURL per l’API REST, i passaggi di installazione, le opzioni di configurazione e consigli di best‑practice per trasformare CSV in TXT in Node.JS in modo semplice e affidabile.

Esempio completo funzionante di conversione da CSV a TXT in Node.JS

Questo esempio dimostra come chiamare l’API Cells e salvare localmente il file TXT convertito.

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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Scomporre CSV in TXT in Node.JS

Il codice funziona in pochi passaggi logici:

  1. Inizializza il client API - new ApiClient() è configurato con le tue credenziali e l’URL di base.
const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';
  1. Crea un’istanza di CellsApi - questo oggetto espone il metodo di conversione.
const cellsApi = new CellsApi(config);
  1. Leggi il file CSV come stream - fs.createReadStream fornisce i dati binari richiesti dall’API.
const fileStream = fs.createReadStream(inputFile);
  1. Crea l’oggetto request - la proprietà format indica al servizio di generare TXT.
const request = {
    file: fileStream,
    format: 'txt'
};
  1. Chiama postConvertWorkbook - l’API restituisce un Buffer contenente il testo convertito, che viene quindi scritto su disco. 
    const response = await cellsApi.postConvertWorkbook(request);
fs.writeFileSync(outputFile, response.body);

Comprendere ogni componente ti aiuta a personalizzare il flusso, ad esempio aggiungendo la gestione degli errori o elaborando più file.

Preparare l’ambiente

  1. Installa l’SDK con npm:
npm install asposecellscloud

  1. Assicurati di avere Node.js 14 o versioni successive installate.

  2. Scarica il pacchetto più recente dalla pagina di rilascio ufficiale se preferisci un’installazione manuale: Aspose.Cells Cloud SDK for Node.js Download.

  3. Crea un account gratuito Aspose Cloud per ottenere il tuo client ID e client secret.

Con questi prerequisiti soddisfatti, è possibile eseguire immediatamente lo script di conversione.

Converti CSV in TXT usando cURL e l’API REST

Puoi ottenere lo stesso risultato senza scrivere alcun codice chiamando direttamente gli endpoint REST di Aspose.Cells Cloud.

  1. Ottieni un token di accesso - scambia le tue credenziali client per un 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. Carica il file CSV di origine nel deposito.
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. Richiedi la conversione al 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. Scarica il file TXT risultante
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.txt

Per ulteriori dettagli su ciascun endpoint, consulta il Aspose.Cells Riferimento API.

Impostazioni di conversione: opzioni e parametri

L’esempio utilizza solo due parametri, ma l’API supporta impostazioni aggiuntive:

  • format - specifica il tipo di file di destinazione. Nel nostro caso è impostato su 'txt'. Modificando questo valore è possibile esportare in altri formati di testo semplice supportati dal servizio.
  • file - uno stream che rappresenta il CSV di origine. È possibile sostituire lo stream con un Buffer o una stringa base64 se ciò si adatta alla tua architettura.

Per un elenco completo dei parametri supportati, fare riferimento alla pagina Riferimento API per postConvertWorkbook.

Suggerimenti pratici per l’esportazione da CSV a TXT

  • Convalida i file di input prima di inviarli all’API per evitare errori di conversione imprevisti.
  • Riutilizza il client API in più conversioni per ridurre il sovraccarico di autenticazione.
  • Esegui lo streaming di grandi file CSV invece di caricarli interamente in memoria; fs.createReadStream lo fa già.
  • Gestisci il Buffer di risposta con la codifica corretta (utf8) se devi manipolare il testo dopo la conversione.
  • Proteggi le tue credenziali memorizzando clientId e clientSecret in variabili d’ambiente o in un gestore di segreti.

Seguendo queste pratiche manterrai la tua applicazione efficiente e sicura.

Conclusione

La conversione da CSV a TXT in Node.JS diventa semplice con l’Aspose.Cells Cloud SDK for Node.js. La libreria astrae i dettagli di basso livello, consentendoti di concentrarti sulla logica di business garantendo risultati affidabili. Ricorda di acquisire una licenza valida per l’uso in produzione; puoi acquistare un abbonamento o ottenere una licenza temporanea dalla pagina della licenza temporanea. Con il campione di codice, il flusso di lavoro cURL e le linee guida di best‑practice in questo articolo, sei pronto a integrare l’esportazione da CSV a TXT in qualsiasi soluzione Node.JS.

FAQs

Come posso eseguire la conversione da CSV a TXT in Node.JS usando Aspose.Cells Cloud?
Usa l’SDK Aspose.Cells Cloud per Node.js per chiamare il metodo postConvertWorkbook. Fornisci lo stream del file CSV e imposta il formato su 'txt'. Vedi l’esempio di codice completo sopra.

Posso convertire più file CSV in TXT in una singola richiesta?
L’API elabora un file per richiesta. Scorri i tuoi file in Node.JS e chiama il metodo di conversione per ciascun file.

Qual è l’autenticazione richiesta per l’esportazione da CSV a TXT in Node.JS?
È necessario un client ID e un client secret dal tuo account Aspose Cloud. L’SDK li scambia automaticamente per un token di accesso.

Dove posso trovare maggiori dettagli sulle opzioni di conversione?
Fare riferimento alla documentazione ufficiale su Aspose.Cells Cloud SDK for Node.js Documentation e al riferimento API su Aspose.Cells API Reference.

Read More