將試算表資料轉換為純文字是常見需求,尤其當您需要將資訊輸入舊有系統或簡單的解析器時。Aspose.Cells Cloud SDK for Node.js 提供強大的函式庫,能在伺服器端處理繁重工作。在本指南中,您將看到完整的範例、用於 REST API 的 cURL 工作流程、安裝步驟、設定選項,以及最佳實踐技巧,讓在 Node.JS 中將 CSV 轉換為 TXT 變得輕鬆且可靠。

完整的 CSV 轉 TXT 範例(Node.JS)

此範例示範如何呼叫 Cells API 並將轉換後的 TXT 檔案儲存至本機。

const fs = require('fs');
const path = require('path');
const { CellsApi, ApiClient } = require('@aspose/cells-cloud');

async function convertCsvToTxt() {
    // Aspose Cloud authentication
    const clientId = 'YOUR_CLIENT_ID';
    const clientSecret = 'YOUR_CLIENT_SECRET';
    const config = new ApiClient();
    config.clientId = clientId;
    config.clientSecret = clientSecret;
    config.basePath = 'https://api.aspose.cloud';

const cellsApi = new CellsApi(config);

// File paths
    const inputFile = path.resolve(__dirname, 'input.csv');
    const outputFile = path.resolve(__dirname, 'output.txt');

// Prepare request
    const fileStream = fs.createReadStream(inputFile);
    const request = {
        file: fileStream,
        format: 'txt' // target format
    };

try {
        // Convert CSV to TXT
        const response = await cellsApi.postConvertWorkbook(request);
        // response.body is a Buffer containing the TXT data
        fs.writeFileSync(outputFile, response.body);
        console.log(`Conversion completed. TXT saved to ${outputFile}`);
    } catch (err) {
        console.error('Conversion failed:', err);
    }
}

convertCsvToTxt();

注意: 此程式碼範例展示了核心功能。在將其用於您的專案之前,請確保更新所有檔案路徑和設定值以符合實際環境,驗證所有必要的相依項目已正確安裝,並在開發環境中徹底測試。如遇到任何問題,請參閱官方文件或聯繫支援團隊尋求協助。

在 Node.JS 中將 CSV 轉換為 TXT

程式碼以幾個邏輯步驟運作:

  1. 初始化 API 用戶端 - new ApiClient() 會使用您的憑證和基礎 URL 進行配置。
const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';
  1. 建立 CellsApi 實例 - 此物件公開轉換方法。
const cellsApi = new CellsApi(config);
  1. 以串流方式讀取 CSV 檔案 - fs.createReadStream 提供 API 所需的二進位資料。
const fileStream = fs.createReadStream(inputFile);
  1. 建立請求物件 - format 屬性告訴服務輸出 TXT。
const request = {
    file: fileStream,
    format: 'txt'
};
  1. 呼叫 postConvertWorkbook - API 會回傳一個包含已轉換文字的 Buffer,然後將其寫入磁碟。
    const response = await cellsApi.postConvertWorkbook(request);
    fs.writeFileSync(outputFile, response.body);
    

了解每個組件有助於自訂流程,例如加入錯誤處理或處理多個檔案。

準備環境

  1. 使用 npm 安裝 SDK:
npm install asposecellscloud
  1. 確保已安裝 Node.js 14 或更高版本。

  2. 如果您偏好手動安裝,請從官方發布頁面下載最新套件: Aspose.Cells Cloud SDK for Node.js Download.

  3. 建立一個免費的 Aspose Cloud 帳戶以取得您的 client ID 和 client secret。

滿足這些先決條件後,您即可立即執行轉換腳本。

使用 cURL 和 REST API 將 CSV 轉換為 TXT

您可以透過直接呼叫 Aspose.Cells Cloud REST 端點,而無需編寫任何程式碼,即可達成相同的結果。

  1. 取得存取權杖 - 將您的客戶端憑證交換為 JWT。
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"
  1. 上傳來源 CSV 檔案 至儲存空間。
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.csv" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: text/csv" \
  --data-binary @input.csv
  1. 請求轉換為 TXT 格式。
curl -X POST "https://api.aspose.cloud/v3.0/cells/convert?format=txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@input.csv"
  1. 下載產生的 TXT 檔案
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.txt

如需了解每個端點的更多詳細資訊,請參閱 Aspose.Cells API Reference。

轉換設定:選項與參數

此範例僅使用兩個參數,但 API 支援其他設定:

  • format - 指定目標檔案類型。在本例中設定為 'txt'。變更此值可讓您匯出為服務支援的其他純文字格式。
  • file - 代表來源 CSV 的串流。若符合您的架構,您可以將串流替換為 Buffer 或 base64 字串。

欲取得完整支援參數清單,請參考 postConvertWorkbook 的 API 參考 頁面。

CSV 轉 TXT 匯出的實用技巧

  • 驗證輸入檔案 在將其發送至 API 之前,以避免意外的轉換錯誤。
  • 重複使用 API 用戶端 在多次轉換中,以減少驗證開銷。
  • 串流大型 CSV 檔案 而不是將它們全部載入記憶體;fs.createReadStream 已經具備此功能。
  • 處理回應緩衝區 使用正確的編碼(utf8),如果您需要在轉換後操作文字。
  • 保護您的認證資訊 將 clientId 與 clientSecret 存放於環境變數或密鑰管理服務中。

遵循這些做法將使您的應用程式保持高效且安全。

結論

將 CSV 轉換為 TXT 在 Node.JS 中變得簡單,只需使用 Aspose.Cells Cloud SDK for Node.js。此函式庫抽象化了低階細節,讓您專注於業務邏輯,同時提供可靠的結果。請記得取得有效的授權以供正式環境使用;您可以購買訂閱或從 臨時授權頁面 取得臨時授權。透過本文中的程式碼範例、cURL 工作流程與最佳實踐指引,您即可在任何 Node.JS 解決方案中整合 CSV 到 TXT 的匯出功能。

常見問題

如何在 Node.JS 中使用 Aspose.Cells Cloud 執行 CSV 轉 TXT?
使用 Aspose.Cells Cloud SDK for Node.js 呼叫 postConvertWorkbook 方法。提供 CSV 檔案串流並將格式設定為 'txt'。請參閱上面的完整程式碼範例。

我可以在單一請求中將多個 CSV 檔案轉換為 TXT 嗎?
API 每次請求僅處理一個檔案。請在 Node.JS 中遍歷您的檔案,並為每個檔案呼叫轉換方法。

在 Node.JS 中將 CSV 匯出為 TXT 需要什麼驗證?
您需要從您的 Aspose Cloud 帳戶獲取客戶端 ID 和客戶端密鑰。SDK 會自動將它們交換為存取權杖。

我可以在哪裡找到有關轉換選項的更多詳細資訊?
請參閱官方文件於 Aspose.Cells Cloud SDK for Node.js 文件,以及 API 參考於 Aspose.Cells API 參考.

Read More