La conversion des données d’une feuille de calcul en texte brut est un besoin fréquent lorsque vous devez alimenter des systèmes hérités ou des analyseurs simples. Aspose.Cells Cloud SDK for Node.js fournit une bibliothèque puissante qui gère le travail lourd côté serveur. Dans ce guide, vous verrez un exemple complet fonctionnel, un flux de travail cURL pour l’API REST, les étapes d’installation, les options de configuration et des conseils de bonnes pratiques pour transformer le CSV en TXT dans Node.JS de manière simple et fiable.

Exemple complet fonctionnel pour CSV vers TXT en Node.JS

Cet exemple montre comment appeler l’API Cells et enregistrer le fichier TXT converti localement.

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

Note : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Décomposer le CSV en TXT avec Node.JS

Le code fonctionne en quelques étapes logiques :

  1. Initialiser le client API - new ApiClient() est configuré avec vos identifiants et l’URL de base.
const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';
  1. Créer une instance de CellsApi - cet objet expose la méthode de conversion.
const cellsApi = new CellsApi(config);
  1. Lire le fichier CSV en tant que flux - fs.createReadStream fournit les données binaires requises par l’API.
const fileStream = fs.createReadStream(inputFile);
  1. Construire l’objet de requête - la propriété format indique au service de produire du TXT.
const request = {
    file: fileStream,
    format: 'txt'
};
  1. Appeler postConvertWorkbook - l’API renvoie un Buffer contenant le texte converti, qui est ensuite écrit sur le disque. 
    const response = await cellsApi.postConvertWorkbook(request);
fs.writeFileSync(outputFile, response.body);

Comprendre chaque élément vous aide à personnaliser le flux, par exemple en ajoutant la gestion des erreurs ou en traitant plusieurs fichiers.

Préparer l’environnement

  1. Installez le SDK avec npm:
npm install asposecellscloud

  1. Assurez‑vous d’avoir Node.js 14 ou une version ultérieure installée.

  2. Téléchargez le dernier package depuis la page officielle de publication si vous préférez une installation manuelle : Aspose.Cells Cloud SDK for Node.js Télécharger.

  3. Créez un compte Aspose Cloud gratuit pour obtenir votre client ID et client secret.

Une fois ces prérequis remplis, vous pouvez exécuter le script de conversion immédiatement.

Convertir CSV en TXT à l’aide de cURL et de l’API REST

Vous pouvez obtenir le même résultat sans écrire de code en appelant directement les points de terminaison REST d’Aspose.Cells Cloud.

  1. Obtenir un jeton d’accès - échangez vos informations d’identification client contre 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. Téléverser le fichier CSV source vers le stockage.
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. Demander la conversion au format 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. Télécharger le fichier TXT résultant
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.txt

Pour plus de détails sur chaque point de terminaison, consultez la Référence API Aspose.Cells.

Paramètres de conversion : Options et paramètres

L’exemple utilise uniquement deux paramètres, mais l’API prend en charge des paramètres supplémentaires :

  • format - spécifie le type de fichier cible. Dans notre cas, il est défini sur 'txt'. Modifier cette valeur vous permet d’exporter vers d’autres formats texte brut pris en charge par le service.
  • file - un flux représentant le CSV source. Vous pouvez remplacer le flux par un Buffer ou une chaîne base64 si cela correspond à votre architecture.

Pour obtenir la liste complète des paramètres pris en charge, consultez la page Référence de l’API pour postConvertWorkbook.

Conseils pratiques pour l’exportation CSV vers TXT

  • Valider les fichiers d’entrée avant de les envoyer à l’API afin d’éviter des erreurs de conversion inattendues.
  • Réutiliser le client API sur plusieurs conversions pour réduire la surcharge d’authentification.
  • Diffuser les gros fichiers CSV au lieu de les charger entièrement en mémoire ; fs.createReadStream le fait déjà.
  • Gérer le Buffer de réponse avec le bon encodage (utf8) si vous devez manipuler le texte après la conversion.
  • Sécuriser vos identifiants en stockant clientId et clientSecret dans des variables d’environnement ou un gestionnaire de secrets.

En suivant ces pratiques, votre application restera efficace et sécurisée.

Conclusion

Convertir CSV en TXT dans Node.JS devient simple avec le Aspose.Cells Cloud SDK for Node.js. La bibliothèque abstrait les détails de bas niveau, vous permettant de vous concentrer sur la logique métier tout en fournissant des résultats fiables. N’oubliez pas d’obtenir une licence valide pour une utilisation en production ; vous pouvez acheter un abonnement ou obtenir une licence temporaire depuis la page de licence temporaire. Avec l’exemple de code, le flux de travail cURL et les conseils de bonnes pratiques présentés dans cet article, vous êtes prêt à intégrer l’exportation CSV vers TXT dans n’importe quelle solution Node.JS.

FAQs

Comment effectuer une conversion CSV en TXT dans Node.JS en utilisant Aspose.Cells Cloud ?
Utilisez le SDK Aspose.Cells Cloud pour Node.js afin d’appeler la méthode postConvertWorkbook. Fournissez le flux du fichier CSV et définissez le format sur 'txt'. Voir l’exemple complet de code ci‑dessus.

Puis-je convertir plusieurs fichiers CSV en TXT en une seule requête ?
L’API traite un fichier par requête. Parcourez vos fichiers dans Node.JS et appelez la méthode de conversion pour chaque fichier.

Quel type d’authentification est requis pour l’exportation CSV vers TXT en Node.JS ?
Vous avez besoin d’un ID client et d’un secret client de votre compte Aspose Cloud. Le SDK les échange contre un jeton d’accès automatiquement.

Où puis‑je trouver plus de détails sur les options de conversion ?
Reportez‑vous à la documentation officielle à Aspose.Cells Cloud SDK for Node.js Documentation et à la référence API à Aspose.Cells API Reference.

En savoir plus