Excel-ის მონაცემების გადაყვანა CSV ფორმატში ხშირად საჭიროა მონაცემთა ნაკადების, ანგარიშის ინსტრუმენტების ან იმპორტ/ექსპორტ ფუნქციების შექმნისას. Aspose.BarCode Cloud SDK for Node.js ძლიერი ბიბლიოთეკა გთავაზობთ, რომელიც აძლიერებს XLS ფორმატის CSV-ში გადაყვანას Node.JS-ში მარტივად და საიმედოდ. ეს გიდი თქვენთვის აჩვენებს წინაპირობებს, ინსტალაციის ნაბიჯებს, სრულად მუშაობს მაგალითს და საუკეთესო პრაქტიკის რჩევებს, რათა შეძლოთ გადაყვანის ინტეგრირება თქვენს აპლიკაციაში ნდობით.

სრული მუშაობის მაგალითი XLS‑დან CSV გარდაქმნისთვის Node.JS-ში Aspose.BarCode-ის გამოყენებით

ეს მაგალითი აჩვენებს, როგორ წაიკითხოთ XLS სამუშაო წიგნი ღრუბლოვან შენახვიდან, როგორ გარდაქმნათ თითოეული სამუშაო ფურცელი CSV ფორმატში და როგორ გადაიტანოთ შედეგი კლიენტზე.

// Full working code for XLS to CSV conversion using Aspose.BarCode Cloud SDK

const { BarcodeApi, Configuration } = require('aspose-barcode-cloud');
const fs = require('fs');
const path = require('path');

// ==== Configuration ====
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET",
    // Optional: set a custom base URL if you use a private cloud
    // baseUrl: "https://api.aspose.cloud"
});

const apiInstance = new BarcodeApi(config);

// ==== Input / Output Paths ====
const inputFile = "sample.xls";               // Path to your local XLS file
const outputFolder = "output";                // Cloud folder for CSV files

// ---- 1. Upload XLS to cloud storage ----
async function uploadFile() {
    const fileData = fs.readFileSync(inputFile);
    await apiInstance.uploadFile({ path: inputFile, file: fileData });
    console.log(`Uploaded ${inputFile} to cloud storage.`);
}

// ---- 2. Convert XLS to CSV ----
async function convertXlsToCsv() {
    // Conversion options
    const options = {
        storage: "Default",               // Use default storage
        outPath: outputFolder,            // Destination folder
        format: "CSV",                    // Target format
        // Optional: delimiter, encoding, etc.
        delimiter: ",",
        encoding: "UTF-8"
    };

// Call the conversion endpoint (hypothetical method)
    const response = await apiInstance.convertDocument({
        name: inputFile,
        format: "csv",
        options: options
    });

console.log(`Conversion started. Check ${outputFolder} for CSV files.`);
    return response;
}

// ---- 3. Download generated CSV files ----
async function downloadCsvFiles() {
    const files = await apiInstance.getFilesList({ path: outputFolder });
    for (const file of files.value) {
        if (file.name.endsWith(".csv")) {
            const csvData = await apiInstance.downloadFile({ path: `${outputFolder}/${file.name}` });
            const localPath = path.join(__dirname, "result", file.name);
            fs.mkdirSync(path.dirname(localPath), { recursive: true });
            fs.writeFileSync(localPath, csvData.body);
            console.log(`Downloaded ${file.name} to ${localPath}`);
        }
    }
}

// ==== Execution Flow ====
(async () => {
    try {
        await uploadFile();
        await convertXlsToCsv();
        await downloadCsvFiles();
        console.log("XLS to CSV conversion completed successfully.");
    } catch (error) {
        console.error("Error during conversion:", error);
    }
})();

შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითად ფუნქციას. პროექტში მისი გამოყენებამდე, დარწმუნდით, რომ განაახლეთ ფაილთა გზები (sample.xls, output), გადამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაყენებულია, და სრულად დატესტეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემის შეგხვდებათ, გთხოვთ მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.

XLS-დან CSV-ში გადაყვანა Cloud API-ის საშუალებით cURL-ით

თქვენ შეგიძლიათ იგივე გადაყვანა შესრულოთ კოდი არ დაწერით, cURL-ის გამოყენებით REST-эндპოინტებზე გამოძახებით. პროცესი შედგება აუტენთიფიკაციით, ფაილის ატვირთვით, გადაყვანის მოთხოვნით და გადმოწერით.

# 1. Get an access token
curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
     -H "Content-Type: application/x-www-form-urlencoded"
# Response contains "access_token"

# 2. Upload the XLS file
curl -X PUT "https://api.aspose.cloud/v3.0/barcode/storage/file/sample.xls" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.xls"

# 3. Request XLS to CSV conversion
curl -X POST "https://api.aspose.cloud/v3.0/barcode/convert/sample.xls?format=csv&outPath=output" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Download the generated CSV file
curl -X GET "https://api.aspose.cloud/v3.0/barcode/storage/file/output/sample.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -o "sample.csv"

მოთხოვნის პარამეტრების შესახებ მეტი დეტალებისთვის, იხილეთ ოფიციალური API დოკუმენტაცია.

როგორ მუშაობს XLS-დან CSV-ით კონვერსია Node.JS-ში

  1. კონფიგურაციის დაყენება - Configuration ობიექტი შეიცავს თქვენი კლიენტის ავტორიზაციის დეტალებს და არასავალდებულო ბაზის URL-ს. ეს ობიექტი გადაეცემა BarcodeApi ინსტანსს. 
    const config = new Configuration({ clientId, clientSecret });
const apiInstance = new BarcodeApi(config);
  2. ფაილის ატვირთვა - uploadFile მეთოდი ატვირთავს ლოკალურ XLS ფაილს Aspose.BarCode ღრუბლოვან შენახვაში, რაც მას ხელმისაწვდომს აკეთებს კონვერსიისთვის. 
    await apiInstance.uploadFile({ path: inputFile, file: fileData });
  3. კონვერსიის გამოძახება - convertDocument (ჰიპოთეტიკური) აგზავნის მოთხოვნას წყაროს ფაილის სახელით, სამიზნე ფორმატით (csv) და კონვერსიის პარამეტრებით, როგორიცაა გამყოფი და კოდირება. სერვისი პროცესირავს თითოეულ სამუშაო ფურცელს და ქმნის შესაბამის CSV ფაილებს. 
    const response = await apiInstance.convertDocument({ name: inputFile, format: "csv", options });
  4. შედეგის მიღება - კონვერსიის შემდეგ, getFilesList აჩვენებს შექმნილ CSV ფაილებს გამოტანის საქაღალდეში. შემდეგ თითოეული ფაილი გადმოწერილია downloadFile მეთოდით და შენახულია ლოკალურად. 
    const files = await apiInstance.getFilesList({ path: outputFolder });
const csvData = await apiInstance.downloadFile({ path: csvPath });
  5. შეცდომების დამუშავება - API-ის ნებისმიერი შეცდომა იჭერება catch ბლოკში, სადაც შეგიძლიათ ლოგიროთ დეტალები ან განხორციელოთ თავიდან ცდის ლოგიკა. შეცდომის კოდების სრულ სიას იხილეთ API-ის დოკუმენტაცია.

გარემოს მომზადება - წინაპირობები და დაყენება

დაწყებამდე, დარწმუნდით, რომ შემდეგი წინაპირობები დაკმაყოფილებულია:

  • Node.js 14 ან უფრო მაღალი, თქვენს განვითარების მანქანაზე დაყენებული.
  • Aspose Cloud ანგარიში, რომელსაც აქვს სწორი კლიენტის凭证ები (Client ID და Client Secret).
  • ინტერნეტის წვდომა API მოთხოვნებისთვის.

დაყენეთ ბიბლიოთეკა npm-ის საშუალებით და დაამატეთ ჩამოტვირთვის გვერდის ბმული მიმართვისთვის:

npm install aspose-barcode-cloud
# Download package details: https://releases.aspose.cloud/barcode/nodejs/

დაყენების შემდეგ, შექმენით კონფიგურაციის ფაილი (მაგალითად, config.json), რათა უსაფრთხოდ შეინახოთ თქვენი ავტორიზაციის დეტალები.

გარდაქმნის პარამეტრები: არჩევანის ვარიანტები და პარამეტრები

გარდაქმნის API იღებს რამდენიმე არასავალდებულო პარამეტრს, რომელიც საშუალებას აძლევს თქვენ ზუსტად დააკონტროლოთ შედეგი:

  • delimiter - აირჩიეთ სიმბოლო, რომელიც გამოყოფს ველებს (ნაგულისხმევია ,).
options.delimiter = "\t"; // Tab‑delimited CSV
  • encoding - განსაზღვრეთ სიმბოლოების კოდირება CSV ფაილისთვის (მაგალითად, UTF-8, ISO-8859-1).
options.encoding = "UTF-8";
  • outPath - მიუთითეთ ღრუბლოვანი საქაღალდე, სადაც CSV ფაილები ინახება.
options.outPath = "converted";
  • storage - აირჩიეთ შენახვის სახელი, თუ იყენებთ მომხმარებლის შენახვის სერვისს.
options.storage = "MyCustomStorage";

მხარდაჭერილი პარამეტრების სრულ სიისთვის, იხილეთ API მითითება.

XLS-დან CSV-ში ეფექტური გადაყვანის პრაქტიკული რჩევები

  • დიდი ფაილების ნაკადი - ჩართეთ ნაკადის რეჟიმი, რომ რიგები დამუშავდეს ბლოკებად და თავიდან აიცილოთ მაღალი მეხსიერების მოხმარება.
  • დროებით საქაღალდე გამოიყენეთ - დაწერეთ შუა CSV ფაილები სპეციალურ ღრუბლოვან საქაღალდეში და მას შემდეგ, რაც გადმოწერეთ, გაასუფთავეთ.
  • დაყენეთ შესაბამისი გამყოფი - თუ თქვენს მონაცემებში არსებობს მძიმეები, გადაერთეთ ტაბულაციის ან ღრუბლოვანი (|) გამყოფზე, რათა თავიდან აიცილოთ სვეტების არასწორი სწორება.
  • გადმოწერის შემდეგ გადამოწმება - შეამოწმეთ CSV-ის პირველი რამდენიმე რიგი, რომ დარწმუნდეთ სწორ კოდირებაში და გამყოფის გამოყენებაში, სანამ გაგრძელებთ დამუშავებას.

დასკვნა

XLS‑დან CSV-მდე კონვერტირება Node.JS-ში ხდება მარტივი, როდესაც იყენებთ Aspose.BarCode Cloud SDK for Node.js-ის შესაძლებლობებს. ეს გიდი მოიცავს ყველაფერს გარემოს დაყენებიდან და სრულ სამუშაო მაგალითიდან კონფიგურაციის პარამეტრებსა და წარმადობას ორიენტირებულ საუკეთესო პრაქტიკებზე. გახსოვდეთ, რომ დაიცავით თქვენი კლიენტის ავტორიზაციის დეტალები, აირჩიოთ სტრიმინგის გამოყენება დიდი სამუშაო წიგნებისათვის, და გაასუფთავეთ დროებით ფაილები, რათა თქვენი ღრუბლოვანი საცავი იყოს სუფთა. წარმოების განთავსებისთვის თქვენ გჭირდებათ გადახდილი ლიცენზია; შეგიძლიათ გადახედოთ ფასებს პროდუქტის გვერდზე და მიიღოთ დროებითი შეფასების ლიცენზია დროებითი ლიცენზიის გვერდიდან.

ხშირად დასმული კითხვები

XLS-დან CSV-ზე გადაყვანა Node.JS-ში როგორ მუშაობს მრავალ ფურცლზე?
ბიბლიოთეკა თითოეული ფურცელი თანმიმდევრულად აეკრიბება, თითოეულ ფურცელზე ცალკეული CSV ფაილი ქმნის. თუ საჭიროა ერთი CSV, შეგიძლიათ მოგვიანებით შეაერთოთ. მიმართეთ Aspose.BarCode Cloud SDK for Node.js დეტალურ გამოყენებისთვის.

მიძლია დიდი XLS ფაილების ნაკადი CSV ფორმატში, მთლიან სამუშაო წიგნაკის მეხსიერებაში ჩატვირთვის გარეშე?
დიახ. კონვერსიის პარამეტრებში ნაკადის არჩევის ჩართვით API იყენებს რიგებს მართვადი ბლოკებით, რაც მეხსიერების მოხმარება ნაკლებად და წარმადობა მაღალია.

Node.js‑ისთვის Aspose.BarCode Cloud SDK‑ის გამოყენებისას რა ლიცენზია საჭიროა წარმოებაში?
წარმოების გამოყენებისთვის კომერციული ლიცენზია საჭიროა. შეძენის არჩევანები ჩამოთვლილია პროდუქტის ფასის გვერდზე, და თქვენ შეგიძლიათ დროებით შეფასების ლიცენზია მოითხოვოთ დროებითი ლიცენზიის გვერდიდან

შეიძლება თუ არა CSV დელიმიტერის მორგება კონვერტაციის დროს?
აბსოლუტურად. დააყენეთ delimiter პარამეტრი კონვერტაციის პარამეტრებში ნებისმიერი სიმბოლოზე, რომელიც გჭირდებათ, მაგალითად, ტაბულაციაზე (\t) ან პიპზე (|). ეს უზრუნველყოფს, რომ გენერირებული CSV შეესაბამება თქვენი ქვედა პროცესის მოთხოვნებს.

მეტი