EXCEL Filler

填入值至指定的 EXCEL 檔案，若指定檔案為絕對路徑，將複製一份至至工作資料夾後再修改

EXCEL

EXCEL輸入檔，點擊 PICK 選取檔案、鍵盤輸入工作資料夾中的EXCEL檔名，或使用 %FILENAME% 變數。

input 物件

input 物件就是 EXCEL 文件本身，提供同步函式 activeSheet(), sheet(sheetNameOrIndex), sheets()

// 傳回正在使用中的sheet物件
let sheet0 = input.activeSheet()

// 傳回名稱為'商品'的sheet物件
let sheet1 = input.sheet('商品')

// 傳回第三個sheet物件（從零起算）
let sheet2 = input.sheet(2)

// 傳回所有sheet物件的陣列
let sheets = input.sheets()

Sheet 物件

即表格物件，提供同步函式 cell(address), cell(rowNumber, columnNumber), range(address)

// 傳回正在使用中sheet物件的'A1'儲存格
let cell0 = input.activeSheet().cell('A1')

// 傳回正在使用中sheet物件的第一列第一欄儲存格，跟'A1'一樣
let cell1 = input.activeSheet().cell(1,1)

// 傳回正在使用中sheet物件的指定範圍
let range = input.activeSheet().range('A1:C3')

Cell 物件

即儲存格物件，提供同步函式 value(), value(value)

// 傳回正在使用中sheet物件的'A1'儲存格的值
let value0 = input.activeSheet().cell('A1').value()

// 填入'hello'字串至正在使用中sheet物件的'A1'儲存格
input.activesheet().cell('A1').value('hello')

// 將3x3的二維陣列中的值填到'A1'為左上角起點的3x3個儲存格
let cellA1 = input.activeSheet().cell('A1')
cellA1.value([
  [1,2,3],
  [4,5,6],
  [7,8,9]
])

Range 物件

即範圍物件，提供同步函式 value(), value(array2d)

// 傳回正在使用中sheet物件的'A1:B2'範圍儲存格的值，以二維陣列表示
let values = input.activeSheet().range('A1:B2').value()

// 將2x2的二維陣列中的值填到'A1:B2'範圍的儲存格
input.activeSheet().range('A1:B2').value([
  [1,2],
  [3,4]
])