JSON‑დან Excel‑ის ცხრილებში მონაცემების გატანა ხშირად საჭიროებაა ანგარიშგებისთვის და მონაცემთა გაცვლისთვის თანამედროვე Node.JS აპლიკაციებში. Aspose.OCR Cloud SDK for Node.js უზრუნველყოფს ძლიერი API-ს, რომელიც შეუძლია პირდაპირ ღრუბელში ამ კონვერტაციას განახორციელოს. ამ გიდში თქვენ გაიცნობთ, როგორ გადაიტანოთ JSON‑ი XLSX ფორმატში Node.JS-ში async/await მოდელით და SDK‑ის convertDocument მეთოდით. ჩვენ გავითვალისწინებთ წინაპირობებს, დეტალურ კოდის გადახედვას, სრულ მაგალითს, ასევე cURL ალტერნატივას REST ინტეგრაციისთვის.
დასაწყისამდე: წინაპირობები და ინსტალაცია
ამ ტუტორიის შესასრულებლად თქვენ გჭირდებათ:
- Node.js 14 ან უფრო ახალი, რომელიც ლოკალურად დაყენებულია.
- Aspose Cloud ანგარიში, OCR API‑ით ჩართული.
- თქვენი Client Id და Client Secret Aspose Cloud დაფიდან.
- წვდომა ფაილურ სისტემაზე, სადაც JSON წყარო და XLSX გამომავალი ფაილები მდებარეობს.
SDK-ს დაყენება npm-ის საშუალებით:
npm install aspose-ocr-cloud
გადმოწერეთ უახლესი პაკეტი ოფიციალური გამოშვების გვერდიდან: Aspose.OCR Cloud SDK for Node.js გადმოწერა. ინსტალაციის შემდეგ, შეგიძლიათ დაიწყოთ კოდირება.
შემდეგი ნიმუში აჩვენებს, როგორ უნდა კონფიგურირება OCR კლიენტის თქვენი ავტორიზაციის დეტალებით:
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
კლიენტის მზადყოფნის შემდეგ, შემდეგი განყოფილებები აჩვენებს გადაყვანის სამუშაო ნაკადის ნაბიჯ‑ნაბიჯ.
ნაბიჯ-ნაბიჯ გიდი JSON-ის XLSX ფორმატში გადაყვანისთვის Node.JS-ში
ქვემოთ მოცემულია დეტალური ნაბიჯ‑ნაბიჯ მიმოხილვა თითოეული ოპერაციის, რომელიც საჭიროა JSON‑ის XLSX-ში გადაყვანისთვის Node.JS-ში.
ნაბიჯი 1: წყაროს დოკუმენტის ჩატვირთვა
ჯერ შექმენით წაკითხვის ნაკადი იმ JSON ფაილისთვის, რომელსაც გსურთ გადაყვანა.
const fs = require('fs');
const path = require('path');
const inputJsonPath = path.resolve(__dirname, 'input.json');
const jsonFileStream = fs.createReadStream(inputJsonPath);
ნაბიჯი 2: OCR API კლიენტის კონფიგურაცია
გამოიყენეთ ადრე ნაჩვენები კონფიგურაცია API ობიექტის შექმნისთვის.
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
ნაბიჯი 3: ConvertDocument მეთოდის გამოძახება
გამოძახეთ გადაყვანის endpoint, მიზნის ფორმატად მიუთითეთ xlsx.
const response = await ocrApi.convertDocument({
format: 'xlsx',
file: jsonFileStream
});
SDK ბინარული XLSX მონაცემებს აბრუნებს response.body-ში.
ნაბიჯი 4: XLSX გამოსავალის ფაილის დაწერა
ბინარული მონაცემები დისკზე ფაილში შენახვა.
const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);
ნაბიჯი 5: რესურსების გასუფთავება
დახურეთ ფაილის ნაკადი სისტემის რესურსების გათავისუფლებისთვის.
jsonFileStream.close();
ამ ნაბიჯებით თქვენ წარმატებით შესრულეთ JSON-ის XLSX ფორმატში გადაყვანა Node.JS ოპერაციაში, Aspose OCR Cloud library გამოყენებით.
JSON-დან XLSX-ის გადაყვანა Node.JS-ში - სრული კოდის მაგალითი
ქვემოთ მოცემული მაგალითი აჩვენებს JSON-ის XLSX-ში გადაყვანის სრულ განხორციელებას Node.JS-ში Aspose.OCR Cloud SDK-ის გამოყენებით.
const fs = require('fs');
const path = require('path');
const { OcrApi, Configuration } = require('asposeocrcloud');
(async () => {
// Configure Aspose OCR Cloud client
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
// Define input JSON and output XLSX paths
const inputJsonPath = path.resolve(__dirname, 'input.json');
const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
// Prepare file stream for the JSON file
const jsonFileStream = fs.createReadStream(inputJsonPath);
try {
// Convert JSON to XLSX using Aspose OCR Cloud SDK
const response = await ocrApi.convertDocument({
format: 'xlsx',
file: jsonFileStream
});
// Write the returned binary data to the XLSX file
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);
} catch (error) {
console.error('Conversion failed:', error);
} finally {
// Ensure the file stream is closed
jsonFileStream.close();
}
})();
შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითად ფუნქციონირებას. პროექტში მისი გამოყენებამდე, დარწმუნდით, რომ განაახლეთ ყველა ფაილის ბილიკი და კონფიგურაციის მნიშვნელობები თქვენი რეალური გარემოს შესაბამისად, გადაამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაინსტალირებულია, და სრულად ტესტირეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემას შეხვდებით, გთხოვთ მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.
cURL-ის მიდგომა JSON-ის XLSX ფორმატში გადაყვანისთვის Node.JS-ში
თუ თქვენ უპირატესია სუფთა REST გადაწყვეტა, იგივე კონვერსია შეიძლება შესრულდეს cURL ბრძანებებით. ეს მეთოდი ასევე იყენებს ძირითად ფრაზას convert JSON to XLSX in Node.JS.
- მიღეთ წვდომის ტოკენი
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"
- ატვირთეთ JSON ფაილი და მოთხოვეთ კონვერსია
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@input.json"
პასუხში შედის ბინარული XLSX პეილოდი.
- შენახეთ XLSX-გამოტანა ადგილობრივად
curl -X GET "https://api.aspose.cloud/v3.0/ocr/convert/result/output.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.xlsx
ეს ბრძანებები აჩვენებს, როგორ მივაღწიოთ იგივე შედეგს Node.js კოდის დაწერის გარეშე. მეტი დეტალებისთვის, იხილეთ ოფიციალური API დოკუმენტაცია.
დასკვნა
JSON‑ის XLSX-ზე გადაყვანა Node.JS-ში იძლევა მარტივად, როდესაც იყენებთ Aspose.OCR Cloud SDK for Node.js. SDK‑ი აკეთებს მძიმე სამუშაოს, რაც საშუალებას გაძლევთ ფოკუსირდეთ ბიზნეს ლოგიკაზე, ფაილის ფორმატის დეტალებზე არა. გახსოვდეთ, რომ დაიცავით თქვენი კლიენტის ავტორიზაციის დეტალები, შეცდომებს მიმართეთ გლუვად და ტესტირეთ რეალისტურ მონაცემთა ზომებით. პროდუქციის გვერდზე შეგიძლიათ ნახოთ ფასის დეტალები, ხოლო დროებით ლიცენზია შეგიძლიათ მიიღოთ დროებითი ლიცენზიის გვერდიდან. ბედნიერი კოდირება!
FAQs
როგორ გადავიტან JSON‑ის XLSX ფორმატში Node.JS‑ში Aspose.OCR Cloud SDK-ის გამოყენებით?
გამოიყენეთ OcrApi.convertDocument მეთოდი format: 'xlsx' პარამეტრით. ამ სტატიის სრულ კოდის მაგალითი აჩვენებს ზუსტად განხორციელების ნაბიჯებს.
OCR Cloud API-სთვის რა აუტენტიფიკაცია საჭიროა?
შექმენით client ID და client secret Aspose Cloud dashboard-ში, შემდეგ კი შეცვალეთ ისინი OAuth token-ზე. SDK-ის Configuration ობიექტი ავტომატურად მართავს token-ის მიღებას.
მერე შეიძლება დიდი JSON ფაილების ეფექტურად დამუშავება?
დიახ. SDK ნაკადის სახით იკითხავს შესავალ ფაილს, რაც მეხსიერების მოხმარება დაბალ დონეზე იტოვებს. კომბინაცია async/await‑ით ხელს უწყობს Node.js-ის მოვლენათა ციკლის რეაგირებადობას.
სად შეიძლება მივიღო მეტი მაგალითები და მხარდაჭერა?
ეწვიეთ ოფიციალურ GitHub რეპოზიტორიას, Aspose-ის დოკუმენტაციის საიტს, ან დასვით კითხვები მხარდაჭერის ფორუმზე.