Konvertering af CSV data til en moderne XLSX projektmappe er et hyppigt krav for Node.JS‑applikationer, der skal generere Excel‑rapporter uden at være afhængige af Microsoft Excel selv. Aspose.HTML Cloud SDK for Node.JS leverer et kraftfuldt API, der håndterer konverteringen fuldstændigt i skyen. I denne vejledning vil du se et komplet kodeeksempel, lære hvordan du kalder REST‑API‑en med cURL, og forstå de nødvendige opsætnings‑trin for effektivt at køre CSV‑til‑Excel‑XLSX‑konvertering i Node.JS.
Komplet kodeeksempel: CSV til Excel XLSX‑konvertering i Node.JS
Dette eksempel demonstrerer, hvordan man konverterer en CSV‑fil til en XLSX‑arbejdsbog ved hjælp af Aspose.HTML Cloud SDK for Node.JS.
const fs = require('fs');
const path = require('path');
const {
HtmlApi,
Configuration,
UploadFileRequest,
DownloadFileRequest,
ConvertDocumentRequest,
DeleteFileRequest
} = require('@asposecloud/aspose-html-cloud');
// Replace with your actual Aspose Cloud credentials
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const htmlApi = new HtmlApi(config);
async function convertCsvToXlsx() {
const localCsvPath = path.resolve(__dirname, 'input.csv');
const localXlsxPath = path.resolve(__dirname, 'output.xlsx');
const remoteCsvPath = 'input.csv';
const remoteXlsxPath = 'output.xlsx';
try {
// Upload CSV using a read stream (efficient for large files)
const uploadStream = fs.createReadStream(localCsvPath);
await htmlApi.uploadFile(new UploadFileRequest({
path: remoteCsvPath,
file: uploadStream
}));
// Convert CSV to XLSX
await htmlApi.convertDocument(new ConvertDocumentRequest({
inputPath: remoteCsvPath,
outputPath: remoteXlsxPath,
format: 'xlsx'
}));
// Download the resulting XLSX file
const downloadResponse = await htmlApi.downloadFile(new DownloadFileRequest({
path: remoteXlsxPath
}));
const writeStream = fs.createWriteStream(localXlsxPath);
await new Promise((resolve, reject) => {
downloadResponse.body.pipe(writeStream);
downloadResponse.body.on('end', resolve);
downloadResponse.body.on('error', reject);
});
console.log('Conversion completed successfully.');
} catch (error) {
console.error('Error during conversion:', error);
} finally {
// Cleanup remote files
try {
await htmlApi.deleteFile(new DeleteFileRequest({ path: remoteCsvPath }));
await htmlApi.deleteFile(new DeleteFileRequest({ path: remoteXlsxPath }));
} catch (cleanupError) {
// Ignore cleanup errors
}
}
}
convertCsvToXlsx();
Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sørge for at opdatere filstierne (
input.csv,output.xlsx, osv.) så de matcher dine faktiske filplaceringer, verificere at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så se venligst den officielle dokumentation eller kontakt supportteamet for assistance.
CSV til XLSX‑konvertering med cURL og REST API
Hvis du foretrækker en direkte REST‑tilgang, kan den samme konvertering udføres med cURL‑kommandoer. Trinnene nedenfor viser, hvordan du får en adgangstoken, uploader CSV‑filen, udløser konverteringen og downloader XLSX‑filen.
# 1. Get an access token
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"
# 2. Upload the source CSV file
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/input.csv" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: text/csv" \
--data-binary @input.csv
# 3. Convert CSV to XLSX
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=xlsx&outPath=output.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"inputPath":"input.csv"}'
# 4. Download the generated XLSX file
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.xlsx
For mere detaljer om anmodningsparametre og yderligere muligheder, se den [officielle API‑dokumentation](https://reference.aspose.cloud/html/).
## Opdeling af CSV til Excel‑konvertering i Node.JS
At forstå, hvordan koden udfører CSV‑til‑Excel‑XLSX‑konvertering i Node.JS, hjælper dig med at tilpasse processen til dine egne projekter.
1. **Konfigurationsopsætning** – Klassen `Configuration` gemmer din `clientId` og `clientSecret`.
<!--[CODE_SNIPPET_START]-->
```javascript
const [config](https://docs.fileformat.com/programming/config/) = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
-
API‑initialisering –
HtmlApiinstantieres med konfigurationen for at få adgang til alle konverterings‑endpoints.const htmlApi = new HtmlApi(config); -
Upload af CSV – Et læsestrøm (
fs.createReadStream) uploader filen effektivt, hvilket er vigtigt for store CSV‑filer.const uploadStream = fs.createReadStream(localCsvPath); await htmlApi.uploadFile(new UploadFileRequest({ path: remoteCsvPath, file: uploadStream })); -
Udførelse af konverteringen –
convertDocumentkaldes medformat: 'xlsx'for at udføre CSV til Excel XLSX‑konverteringen.await htmlApi.convertDocument(new ConvertDocumentRequest({ inputPath: remoteCsvPath, outputPath: remoteXlsxPath, format: 'xlsx' })); -
Download af resultatet – SDK’en streamer den genererede XLSX tilbage til det lokale filsystem.
const downloadResponse = await htmlApi.downloadFile(new DownloadFileRequest({ path: remoteXlsxPath })); const writeStream = fs.createWriteStream(localXlsxPath); await new Promise((resolve, reject) => { downloadResponse.body.pipe(writeStream); downloadResponse.body.on('end', resolve); downloadResponse.body.on('error', reject); });
Disse trin illustrerer den komplette end‑to‑end‑proces for CSV‑til‑Excel‑XLSX‑konvertering i Node.JS ved brug af Aspose.HTML Cloud SDK.
Forudsætninger og opsætning - Installation af Aspose.HTML Cloud SDK for Node.JS
-
Node.js‑runtime – Sørg for, at du har Node.js 14 eller nyere installeret.
-
Installer SDK’en – Kør følgende npm‑kommando (download‑URL: https://releases.aspose.cloud/html/nodejs/).
npm install @asposecloud/aspose-html-cloud --save -
Konfigurer legitimationsoplysninger - Opret en
.asposecloud‑konfigurationsfil eller indstil miljøvariabler med dinclientIdogclientSecret, som du får fra Aspose Cloud‑dashboardet. -
Bekræft installationen - Kør
node -e "require('@asposecloud/aspose-html-cloud')"for at bekræfte, at pakken indlæses uden fejl.
Med SDK’en installeret og legitimationsoplysningerne konfigureret, er du klar til at køre konverteringskoden.
Konklusion
Denne vejledning har guidet dig gennem CSV‑til‑Excel‑XLSX‑konvertering i Node.JS ved brug af Aspose.HTML Cloud SDK for Node.JS. Du har set et komplet fungerende eksempel, lært hvordan du udfører den samme opgave med cURL, og sat SDK’en op på din udviklingsmaskine. Biblioteket fjerner behovet for Microsoft Excel på serveren, hvilket gør stor‑skala rapportgenerering letvægts og pålidelig. Til produktionsbrug skal du erhverve en kommerciel licens eller bruge en midlertidig licens fra midlertidig licens‑side for at overholde betingelserne.
Ofte stillede spørgsmål
-
Hvilke filformater understøttes for konvertering udover CSV og XLSX?
Aspose.HTML understøtter et bredt udvalg af formater, herunder HTML, PDF, DOCX, og PPTX. Se produktdokumentationen for den komplette liste. -
Hvordan kan jeg konvertere flere CSV‑filer i én kørsel?
Loop gennem din filliste, og kald upload‑, konverter‑ og download‑trinnene for hver fil. SDK’ens streaming‑tilgang fungerer godt til batch‑behandling. -
Er det muligt at tilpasse Excel‑outputtet (f.eks. kolonnebredder, stilarter)?
Den grundlæggende konvertering opretter en standard‑projektmappe. For avanceret formatering kan du efterbehandle XLSX‑filen med Aspose.Cells Cloud efter konverteringen. -
Hvor kan jeg finde prisoplysninger for Aspose.HTML Cloud SDK?
Prisinformation findes på Aspose‑webstedet. Du kan også starte med en midlertidig licens til evaluering, før du køber et fuldt abonnement.