「エクセルファイルを扱えるライブラリ」といえば、Java であれば Apache POI などがありますが、Node.js ではどうだろう？？ と思って調べてみました。その名もズバリの xlsx という npm ライブラリを見つけたので使ってみました：
npm - xlsx
https://www.npmjs.com/package/xlsx
ライブラリ名は xlsx ですが、対応フォーマットは xls や XML に加えて ODS まで含まれていて、かなり柔軟に使えそうです。
【扱うサンプル】
こんな感じのエクセルファイルを用意して使うことにします：
データとしては "A1:C14" の範囲にまとまっていて、その右に２軸の折れ線グラフが１つあります。この表の B14 セルは B2:B13 の合計（SUM）、C14 セルは C2:C13 の平均値（AVERAGE）がマクロで定義されています。まあ「よくあるシート」だと思っていますが、このエクセルファイルを xlsx で扱ってみます。ちなみに同じファイルがこちらからダウンロードできます：
【読み込み例】
まず npm で xlsx ライブラリをインストールします：
そして xlsx ライブラリを使ってエクセルファイルを読み込む Node.js コードを作成します。この例ではファイル名を指定して読み込み、"Sheet1" シートを取得して console.log() で出力しています：
実行結果はこんな感じになります。ダンプされたような感じです：
この結果の見方を少し説明します。例えば sheet1["!ref"] の値は 'A1:C14' となっていて、このシートの中で有効なセルとして認識されている範囲は A1:C14 とされています。つまりグラフ部分は完全に無視されていて、このライブラリでは現在は扱えない情報ということになります。xlsx はあくまで表部分の読み書きを対象としています。
次に sheet1["C2"] の値は { v: 0.87, t: 'n', w: '0.87' } となっています。この意味は以下のようになります：
v: 0.87（数値としての値は 0.87）
t: 'n'（数値のセルとして認識されている）
w: '0.87'（表示されているテキストは '0.87'）
なお、t の値は以下のいずれかになります：
b: Boolean
n: 数値
d: 日付時刻
s: 文字列
z: スタブ
e: エラー
したがって sheet1["C2"] の { v: 0.87, t: 'n', w: '0.87' } の意味は「値が 0.87 の数値セルで、画面上では '0.87' と表示されている」ということになります。
また sheet1["B14"] の値は { v: 156518, t: 'n', f: 'SUM(B2:B13)', w: '156518' } となっています。この中の f: 'SUM(B2:B13)' は値が数式で定義されていて、その式が SUM(B2:B13) であることを意味しています（sheet1["C14"] も同様です）。表としてはこのレベルで各セルの値を取得できている、ということがわかります。
この読み込み例のサンプル（app1.js）はこちらからダウンロードできます。こちらのファイルは（後述の書き込み機能の結果を確認できるように）上記のコードに少し機能を追加していて、コマンドラインパラメータで読み込むエクセルファイルを指定可能にしています（無指定の場合は SalesSample.xls を読み込みます）：
【書き込み例】
xlsx ライブラリを使ってファイルの書き込みを行うサンプルです。この例では SalesSample.xls を読み込んだあとに "C13" セルの値を上書きして、SalesSample2.xlsx というファイル名で保存しています：
（注１ 最後の XLSX.writeFile() 実行時の最後のオプション { type: 'xlsx' } を指定しないとマクロ関数が無効な状態で保存されてしまいます）
この書き込みのサンプル（app2.js）はこちらからダウンロードできます。実行はそのまま node コマンドで実行します：
実行すると SalesSample2.xlsx というファイルが出来ているはずです。試しにこのファイルをエクセルで開いてみるとこのようになります：
"C13" セルの値は { v: 1.01, t: 'n', w: '1.01' } に上書きしましたが、たしかに 0.814 から 1.01 に更新されています。同時に "C14" セルの値も（AVERAGE関数が再計算されて）変わっています。一方でグラフが完全に消えてしまいました。まあ読み込みを実行した時点でグラフの情報は消えていたので、その内容で保存するとこのようになってしまうのだと思います。xlsx ライブラリの制限事項になると思いますが、実際に使う際にはご注意ください。
（注２ 厳密には SalesSample2.xlsx ファイルが生成された時点では C14 セルの値は変わっていませんが、このファイルをエクセルで開くと AVERAGE 関数が再計算されて開くので、そこで値が正しく変わったように見えます）
以上、詳細は本家のドキュメントを参照いただきたいのですが、少なくともグラフを操作せずにシートの中身を取り出す用途であれば充分につかえて、対応フォーマットも多そうだな、、という印象を持っています。自然言語処理機械学習の学習データとしてエクセル資産を活用する、なんて話になった時に活躍できそうなライブラリですね。
npm - xlsx
https://www.npmjs.com/package/xlsx
ライブラリ名は xlsx ですが、対応フォーマットは xls や XML に加えて ODS まで含まれていて、かなり柔軟に使えそうです。
【扱うサンプル】
こんな感じのエクセルファイルを用意して使うことにします：
データとしては "A1:C14" の範囲にまとまっていて、その右に２軸の折れ線グラフが１つあります。この表の B14 セルは B2:B13 の合計（SUM）、C14 セルは C2:C13 の平均値（AVERAGE）がマクロで定義されています。まあ「よくあるシート」だと思っていますが、このエクセルファイルを xlsx で扱ってみます。ちなみに同じファイルがこちらからダウンロードできます：
【読み込み例】
まず npm で xlsx ライブラリをインストールします：
$ npm install xlsx
そして xlsx ライブラリを使ってエクセルファイルを読み込む Node.js コードを作成します。この例ではファイル名を指定して読み込み、"Sheet1" シートを取得して console.log() で出力しています：
var XLSX = require( 'xlsx' ); // ファイル読み込み var book = XLSX.readFile( './SalesSample.xls' ); // シート var sheet1 = book.Sheets["Sheet1"]; console.log( sheet1 );
実行結果はこんな感じになります。ダンプされたような感じです：
{ '!margins':
{ left: 0.7,
right: 0.7,
top: 0.75,
bottom: 0.75,
header: 0.3,
footer: 0.3 },
B1: { v: '売上', t: 's', w: '売上' },
C1: { v: '前年比', t: 's', w: '前年比' },
A2: { v: 1, t: 'n', w: '1' },
B2: { v: 7370, t: 'n', w: '7370' },
C2: { v: 0.87, t: 'n', w: '0.87' },
A3: { v: 2, t: 'n', w: '2' },
:
:
A12: { v: 11, t: 'n', w: '11' },
B12: { v: 24380, t: 'n', w: '24380' },
C12: { v: 0.812, t: 'n', w: '0.812' },
A13: { v: 12, t: 'n', w: '12' },
B13: { v: 28283, t: 'n', w: '28283' },
C13: { v: 0.814, t: 'n', w: '0.814' },
B14: { v: 156518, t: 'n', f: 'SUM(B2:B13)', w: '156518' },
C14:
{ v: 0.8603333333333333,
t: 'n',
f: 'AVERAGE(C2:C13)',
w: '0.860333333' },
'!protect': false,
'!ref': 'A1:C14',
'!objects': [ , , , , { cmo: [Object], ft: [Object] } ] }
この結果の見方を少し説明します。例えば sheet1["!ref"] の値は 'A1:C14' となっていて、このシートの中で有効なセルとして認識されている範囲は A1:C14 とされています。つまりグラフ部分は完全に無視されていて、このライブラリでは現在は扱えない情報ということになります。xlsx はあくまで表部分の読み書きを対象としています。
次に sheet1["C2"] の値は { v: 0.87, t: 'n', w: '0.87' } となっています。この意味は以下のようになります：
v: 0.87（数値としての値は 0.87）
t: 'n'（数値のセルとして認識されている）
w: '0.87'（表示されているテキストは '0.87'）
なお、t の値は以下のいずれかになります：
b: Boolean
n: 数値
d: 日付時刻
s: 文字列
z: スタブ
e: エラー
したがって sheet1["C2"] の { v: 0.87, t: 'n', w: '0.87' } の意味は「値が 0.87 の数値セルで、画面上では '0.87' と表示されている」ということになります。
また sheet1["B14"] の値は { v: 156518, t: 'n', f: 'SUM(B2:B13)', w: '156518' } となっています。この中の f: 'SUM(B2:B13)' は値が数式で定義されていて、その式が SUM(B2:B13) であることを意味しています（sheet1["C14"] も同様です）。表としてはこのレベルで各セルの値を取得できている、ということがわかります。
この読み込み例のサンプル（app1.js）はこちらからダウンロードできます。こちらのファイルは（後述の書き込み機能の結果を確認できるように）上記のコードに少し機能を追加していて、コマンドラインパラメータで読み込むエクセルファイルを指定可能にしています（無指定の場合は SalesSample.xls を読み込みます）：
$ node app1.js (xxx.xls)
【書き込み例】
xlsx ライブラリを使ってファイルの書き込みを行うサンプルです。この例では SalesSample.xls を読み込んだあとに "C13" セルの値を上書きして、SalesSample2.xlsx というファイル名で保存しています：
var XLSX = require( 'xlsx' );
// ファイル読み込み
var book = XLSX.readFile( './SalesSample.xls' );
// シート
var sheet1 = book.Sheets["Sheet1"];
console.log( sheet1 );
// セル更新
sheet1["C13"] = { v: 1.01, t: 'n', w: '1.01' };
// シート更新
book.Sheets["Sheet1"] = sheet1;
// ファイル書き込み
XLSX.writeFile( book, './SalesSample2.xlsx', { type: 'xlsx' } );
（注１ 最後の XLSX.writeFile() 実行時の最後のオプション { type: 'xlsx' } を指定しないとマクロ関数が無効な状態で保存されてしまいます）
この書き込みのサンプル（app2.js）はこちらからダウンロードできます。実行はそのまま node コマンドで実行します：
$ node app2.js
実行すると SalesSample2.xlsx というファイルが出来ているはずです。試しにこのファイルをエクセルで開いてみるとこのようになります：
"C13" セルの値は { v: 1.01, t: 'n', w: '1.01' } に上書きしましたが、たしかに 0.814 から 1.01 に更新されています。同時に "C14" セルの値も（AVERAGE関数が再計算されて）変わっています。一方でグラフが完全に消えてしまいました。まあ読み込みを実行した時点でグラフの情報は消えていたので、その内容で保存するとこのようになってしまうのだと思います。xlsx ライブラリの制限事項になると思いますが、実際に使う際にはご注意ください。
（注２ 厳密には SalesSample2.xlsx ファイルが生成された時点では C14 セルの値は変わっていませんが、このファイルをエクセルで開くと AVERAGE 関数が再計算されて開くので、そこで値が正しく変わったように見えます）
以上、詳細は本家のドキュメントを参照いただきたいのですが、少なくともグラフを操作せずにシートの中身を取り出す用途であれば充分につかえて、対応フォーマットも多そうだな、、という印象を持っています。自然言語処理機械学習の学習データとしてエクセル資産を活用する、なんて話になった時に活躍できそうなライブラリですね。
コメント