値と数式を入れて表を作る
level: basic ／ verified: 2026-10-01 ／ 4言語タブ対応 ／ English
やりたいこと
新しい xlsx を作って、表（見出し・文字列・数値・数式）を書き込み、ファイルに保存する。 概要の基本の流れを実際の表作成に当てはめたものです。
完成イメージ
sales.xlsx の Sheet1 に次の表ができます。
| A | B | C | D |
|---|
| 1 | 商品 | 単価 | 個数 | 金額 |
| 2 | りんご | 100 | 3 | 300 |
| 3 | みかん | 50 | 6 | 300 |
| 4 | ぶどう | 150 | 2 | 300 |
| 5 | | | 合計 | 900 |
D 列は数式 B*C、D5 は SUM(D2:D4) です。
前提
各言語のモジュールをダウンロードページから入手してインストールします （入口の表記は 概要の前提 表を参照）。
WebAssembly 版は MEMORY64（Wasm 3.0）ビルドのため、実行環境側の対応が必要です （Chrome/Edge 133〜・Firefox 134〜・Node.js 24〜。Safari は現在未対応）。
保存先パスを省略形（"sales.xlsx"）にすると、プロセスのカレントディレクトリに書き出されます。
npm install ./nodeosbxl-1.5.0.tgz
# (例) Python 3.12 以上（abi3 wheel 1 本で 3.12 以降をカバー）
pip install ./pyosbxl-1.5.0-cp312-abi3-linux_x86_64.whl
# JAR をクラスパスに追加（javacpp-1.5.14.jar も必要）
javac -cp osbxl-1.5.0.jar:javacpp-1.5.14.jar Main.java
java -cp osbxl-1.5.0.jar:javacpp-1.5.14.jar:. Main
# パッケージを展開（osbxl_wasm.js / osbxl_em.js / license/ を含む）
tar xzf wasmosbxl-1.5.0.tgz
// 読み込み例（Node.js 24〜 必須: この wasm は MEMORY64 = Wasm 3.0 ビルドです）
const fs = require("fs");
const createModule = require("./package/osbxl_wasm.js"); // emscripten のファクトリ
const { createOsbxl } = require("./package/osbxl_em.js"); // ローダー＋enum 定義
createOsbxl(createModule).then(({ Module, osbxl, dto, chart, enums }) => {
// ライセンスファイルを wasm 仮想 FS へ配置（new App() より前に必須）
const lic = process.env.OSB_LICENSE_PATH_WASM; // 例: /root/lic_node.osb
if (lic && fs.existsSync(lic)) {
Module.FS.mkdirTree(lic.substring(0, lic.lastIndexOf("/")));
Module.FS.writeFile(lic, fs.readFileSync(lic));
}
const app = new osbxl.App(); // ここから先は Node.js 版と同じ（namespace 名のみ osbxl）
// ...
});
// ブラウザでは <script> で osbxl_wasm.js を読み込んで同様に createOsbxl を呼びます。
// 対応環境: Chrome/Edge 133〜・Firefox 134〜（Safari は現在未対応）
コード
実行結果:
// values-formulas.js — ブックを作って、値と数式を入れて保存する
const { nodeosbxl, dto } = require("nodeosbxl");
const app = new nodeosbxl.App();
const wb = app.createWorkBook("sales.xlsx"); // 新規ブック作成
const ws = wb.openWorkSheet("Sheet1"); // 既定のシートを開く
// --- 見出し (1行目) ---
// app.convertFromRowColNumber(行, 列) で (1,1) -> "A1" のセルアドレスが得られる
["商品", "単価", "個数", "金額"].forEach((text, i) => {
const cell = app.convertFromRowColNumber(1, i + 1);
ws.getRange(`${cell}:${cell}`).setValue(text);
});
// --- 明細 (2〜4行目) ---
const data = [["りんご", 100, 3], ["みかん", 50, 6], ["ぶどう", 150, 2]];
data.forEach(([name, price, qty], i) => {
const row = i + 2;
ws.getRange(`A${row}:A${row}`).setValue(name);
ws.getRange(`B${row}:B${row}`).setNumberValue(price);
ws.getRange(`C${row}:C${row}`).setNumberValue(qty);
});
// --- 金額列 (D2:D4) ---
// 行ごとに異なる相対参照を入れたいので setFormulaArray を使う。
// 数式文字列に先頭の "=" は付けない。
const formulas = data.map((_, i) => {
const f = new dto.InputFormulaObject();
f.setA1C1(app.convertFromRowColNumber(i + 2, 4)); // D2, D3, D4
f.setFormula(`B${i + 2}*C${i + 2}`); // "B2*C2" ...
return f;
});
ws.setFormulaArray(formulas);
// --- 合計 (D5) ---
ws.getRange("C5:C5").setValue("合計");
ws.getRange("D5:D5").setFormula("SUM(D2:D4)");
// --- 読み戻し ---
// getValue(true) は「生値」= 数式の計算結果を返す
const values = ws.getRange("A1:D5").getValue(true);
console.log("金額 D2:D4 =", [values["D2"], values["D3"], values["D4"]].join(", "));
console.log("合計:", values["D5"]);
// --- 保存して閉じる ---
wb.save();
wb.close();
# values-formulas.py — node 版サンプルと同一検証 (pyosbxl)
import pyosbxl
app = pyosbxl.App()
wb = app.createWorkBook("sales-py.xlsx") # 新規ブック作成
ws = wb.openWorkSheet("Sheet1") # 既定のシートを開く
# --- 見出し (1行目) ---
# app.convertFromRowColNumber(行, 列) で (1,1) -> "A1" のセルアドレスが得られる
for i, text in enumerate(["商品", "単価", "個数", "金額"]):
cell = app.convertFromRowColNumber(1, i + 1)
ws.getRange(f"{cell}:{cell}").setValue(text)
# --- 明細 (2〜4行目) ---
data = [("りんご", 100, 3), ("みかん", 50, 6), ("ぶどう", 150, 2)]
for i, (name, price, qty) in enumerate(data):
row = i + 2
ws.getRange(f"A{row}:A{row}").setValue(name)
ws.getRange(f"B{row}:B{row}").setNumberValue(price)
ws.getRange(f"C{row}:C{row}").setNumberValue(qty)
# --- 金額列 (D2:D4) ---
# 行ごとに異なる相対参照を入れたいので setFormulaArray を使う。
# 数式文字列に先頭の "=" は付けない。
formulas = []
for i in range(len(data)):
f = pyosbxl.dto.InputFormulaObject()
f.setA1C1(app.convertFromRowColNumber(i + 2, 4)) # D2, D3, D4
f.setFormula(f"B{i + 2}*C{i + 2}") # "B2*C2" ...
formulas.append(f)
ws.setFormulaArray(formulas)
# --- 合計 (D5) ---
ws.getRange("C5:C5").setValue("合計")
ws.getRange("D5:D5").setFormula("SUM(D2:D4)")
# --- 読み戻し ---
# getValue(True) は「生値」= 数式の計算結果を返す
values = ws.getRange("A1:D5").getValue(True)
print("金額 D2:D4 =", ", ".join([values["D2"], values["D3"], values["D4"]]))
print("合計:", values["D5"])
# --- 保存して閉じる ---
wb.save()
wb.close()
// values-formulas.java — node 版サンプルと同一検証 (javaosbxl)
import com.osboffice.osbxl.*;
import com.osboffice.osbxl.dto.*;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
public class Main {
public static void main(String[] args) {
AppWrapper app = new AppWrapper();
WorkBookWrapper wb = app.createWorkBook("sales-java.xlsx"); // 新規ブック作成
WorkSheetWrapper ws = wb.openWorkSheet("Sheet1"); // 既定のシートを開く
// --- 見出し (1行目) ---
// app.convertFromRowColNumber(行, 列) で (1,1) -> "A1" のセルアドレスが得られる
String[] headers = { "商品", "単価", "個数", "金額" };
for (int i = 0; i < headers.length; i++) {
String cell = app.convertFromRowColNumber(1, i + 1);
ws.getRange(cell + ":" + cell).setValue(headers[i]);
}
// --- 明細 (2〜4行目) ---
String[] names = { "りんご", "みかん", "ぶどう" };
double[] prices = { 100, 50, 150 };
double[] qtys = { 3, 6, 2 };
for (int i = 0; i < names.length; i++) {
int row = i + 2;
ws.getRange("A" + row + ":A" + row).setValue(names[i]);
ws.getRange("B" + row + ":B" + row).setNumberValue(prices[i]);
ws.getRange("C" + row + ":C" + row).setNumberValue(qtys[i]);
}
// --- 金額列 (D2:D4) ---
// 行ごとに異なる相対参照を入れたいので setFormulaArray を使う。
// 数式文字列に先頭の "=" は付けない。
List<InputFormulaObjectWrapper> formulas = new ArrayList<>();
for (int i = 0; i < names.length; i++) {
InputFormulaObjectWrapper f = new InputFormulaObjectWrapper();
f.setA1C1(app.convertFromRowColNumber(i + 2, 4)); // D2, D3, D4
f.setFormula("B" + (i + 2) + "*C" + (i + 2)); // "B2*C2" ...
formulas.add(f);
}
ws.setFormulaArray(formulas);
// --- 合計 (D5) ---
ws.getRange("C5:C5").setValue("合計");
ws.getRange("D5:D5").setFormula("SUM(D2:D4)");
// --- 読み戻し ---
// getValue(true) は「生値」= 数式の計算結果を返す
Map<String, String> values = ws.getRange("A1:D5").getValue(true);
System.out.println("金額 D2:D4 = "
+ String.join(", ", values.get("D2"), values.get("D3"), values.get("D4")));
System.out.println("合計: " + values.get("D5"));
// --- 保存して閉じる ---
wb.save();
wb.close();
}
}
// values-formulas.wasm.js — node 版サンプルと同一検証 (wasmosbxl / embind)
// 注意（WebAssembly 版）: モジュールは createOsbxl(createModule) で先に読み込みます。
// 下記で使う osbxl / dto / chart / enums はその時点で得られる4つの namespace です
// （Node.js 版の require("nodeosbxl") に相当）。
const app = new osbxl.App();
const wb = app.createWorkBook("sales-wasm.xlsx"); // 新規ブック作成
const ws = wb.openWorkSheet("Sheet1"); // 既定のシートを開く
// --- 見出し (1行目) ---
// app.convertFromRowColNumber(行, 列) で (1,1) -> "A1" のセルアドレスが得られる
["商品", "単価", "個数", "金額"].forEach((text, i) => {
const cell = app.convertFromRowColNumber(1, i + 1);
ws.getRange(`${cell}:${cell}`).setValue(text);
});
// --- 明細 (2〜4行目) ---
const data = [["りんご", 100, 3], ["みかん", 50, 6], ["ぶどう", 150, 2]];
data.forEach(([name, price, qty], i) => {
const row = i + 2;
ws.getRange(`A${row}:A${row}`).setValue(name);
ws.getRange(`B${row}:B${row}`).setNumberValue(price);
ws.getRange(`C${row}:C${row}`).setNumberValue(qty);
});
// --- 金額列 (D2:D4) ---
// 行ごとに異なる相対参照を入れたいので setFormulaArray を使う。
// 数式文字列に先頭の "=" は付けない。
const formulas = data.map((_, i) => {
const f = new dto.InputFormulaObject();
f.setA1C1(app.convertFromRowColNumber(i + 2, 4)); // D2, D3, D4
f.setFormula(`B${i + 2}*C${i + 2}`); // "B2*C2" ...
return f;
});
ws.setFormulaArray(formulas);
// --- 合計 (D5) ---
ws.getRange("C5:C5").setValue("合計");
ws.getRange("D5:D5").setFormula("SUM(D2:D4)");
// --- 読み戻し ---
// getValue(true) は「生値」= 数式の計算結果を返す
const values = ws.getRange("A1:D5").getValue(true);
console.log("金額 D2:D4 =", [values["D2"], values["D3"], values["D4"]].join(", "));
console.log("合計:", values["D5"]);
// --- 保存して閉じる ---
wb.save();
wb.close();
金額 D2:D4 = 300, 300, 300
合計: 900
解説
new nodeosbxl.App() がすべての入口。 App から createWorkBook() / openWorkBook() で WorkBook を取得し、openWorkSheet() で WorkSheet、getRange() で Range を辿ります。- セルアドレスは
"A1:B2" 形式の文字列。 単一セルでも "A1:A1" と範囲の形で渡します。
行番号・列番号（1始まり）から作る場合は app.convertFromRowColNumber(row, col)、 範囲なら app.convertFromRowColNumber2(startRow, startCol, endRow, endCol) を使います。
- 値の種類ごとに setter が分かれています。
setValue(文字列) / setNumberValue(数値) / setDateValue(DateTimeObject) / setDateStringValue(日付文字列) / setBooleanValue(真偽値)。
getValue(true) の true は「生値」（数式なら計算結果）。
省略すると表示値（書式適用後）になります。
戻り値は { "A1": "100", ... } のマップで、値はすべて文字列です。
数値比較する場合は Number(...) で変換します。wb.save() → wb.close() で終了。 別ファイルに書き出したいときは wb.saveAs(path) を使いますが、 saveAs() は以降の保存先を切り替えません（概要の注意点参照）。
注意点
- 数式に先頭の
= を付けない。 setFormula("=SUM(A1:A3)") ではなく setFormula("SUM(A1:A3)") です。
- 複数セル Range への
setValue / setNumberValue は「全セルに同じ値」を入れます。 ws.getRange("A1:C1").setValue("X") → A1, B1, C1 すべて "X" になります。
setFormula() は相対参照を自動展開しません。 ws.getRange("B1:B3").setFormula("A1*2") は B1 だけに数式が入り、B2 / B3 は空のままです。
第3引数 setAllCell を true にした setFormula("A1*2", false, true) も 「同じ文字列をそのまま全セルにコピーする」だけで、A2*2, A3*2 にはなりません （結果 B1:B3 がすべて同じ値になります）。
行ごとにずらした数式を入れたい場合は、このサンプルのように setFormulaArray() + dto.InputFormulaObject（セルごとに A1C1 と数式を指定） を使ってください。- 起動時にライセンス表示が stdout に 1 行出力されます（プロセスにつき 1 回）。
標準出力をパースする処理を書く場合は注意してください。
関連
- 目次
- 前: 概要 — オブジェクトモデルと基本の流れ / 次: ブックとワークシートの操作
API リファレンス