Pour commencer

Description du produit

Aspose.Cells for JavaScript via C++ est une bibliothèque haute performance et riche en fonctionnalités pour manipuler et convertir des fichiers de feuilles de calcul, y compris Excel (XLS, XLSX, XLSB, XLSM), ODS, CSV et formats HTML. Elle offre un ensemble complet de fonctionnalités pour créer, modifier, convertir et rendre des feuilles de calcul dans les environnements navigateur et Node.js. Avec la prise en charge complète de tous les principaux formats Excel, Aspose.Cells for JavaScript via C++ assure une compatibilité et une flexibilité maximales pour divers cas d’utilisation. Construit avec WebAssembly pour permettre des performances proches de celles natives directement dans le navigateur, Aspose.Cells for JavaScript via C++ permet un traitement rapide et efficace des feuilles de calcul sans besoin de serveur. Son empreinte légère en runtime le rend parfait pour les applications web sans serveur nécessitant des fonctionnalités avancées d’Excel. Que vous construisiez des tableaux de bord, des pipelines de traitement de données ou des outils de génération de documents, Aspose.Cells for JavaScript via C++ offre une solution complète, fiable et haute performance. Aspose.Cells for JavaScript via C++ supporte les navigateurs et Node.js, principalement les navigateurs.

Fonctionnalités clés

  1. Création et modification de fichiers : Créer de nouvelles feuilles de calcul à partir de zéro ou modifier celles existantes facilement. Cela inclut l’ajout ou la modification de données, la mise en forme des cellules, la gestion des feuilles, et plus encore.
  2. Traitement des données : Effectuer des manipulations complexes de données telles que le tri, le filtrage et la validation. La bibliothèque supporte également des formules et fonctions avancées pour faciliter l’analyse et les calculs de données.
  3. Conversion de fichiers : Convertir des fichiers Excel en divers formats tels que PDF, HTML, ODS et formats d’image comme PNG et JPEG. Cette fonctionnalité est utile pour partager et distribuer des données de feuilles de calcul sous différents formats.
  4. Graphiques et visualisations : Créer et personnaliser une large gamme de graphiques pour représenter visuellement les données. La bibliothèque supporte les graphiques à barres, lignes, camemberts, et bien d’autres, avec des options de personnalisation pour le design et la mise en page.
  5. Rendu et impression : Rendre les feuilles Excel en images haute fidélité et PDFs, en garantissant une représentation visuelle précise. La bibliothèque offre également des options pour imprimer les feuilles avec un contrôle précis sur la mise en page et la mise en forme.
  6. Protection avancée et sécurité : Protéger les feuilles avec des mots de passe, chiffrer les fichiers, et gérer les permissions d’accès pour assurer la sécurité et l’intégrité des données.
  7. Performance et évolutivité : Conçu pour gérer efficacement de grands ensembles de données et des feuilles de calcul complexes, Aspose.Cells for JavaScript via C++ garantit une haute performance et une évolutivité pour des applications d’entreprise.

Prérequis

Avant de commencer, assurez-vous d’avoir :

  • Node.js installé sur votre système (Télécharger à partir de https://nodejs.org/)
  • Un fichier de licence Aspose valide (par exemple, Aspose.Total.lic, Aspose.Cells.lic, ou aspose.cells.js.lic) pour une utilisation complète
  • Connaissances de base en HTML et JavaScript

Étape 1 : Installation

Installer Aspose.Cells for JavaScript

Créer un nouveau répertoire de projet et installer le package :

# Create a new project directory
mkdir my-excel-project
cd my-excel-project

# Install Aspose.Cells for JavaScript
npm install aspose.cells.js

Installer le serveur HTTP (obligatoire pour la configuration de la licence)

Installer un serveur HTTP simple globalement :

npm install -g http-server

Ou utiliser le serveur intégré de Python (si Python est installé) :

# Python 3
python -m http.server

# Python 2
python -m SimpleHTTPServer

Étape 2 : Configuration de la licence (obligatoire pour les fonctionnalités complètes)

Chiffrez votre fichier de licence

  1. Démarrez le serveur HTTP dans votre répertoire de projet :

       http-server -p 8080
       

  2. Ouvrez l’outil de chiffrement de licence dans votre navigateur :

    http://localhost:8080/node_modules/aspose.cells.js/encrypt_lic.html
    
  3. Téléversez votre fichier de licence :

    • Cliquez sur “Choisir un fichier” et sélectionnez votre fichier de licence (par ex., Aspose.Total.lic, Aspose.Cells.lic, ou aspose.cells.js.lic)
    • Le processus de chiffrement se terminera automatiquement (très rapide)
  4. Téléchargez la licence chiffrée :

    • Cliquez sur “Télécharger le fichier traité” pour télécharger aspose.cells.enc
    • Enregistrez ce fichier dans votre répertoire de projet

Placer la licence chiffrée

Déplacez le fichier aspose.cells.enc vers la racine de votre projet ou dans un dossier spécifique accessible par votre application.

Étape 3 : Exemples d’utilisation

Utilisation du navigateur

Créez un fichier index.html dans votre répertoire de projet :

<!DOCTYPE html>
<html>
<head>
    <title>Aspose.Cells Browser Example</title>
</head>
<body>
    <h1>Excel Processing with Aspose.Cells</h1>
    <button id="createExcel">Create Excel File</button>
    <div id="output"></div>

    <script src="./node_modules/aspose.cells.js/aspose.cells.js.min.js"></script>
    <script type="text/javascript">
        const { Workbook, FileFormatType, SaveFormat } = AsposeCells;

        // Initialize with license (optional, remove for trial mode)
        AsposeCells.onReady({
            license: "aspose.cells.enc"  // Path to your encrypted license
        }).then(() => {
            console.log("Aspose.Cells is ready!");

            document.getElementById('createExcel').onclick = function() {
                // Create a new workbook
                var workbook = new Workbook(FileFormatType.Xlsx);

                // Get the first worksheet
                var worksheet = workbook.worksheets.get(0);

                // Add some data
                worksheet.cells.get("A1").putValue("Hello World");
                worksheet.cells.get("A2").putValue("Created with Aspose.Cells for JavaScript");
                worksheet.cells.get("B1").putValue(42);

                // Save as Excel file
                const outputData = workbook.save(SaveFormat.Xlsx);

                // Create download link
                const blob = new Blob([outputData]);
                const downloadLink = document.createElement('a');
                downloadLink.href = URL.createObjectURL(blob);
                downloadLink.textContent = 'Download Excel File';
                downloadLink.download = "my-excel-file.xlsx";
                downloadLink.style.display = 'block';

                const output = document.getElementById('output');
                output.innerHTML = '';
                output.appendChild(downloadLink);
            };
        }).catch(error => {
            console.error("Error initializing Aspose.Cells:", error);
        });
    </script>
</html>

Pour exécuter l’exemple du navigateur :

# Start HTTP server
http-server -p 8080

# Open browser and visit:
# http://localhost:8080

Utilisation de Node.js

Créez un fichier node-example.js :

const { AsposeCells, Workbook, SaveFormat, FileFormatType } = require("aspose.cells.js");
const fs = require('fs');

// Initialize Aspose.Cells with license
AsposeCells.onReady({
    license: "aspose.cells.enc",  // Path to your encrypted license
    fontPath: "./fonts/"         // Optional: path to system fonts
}).then(() => {
    console.log("Aspose.Cells initialized successfully!");

    // Create a new workbook
    const workbook = new Workbook(FileFormatType.Xlsx);

    // Get the first worksheet
    const worksheet = workbook.worksheets.get(0);

    // Add data to cells
    worksheet.cells.get("A1").putValue("Product");
    worksheet.cells.get("B1").putValue("Price");
    worksheet.cells.get("A2").putValue("Apple");
    worksheet.cells.get("B2").putValue(1.99);
    worksheet.cells.get("A3").putValue("Orange");
    worksheet.cells.get("B3").putValue(2.49);

    // Save as Excel file
    const excelData = workbook.save(SaveFormat.Xlsx);
    fs.writeFileSync('output.xlsx', Buffer.from(excelData));
    console.log('Excel file saved as output.xlsx');

    // Save as PDF
    const pdfData = workbook.save(SaveFormat.Pdf);
    fs.writeFileSync('output.pdf', Buffer.from(pdfData));
    console.log('PDF file saved as output.pdf');

}).catch(error => {
    console.error("Error:", error);
});

Pour exécuter l’exemple Node.js :

node node-example.js

Opérations courantes sur les fichiers

Lecture d’un fichier Excel existant

// Browser (using File input)
const fileInput = document.getElementById('fileInput');
fileInput.addEventListener('change', (e) => {
    const file = e.target.files[0];
    const reader = new FileReader();
    reader.onload = (e) => {
        const arrayBuffer = e.target.result;
        const workbook = new Workbook(new Uint8Array(arrayBuffer));
        // Process the workbook...
    };
    reader.readAsArrayBuffer(file);
});

// Node.js
const fs = require('fs');
const fileBuffer = fs.readFileSync('input.xlsx');
const workbook = new Workbook(fileBuffer);

Conversion entre formats

// Convert Excel to PDF
const pdfData = workbook.save(SaveFormat.Pdf);

// Convert Excel to HTML
const htmlData = workbook.save(SaveFormat.Html);

// Convert Excel to CSV
const csvData = workbook.save(SaveFormat.Csv);

// Convert Excel to JSON
const jsonData = workbook.save(SaveFormat.Json);

Dépannage

Problèmes courants et solutions

  1. Erreur “Module non trouvé”

    • Assurez-vous que vous exécutez le serveur HTTP depuis le bon répertoire
    • Vérifiez que le chemin src du script pointe vers le bon emplacement
  2. Licence non fonctionnelle

    • Assurez-vous que le fichier aspose.cells.enc est à la bonne place
    • Vérifiez que le fichier de licence chiffré a été généré correctement
    • Vérifiez que le fichier de licence original est valide et non expiré
  3. Problèmes CORS dans le navigateur

    • Utilisez toujours un serveur HTTP, ne jamais ouvrir directement les fichiers HTML
    • Utilisez http-server ou des outils similaires pour le développement local

Obtenir de l’aide

Si vous rencontrez des problèmes :

Étapes suivantes

  • Explorez la référence API pour une documentation détaillée
  • Découvrez les fonctionnalités avancées telles que les graphiques, les formules et la mise en forme
  • Consultez plus d’exemples et de tutoriels dans la documentation
  • Envisagez l’intégration à vos applications web existantes ou outils de build