JSON（JSON）ファイルから Excel スプレッドシートへのデータエクスポートは、最新の Node.JS アプリケーションにおけるレポート作成やデータ交換で頻繁に求められる要件です。Aspose.OCR Cloud SDK for Node.js は、クラウド上で直接この変換を処理できる強力な API を提供します。このガイドでは、async/await パターンと SDK の convertDocument メソッドを使用して、Node.JS で JSON を XLSX に変換する方法を学びます。前提条件、詳細なコード解説、完全なサンプル、さらには REST 統合用の cURL 代替手段まで順に説明します。

開始前の前提条件とインストール

このチュートリアルを実行するには、以下が必要です。

  • Node.js 14 以降がローカルにインストールされていること。
  • OCR API が有効化された Aspose Cloud アカウント。
  • Aspose Cloud ダッシュボードから取得した Client Id と Client Secret。
  • JSON ソースと XLSX 出力が配置されるファイルシステムへのアクセス。

npm を使用して SDK をインストールします:

npm install aspose-ocr-cloud

公式リリースページから最新パッケージをダウンロードしてください: Aspose.OCR Cloud SDK for Node.js Download。インストール後、すぐにコーディングを開始できます。

次のスニペットは、資格情報を使用して OCR クライアントを構成する方法を示しています:

const { OcrApi, Configuration } = require('asposeocrcloud');

const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);

クライアントの準備ができたら、次のセクションで変換ワークフローをステップバイステップで実演します。

Node.JSでJSONをXLSXに変換するステップバイステップガイド

以下は、Node.JS で JSON を XLSX に変換するために必要な各操作の詳細な手順です。

ステップ 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 メソッドを呼び出す

変換エンドポイントを呼び出し、ターゲット形式として 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();

これらの手順に従って、Aspose OCR Cloud ライブラリを使用して Node.JS で JSON を XLSX に変換する操作を正常に実行しました。

JSONからXLSXへの変換（Node.JS） - 完全なコード例

以下の例は、Node.JS で Aspose.OCR Cloud SDK を使用して JSON を XLSX に変換する完全な実装を示しています。

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();
    }
})();

注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値を実際の環境に合わせて更新し、すべての必須依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント または サポートチーム にお問い合わせください。

Node.JS における JSON から XLSX への変換の cURL アプローチ

純粋な REST ソリューションを希望する場合、同じ変換は cURL コマンドで実行できます。この方法は、Node.JS で JSON を XLSX に変換するという主要なフレーズも使用します。

  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"
  1. 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 ペイロードが含まれます。

  1. 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 ドキュメント を参照してください。

結論

Node.JS で JSON を XLSX に変換することは、Aspose.OCR Cloud SDK for Node.js を活用するとシンプルになります。SDK が重い処理を担当するため、ファイル形式の詳細に煩わされることなくビジネスロジックに集中できます。クライアント認証情報を安全に保管し、エラーを適切に処理し、実際のデータサイズでテストすることを忘れないでください。本番環境での展開には有料サブスクリプションが必要です。価格の詳細は製品ページで確認でき、temporary license page から一時ライセンスを取得できます。コーディングを楽しんでください！

よくある質問

Node.JSでAspose.OCR Cloud SDKを使用してJSONをXLSXに変換するにはどうすればよいですか？
format: 'xlsx' を指定して OcrApi.convertDocument メソッドを使用します。この記事の完全なコード例では、正確な実装手順が示されています。

OCR Cloud API に必要な認証は何ですか？
Aspose Cloud dashboard でクライアント ID とクライアントシークレットを作成し、それらを OAuth トークンと交換します。SDK の Configuration object がトークン取得を自動的に管理します。

大きな JSON ファイルを効率的に処理できますか？
はい。SDK は入力ファイルをストリーム処理し、メモリ使用量を低く抑えます。これに async/await を組み合わせて、Node.js のイベントループを応答性の高い状態に保ちます。

もっと多くの例やサポートはどこで見つけられますか？
公式のGitHubリポジトリ、Asposeのドキュメントサイト、またはサポートフォーラムで質問してください。

さらに読む