---
title: "EXCEL填值"
description: "EMILY.RPA EXCEL 填值模組：將值填入指定的 EXCEL 檔案，絕對路徑的檔案會先複製一份至工作資料夾再修改。"
source: https://docs.emily.tips/wap/excelfiller
---

# EXCEL填值

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

![](https://docs.emily.tips/img/zh/wap-091.png)

## 參數

**`XLSX FILE`** - EXCEL XLSX 格式輸入檔，點擊「**PICK**」選取檔案、鍵盤輸入工作資料夾中的 EXCEL 檔名，或使用 **%FILENAME%** 變數。

## No-Code 編輯器

提供：「**設定儲存格值**」、「**設定範圍值**」、「**設定表格到儲存格**」等無程式碼指令。例如，在 sheet2 表格的 A2 位置加入一個二維表格資料，A2 為 `2026-01-01`、B2 為 `1000`、A3 為 `2026-01-02`、B3 為 `450`。

![](https://docs.emily.tips/img/zh/wap-092.png)

## Low-Code 編輯器

![](https://docs.emily.tips/img/zh/wap-093.png)

### input 物件

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

```javascript
// 傳回正在使用中的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)

```javascript
// 傳回正在使用中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')

// 將名為'商品'的sheet物件改名為'最新商品'
input.sheet('商品').name('最新商品')
```

### Cell 物件

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

```javascript
// 傳回正在使用中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]
])

// 將'B2'儲存格的公式印出
console.log(input.activeSheet().cell('B2').formula())

// 設定'C3'儲存格的公式
input.activeSheet().cell('C3').formula('A1+B2')
```

### Range 物件

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

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

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