スクリプトタスクでデータ項目の値を参照・更新する

const value = engine.findDataByVarName("フィールド名");

const value = engine.findDataByName("データ項目名");    // データ項目名（日本語可）
const value = engine.findDataByNumber("3");             // データ項目番号（文字列）
const value = engine.findDataByNumber(3);               // データ項目番号（数値）

// engine.findDataByVarName("q_customer") と等価
const text = q_customer;

q_customer = "新しい値";  // ← データ項目は更新されない！（よくある間違い）

engine.setDataByVarName("フィールド名", 値);

engine.setDataByName("データ項目名", 値);
engine.setDataByNumber(3, 値);

// 参照
const text = engine.findDataByVarName("q_summary");

// 更新
engine.setDataByVarName("q_summary", "新しい内容");
engine.setDataByVarName("q_memo", "1行目\n2行目");  // 複数行は \n で改行

// 参照
const amount = engine.findDataByVarName("q_amount");  // BigDecimal で取得される

// 更新
engine.setDataByVarName("q_amount", new java.math.BigDecimal(1000));
engine.setDataByVarName("q_price", new java.math.BigDecimal("9.99"));  // 小数はString指定が安全

// 参照
const items = engine.findDataByVarName("q_category");
for (let i = 0; i < items.size(); i++) {
    const item = items.get(i);
    // item.getValue()   → 選択肢の値（例："JP"）
    // item.getDisplay() → 選択肢の表示ラベル（例："日本"）
}

// 更新（複数選択の場合）
const selected = new java.util.ArrayList();
selected.add("JP");
selected.add("US");
engine.setDataByVarName("q_category", selected);

// 更新（単一選択の場合も ArrayList で）
const single = new java.util.ArrayList();
single.add("JP");
engine.setDataByVarName("q_country", single);

// 参照
const title = processInstance.getProcessInstanceTitle();

// 更新
processInstance.setProcessInstanceTitle("新しい件名");

// 各データ項目を取得
const itemName  = engine.findDataByVarName("q_item_name");   // 文字型
const unitPrice = engine.findDataByVarName("q_unit_price");  // 数値型
const quantity  = engine.findDataByVarName("q_quantity");    // 数値型

// 必須でないデータ項目は型に関わらず未入力の場合 null になる
if (itemName === null || unitPrice === null || quantity === null) {
    throw new Error("品名・単価・数量のいずれかが未入力です");
}

// 合計金額を計算（BigDecimal の multiply を使う）
const total = unitPrice.multiply(quantity);

// 数値を桁区切り付きの文字列に整形（例：1,000.00）
const formatter = new java.text.DecimalFormat("#,##0.00");
const totalText = formatter.format(total);

// 結果を文字型の備考欄に書き込む
const summary = itemName + "：" + totalText + " 円";
>engine.setDataByVarName("q_memo", summary);