JSON dosyalarından Excel elektronik tablolarına veri dışa aktarmak, modern Node.JS uygulamalarında raporlama ve veri alışverişi için sık bir gereksinimdir. Aspose.OCR Cloud SDK for Node.js bu dönüşümü doğrudan bulutta gerçekleştirebilen güçlü bir API sunar. Bu kılavuzda, async/await desenlerini ve SDK’nın convertDocument metodunu kullanarak Node.JS’te JSON’u XLSX formatına nasıl dönüştüreceğinizi öğreneceksiniz. Gereksinimleri, ayrıntılı kod incelemesini, tam bir örneği ve REST entegrasyonu için bir cURL alternatifini adım adım ele alacağız.
Başlamadan Önce: Önkoşullar ve Kurulum
Bu öğreticiyi takip etmek için şunlara ihtiyacınız var:
- Yerel olarak yüklü Node.js 14 veya daha yeni bir sürüm.
- OCR API etkinleştirilmiş bir Aspose Cloud hesabı.
- Aspose Cloud kontrol panelinden Client Id ve Client Secret değerleriniz.
- JSON kaynağının ve XLSX çıktısının bulunacağı dosya sistemine erişim.
SDK’yı npm aracılığıyla kurun:
npm install aspose-ocr-cloud
Resmi yayın sayfasından en son paketi indirin: Aspose.OCR Cloud SDK for Node.js İndir. Kurulumdan sonra kodlamaya başlayabilirsiniz.
Aşağıdaki kod parçacığı, OCR istemcisini kimlik bilgilerinizle nasıl yapılandıracağınızı gösterir:
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
İstemci hazır olduğunda, sonraki bölümler dönüşüm iş akışını adım adım gösterir.
Node.JS’te JSON’dan XLSX’e Dönüştürme İçin Adım Adım Kılavuz
Aşağıda, JSON’u Node.JS’te XLSX’e dönüştürmek için gereken her işlemin ayrıntılı bir incelemesi yer almaktadır.
Adım 1: Kaynak Belgeyi Yükle
İlk olarak, dönüştürmek istediğiniz JSON dosyası için bir okuma akışı oluşturun.
const fs = require('fs');
const path = require('path');
const inputJsonPath = path.resolve(__dirname, 'input.json');
const jsonFileStream = fs.createReadStream(inputJsonPath);
Adım 2: OCR API İstemcisini Yapılandırma
Daha önce gösterilen yapılandırmayı kullanarak API nesnesini örnekleyin.
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
Adım 3: ConvertDocument Yöntemini Çağırın
Dönüştürme uç noktasını çağırın ve hedef format olarak xlsx belirtin.
const response = await ocrApi.convertDocument({
format: 'xlsx',
file: jsonFileStream
});
SDK, ikili XLSX verilerini response.body içinde döndürür.
Adım 4: XLSX Çıktı Dosyasını Yaz
İkili veriyi diskte bir dosyaya kaydedin.
const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);
Adım 5: Kaynakları Temizle
Dosya akışını kapatarak sistem kaynaklarını serbest bırakın.
jsonFileStream.close();
Bu adımlarla, Aspose OCR Cloud library’yi kullanarak Node.JS’te JSON’dan XLSX’e dönüştürme işlemini başarıyla gerçekleştirdiniz.
Node.JS’te JSON’dan XLSX’e Dönüştürme - Tam Kod Örneği
Aşağıdaki örnek, Aspose.OCR Cloud SDK kullanarak Node.JS’te JSON’dan XLSX’e dönüştürme için tam uygulamayı göstermektedir.
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();
}
})();
Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.
cURL Yaklaşımı JSON’dan XLSX’e Dönüştürme için Node.JS içinde
Saf bir REST çözümünü tercih ediyorsanız, aynı dönüşüm cURL komutlarıyla gerçekleştirilebilir. Bu yöntem ayrıca Node.JS’te JSON’u XLSX’e dönüştürmek için temel ifadeyi kullanır.
- Erişim belirteci alın
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 dosyasını yükleyin ve dönüştürme isteğinde bulunun
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@input.json"
Yanıt, ikili XLSX yükünü içerir.
- XLSX çıktısını yerel olarak kaydedin
curl -X GET "https://api.aspose.cloud/v3.0/ocr/convert/result/output.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.xlsx
Bu komutlar, herhangi bir Node.js kodu yazmadan aynı sonucu nasıl elde edeceğinizi gösterir. Daha fazla ayrıntı için, resmi API belgelerine bakın.
Sonuç
JSON’u XLSX’e dönüştürmek Node.JS’te, Aspose.OCR Cloud SDK for Node.js kullanıldığında oldukça basit hale gelir. SDK, ağır işleri halleder ve dosya formatı incelikleriyle uğraşmak yerine iş mantığına odaklanmanızı sağlar. İstemci kimlik bilgilerinizi güvence altına almayı, hataları nazikçe ele almayı ve gerçekçi veri boyutlarıyla test etmeyi unutmayın. Üretim dağıtımları için ücretli bir abonelik gerekir; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisans geçici lisans sayfası üzerinden alınabilir. İyi kodlamalar!
FAQs
JSON’u Node.JS’de Aspose.OCR Cloud SDK kullanarak XLSX’e nasıl dönüştürürüm?
format: 'xlsx' ile OcrApi.convertDocument yöntemini kullanın. Bu makaledeki tam kod örneği, kesin uygulama adımlarını gösterir.
OCR Cloud API için hangi kimlik doğrulama gerekir?
Aspose Cloud kontrol panelinde bir istemci kimliği ve istemci gizli anahtarı oluşturun, ardından bunları bir OAuth belirteciyle değiştirin. SDK’nın Configuration nesnesi belirteç alımını otomatik olarak yönetir.
Büyük JSON dosyalarını verimli bir şekilde işleyebilir miyim?
Evet. SDK, giriş dosyasını akış olarak işler ve bellek kullanımını düşük tutar. Bunu async/await ile birleştirerek Node.js olay döngüsünün yanıt vermesini sağlayabilirsiniz.
Daha fazla örnek ve destek nereden bulabilirim?
Resmi GitHub deposunu, Aspose dokümantasyon sitesini ziyaret edin veya destek forumunda sorular sorun.