המרת JSON ל‑XLSX ב‑Node.JS

ייצוא נתונים מקבצי JSON לגליונות Excel הוא דרישה נפוצה לדיווח והחלפת נתונים ביישומי Node.JS מודרניים. Aspose.OCR Cloud SDK for Node.js מספק API חזק שיכול לבצע המרה זו ישירות בענן. במדריך זה תלמדו כיצד להמיר JSON ל-XLSX ב-Node.JS באמצעות תבניות async/await ושיטת convertDocument של ה‑SDK. נדריך אתכם דרישות קדם, סקירה מפורטת של הקוד, דוגמה מלאה, ואף חלופה ב‑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: הגדר את לקוח ה-API של OCR

השתמש מחדש בתצורה שהוצגה קודם כדי לאתחל את אובייקט ה-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

הפעל את נקודת הקצה של ההמרה, וציין 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.

המרת 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 ב‑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 מטפל בעבודה הכבדה, מאפשר לכם להתמקד בלוגיקה העסקית במקום בפרטי פורמט הקבצים. זכרו לאבטח את אישורי הלקוח שלכם, לטפל בשגיאות בצורה אלגנטית, ולבדוק עם גדלים ריאליים של נתונים. לפריסות בייצור תזדקקו למנוי בתשלום; פרטי התמחור זמינים בדף המוצר, ורישיון זמני ניתן לקבל מדף ה‑דף רישיון זמני. קידוד מהנה!

שאלות נפוצות

איך אני ממיר JSON ל‑XLSX ב‑Node.JS באמצעות Aspose.OCR Cloud SDK?
השתמש במתודה OcrApi.convertDocument עם format: 'xlsx'. דוגמת הקוד המלאה במאמר זה מציגה את שלבי היישום המדויקים.

איזה אימות נדרש עבור OCR Cloud API?
צור מזהה לקוח (client ID) וסוד לקוח (client secret) בלוח המחוונים של Aspose Cloud, ולאחר מכן החלף אותם באסימון OAuth. האובייקט Configuration של ה‑SDK מנהל את קבלת האסימון באופן אוטומטי.

האם אני יכול לעבד קבצי JSON גדולים ביעילות?
כן. ה‑SDK משדר את קובץ הקלט, משאיר את השימוש בזיכרון נמוך. שלב זאת עם async/await כדי לשמור על לולאת האירועים של Node.js מגיבה.

היכן אני יכול למצוא עוד דוגמאות ותמיכה?
בקרו במאגר GitHub הרשמי, באתר התיעוד של Aspose, או שאלו שאלות בפורום התמיכה.

לפני שאתה מתחיל: דרישות מוקדמות והתקנה#

מדריך שלב‑אחר‑שלב להמרת JSON ל‑XLSX ב‑Node.JS#

שלב 1: טען את מסמך המקור#

שלב 2: הגדר את לקוח ה-API של OCR#

שלב 3: קריאת המתודה ConvertDocument#

שלב 4: כתיבת קובץ הפלט XLSX#

שלב 5: ניקוי משאבים#

המרת JSON ל‑XLSX ב‑Node.JS - דוגמת קוד מלאה#

גישה באמצעות cURL להמרת JSON ל‑XLSX ב‑Node.JS#

סיכום#

שאלות נפוצות#

Read More#