המרת CSV ל‑TXT ב‑Node.JS

המרת נתוני CSV לקבצי TXT פשוטים היא צורך נפוץ בעת בניית צינורות נתונים, כלי דיווח או מייצאי יומנים פשוטים. Aspose.Cells Cloud SDK for Node.js מספק ספרייה חזקה שמטפלת בעבודה הכבדה של המרת פורמטים בצד השרת. במדריך זה תלמדו כיצד לבצע המרה מ‑CSV ל‑TXT ב‑Node.JS שלב אחר שלב, לחקור גישה מבוססת cURL‑REST, לכוונן אפשרויות קידוד וליישם שיטות מיטביות לביצועים.

דרישות המרת CSV ל‑TXT

מפתחים לעיתים קרובות צריכים להפוך נתוני CSV בסגנון גיליון אלקטרוני לקבצי TXT גולמיים עבור מערכות קצה שמצפות לטקסט מופרד בשורות ללא פסיקים. דרישות טיפוסיות כוללות:

עיבוד ברמת נפח גבוהה - היכולת להתמודד עם קבצים גדולים מבלי לטעון את כל התוכן לזיכרון.
קידוד תווים מותאם אישית - מערכות ישנות רבות דורשות UTF‑8, ISO‑8859‑1, או קידודים ספציפיים אחרים.
אוטומציה - ההמרה חייבת להיות ניתנת לקריאה ממערכת אחורית של Node.JS ללא התערבות ידנית.

שימוש בסקריפטים כלליים של מערכת‑קבצים יכול להפוך במהירות לשגוי, במיוחד כאשר מתמודדים עם קידודים שונים או כאשר היישום פועל בסביבת ענן שבה גישה לקבצים מקומיים מוגבלת.

Choosing Aspose.Cells Cloud SDK for Node.js for the Job

Aspose.Cells Cloud SDK for Node.js מציע API מונחה REST שפועל בענן, ומבטל את הצורך בהתקנות Office מקומיות. היכולות המרכזיות שעונות על הדרישות הן:

תמיכה בזרימה - קבצים מועלים ומורדים כזרמים, מה שמפחית את טביעת הזיכרון.
בקרת קידוד - המחלקה TxtSaveOptions מאפשרת לך לציין כל קידוד טקסט נתמך.
עיצוב מוכן לאצווה - אתה יכול לקרוא להמרה בלולאות או בתהליכים אסינכרוניים.

ה‑SDK משולב בצורה חלקה עם שירותי Aspose אחרים, וה‑תיעוד המקיף ו‑הפניות API מספקים הדרכה מפורטת עבור כל שיטה המשמשת במדריך זה.

CSV ל‑TXT ב‑Node.JS: יישום

להלן מדריך תמציתי של כל התהליך. כל שלב כולל קטע קוד קצר שנלקח ישירות מהדוגמה המלאה שמופיעה מאוחר יותר במאמר.

התקנת SDK והגדרת אישורים

ראשית, הוסף את הספרייה לפרויקט שלך והגדר את לקוח ה-API עם מזהה הלקוח והסוד שלך.

npm install asposecellscloud

const { CellsApi, ApiClient, model } = require('asposecellscloud');

const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new ApiClient.Configuration({
    clientId,
    clientSecret,
    basePath: 'https://api.aspose.cloud'
});
const cellsApi = new CellsApi(config);

העלאת קובץ CSV לאחסון בענן

קרא את קובץ ה‑CSV המקומי והעלה אותו לאחסון של Aspose Cloud.

const [fs](https://docs.fileformat.com/programming/fs/) = require('fs');
const path = require('path');

const localCsvPath = path.resolve(__dirname, ‘sample.csv’); const remoteCsvPath = ‘sample.csv’; const csvData = fs.readFileSync(localCsvPath);

const uploadRequest = new model.UploadFileRequest({
    path: remoteCsvPath,
    file: csvData
});
await cellsApi.uploadFile(uploadRequest);

הגדר אפשרויות שמירת TXT עם קידוד מותאם אישית

צור אובייקט TxtSaveOptions כדי לציין קידוד UTF‑8 (או כל קידוד אחר שאתה צריך).

const txtSaveOptions = new model.TxtSaveOptions({
    encoding: 'utf-8'          // custom encoding
});

<!--[CODE_SNIPPET_END]-->

### המרת חוברת עבודה מ‑CSV ל‑TXT
הפעל את בקשת ההמרה, העבר את שם קובץ ה‑CSV המרוחק ואת אפשרויות ה‑TXT.

```javascript
const convertRequest = new model.ConvertWorkbookRequest({
    name: remoteCsvPath,
    format: 'txt',
    outPath: '',
    options: txtSaveOptions
});
const convertResponse = await cellsApi.convertWorkbook(convertRequest);


### הורדת תוצאת TXT וניקוי קובץ מרוחק
כתוב את תוכן ה‑TXT שהומר לקובץ מקומי ובאופן אופציונלי מחק את קובץ ה‑CSV המקורי מאחסון הענן.

```javascript
const localTxtPath = path.resolve(__dirname, 'sample.txt');
fs.writeFileSync(localTxtPath, convertResponse.body);

const deleteRequest = new model.DeleteFileRequest({ path: remoteCsvPath });
await cellsApi.deleteFile(deleteRequest);

console.log('CSV successfully converted to TXT at:', localTxtPath);

דוגמת קוד מלאה: CSV ל‑TXT ב‑Node.JS באמצעות Aspose.Cells

הקוד הבא מדגים את כל תהליך העבודה מההתחלה ועד הסוף.

const { CellsApi, ApiClient, model } = require('asposecellscloud');
const fs = require('fs');
const path = require('path');

(async () => { // ==== Configuration ==== const clientId = ‘YOUR_CLIENT_ID’; const clientSecret = ‘YOUR_CLIENT_SECRET’; const config = new ApiClient.Configuration({ clientId, clientSecret, basePath: ‘https://api.aspose.cloud’ }); const cellsApi = new CellsApi(config);

// ==== נתיבי קבצים ==== const localCsvPath = path.resolve(__dirname, ‘sample.csv’); // קלט CSV const remoteCsvPath = ‘sample.csv’; // נתיב ב‑Aspose Cloud storage const localTxtPath = path.resolve(__dirname, ‘sample.txt’); // פלט TXT

// ==== Upload CSV to cloud storage ==== const csvData = fs.readFileSync(localCsvPath); const uploadRequest = new model.UploadFileRequest({ path: remoteCsvPath, file: csvData }); await cellsApi.uploadFile(uploadRequest);

// ==== Prepare TXT save options with custom encoding ==== const txtSaveOptions = new model.TxtSaveOptions({ encoding: ‘utf-8’ // custom encoding });

// ==== Convert CSV to TXT ==== const convertRequest = new model.ConvertWorkbookRequest({ name: remoteCsvPath, format: ’txt’, outPath: ‘’, options: txtSaveOptions }); const convertResponse = await cellsApi.convertWorkbook(convertRequest);

// ==== Save the converted TXT locally ====
    fs.writeFileSync(localTxtPath, convertResponse.body);

// ==== Clean up remote file (optional) ==== const deleteRequest = new model.DeleteFileRequest({ path: remoteCsvPath }); await cellsApi.deleteFile(deleteRequest);

console.log('CSV successfully converted to TXT at:', localTxtPath);
})();

הערה: דוגמת קוד זו מדגימה את הפונקציונליות המרכזית. לפני השימוש בפרויקט שלכם, ודאו שהנתיבים וקביעות התצורה תואמים לסביבתכם האמיתית, אמתו שכל התלויות הנדרשות מותקנות כראוי, ובצעו בדיקות מקיפות בסביבת הפיתוח. אם נתקלתם בבעיות, אנא פנו לתיעוד הרשמי או לצוות תמיכה.

המרת CSV ל‑TXT עם cURL ו‑REST API

If you prefer a pure REST approach, the same conversion can be performed with cURL commands.

1. אימות וקבלת אסימון גישה

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. העלאת קובץ CSV המקורי

curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/sample.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/csv" \
     --data-binary "@sample.csv"

3. ביצוע ההמרה

curl -X POST "https://api.aspose.cloud/v3.0/cells/sample.csv/convert?format=txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"TxtSaveOptions": {"Encoding": "utf-8"}}' \
     -o sample.txt

4. הורדת קובץ TXT (כבר נשמר באמצעות הדגל `-o`)

פקודות אלו מציגות את אותו תהליך ללא כתיבת קוד Node.JS. לפרטים נוספים, ראו את תיעוד ה‑API הרשמי.

אפשרויות המרה: הגדרות לייצוא CSV ל‑TXT

The SDK exposes several properties you can tweak to fine‑tune the output.

Encoding – קובע את קידוד התווים של קובץ ה‑TXT. בדוגמה שלמעלה משתמשים ב‑'utf-8'.
OutPath – אם ברצונכם שהתוצאה תישמר ישירות באחסון בענן, הגדירו נתיב כגון 'output/sample.txt'.
SaveFormat – למרות שהפורמט המבוקש הוא 'txt', ניתן גם לבקש 'txt' עם מפרידים שונים באמצעות אפשרויות נוספות (לא מכוסות כאן).

הנה קטע קוד שמשנה את מיקום הפלט:

const convertRequest = new model.ConvertWorkbookRequest({
    name: remoteCsvPath,
    format: 'txt',
    outPath: 'output/result.txt',   // store in cloud storage
    options: txtSaveOptions
});

לרשימה מלאה של מאפיינים שניתן להגדיר, עיין ב-מחלקת TxtSaveOptions.

סיכום

המרת CSV ל‑TXT ב‑Node.JS הופכת לפשוטה כאשר אתה משתמש ב‑Aspose.Cells Cloud SDK for Node.js. הספרייה מטפלת בזרימת קבצים, קידוד מותאם, ובאינטראקציה עם אחסון בענן, ומאפשרת לך להתמקד בלוגיקה העסקית במקום בפרסינג ברמת‑הנמוכה. זכור לאבטח רישיון מתאים לשימוש בייצור; רישיון בתשלום פותח המרות בלתי מוגבלות, בעוד שרישיון זמני זמין לבדיקות ב‑דף הרישיון הזמני. עם הקוד ודוגמאות cURL המסופקות, אתה יכול לשלב ייצוא CSV ל‑TXT בכל שירות Node.JS במהירות ובאמינות.

שאלות נפוצות

איך אני מטפל בקידוד מותאם אישית בעת המרת CSV ל‑TXT ב‑Node.JS?
השתמש באובייקט TxtSaveOptions כדי להגדיר את המאפיין encoding (למשל, 'utf-8' או 'iso-8859-1'). זה מבטיח שה‑TXT שנוצר תואם לציפיות של מערכת היעד.

האם אני יכול לעבד מספר קבצי CSV בריצה אחת?
כן. מיקום לוגיקת ההמרה בתוך לולאה, מעלה כל CSV, קורא ל-convertWorkbook, ומוריד את קובץ ה‑TXT שנוצר. העיצוב חסר‑מצב של ה‑SDK מאפשר עיבוד אצווה פשוט.

מהם שיקולי הביצועים עבור קבצי CSV גדולים?
הזרם את העלאת הקובץ והורדתו במקום לטעון את כל הקובץ בזיכרון. נקודות הקצה של REST של ה‑SDK עובדות עם זרמים, מה שמפחית את השימוש בזיכרון RAM ומשפר את הקנה מידה.

האם נדרש רישיון להמרת CSV ל‑TXT בייצור?
רישיון בתשלום נדרש לפריסות בייצור. ניתן לקבל רישיון זמני להערכה מדף דף רישיון זמני

דרישות המרת CSV ל‑TXT#

Choosing Aspose.Cells Cloud SDK for Node.js for the Job#

CSV ל‑TXT ב‑Node.JS: יישום#

התקנת SDK והגדרת אישורים#

העלאת קובץ CSV לאחסון בענן#

הגדר אפשרויות שמירת TXT עם קידוד מותאם אישית#

דוגמת קוד מלאה: CSV ל‑TXT ב‑Node.JS באמצעות Aspose.Cells#

המרת CSV ל‑TXT עם cURL ו‑REST API#

1. אימות וקבלת אסימון גישה#

2. העלאת קובץ CSV המקורי#

3. ביצוע ההמרה#

4. הורדת קובץ TXT (כבר נשמר באמצעות הדגל -o)#

אפשרויות המרה: הגדרות לייצוא CSV ל‑TXT#

סיכום#

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

קרא עוד#