---
title: "工作資料夾執行腳本"
description: "EMILY.RPA 工作資料夾執行腳本模組：以 Low-Code 腳本對工作資料夾內的檔案做管理或讀寫。"
source: https://docs.emily.tips/wap/txt2txt
---

# 工作資料夾執行腳本

對工作資料夾內的檔案做管理或讀寫。

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

## No-Code 編輯器

提供：「**重新命名檔案**」、「**刪除檔案**」、「**壓縮指定檔案**」、「**解壓縮指定檔案**」、「**解壓縮全部檔案**」等無程式碼指令。

例如想壓縮工作資料夾中的檔案存成 ZIP 檔，可以選擇「**壓縮指定檔案**」。然後將要壓縮的檔名排成 JSON 陣列格式填入 `FILES` 欄位，點擊「**OK**」後就會將這個無程式碼指令記錄在模組的指令列表。

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

## Low-Code 編輯器

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

### input 輸入物件

在腳本中可以直接存取 input 內建物件。input 物件中的每個 key 為工作資料夾中的一個 TXT 檔案名稱（不包含副檔名），每個 value 為該檔案的文字內容，在腳本被執行時就會自動載入所有文檔，免去於腳本中自行讀取的麻煩：

```javascript
// 讀取工作資料夾中 price.txt 的值
let price = input['price']
console.log('price:', price)
```

### output 輸出物件

當腳本需要輸出文檔時，可以直接修改 output 內建物件。加入 output 物件中的每個 key 將被輸出成工作資料夾中的一個 TXT 檔案，檔案名稱即為 key，文字內容為該 key 相對應的 value。

```javascript
// 寫入值到工作資料夾中 new_price.txt 
let new_price = 100
output['new_price'] = new_price
```

### api 物件

提供同步函式：api.files(), api.stat(filename), api.read(filename, encoding='utf8'), api.write(filename, text), api.rename(oldname, newname), api.remove(filename), api.createHash(algorithm)。另外 [moment.js ](https://momentjs.com/docs/)與 [lodash](https://lodash.com/docs/4.17.15) 都是內建函式庫，可以直接使用：

```javascript
// 一筆筆列出所有工作資料夾中的檔案
api.files().forEach((file) => console.log(file))

// 讀取檔案的各類時戳資訊，例如檔案建立時間、修改時間、最近存取時間
console.log(api.stat('price.txt'))

// 讀取工作資料夾中的文字檔 price.txt
console.log(api.read('price.txt'))

// 寫出文字檔到工作資料夾中
api.write('time.txt', moment().format('HH:mm:ss'))

// 修改工作資料夾中的檔案名稱
api.rename('time.txt', 'currentTime.txt')

// 刪除工作資料夾中的檔案
api.remove('price.txt')

// 建立 MD5, SHA1, SHA256, SHA512 等演算法 hash 物件
let md5 = api.createHash('MD5')

// 輸出 MD5 hash 值
md5.hex('hello')

// 輸出 salt 為 'key' 的 hmac 值
md5.hex_hmac('key', 'hello')
```

以及非同步函式，回傳 [Promise](https://developer.mozilla.org/zh-TW/docs/Web/JavaScript/Guide/Using_promises) 物件：api.run(uuid), api.readCSV(filename, separator, skiplines), api.splitCSV(filename, separator, skiplines, newname, maxRows), api.writeCSV(filename, rows, header) 與 api.writeXML(filename, obj, options)

```javascript
// 呼叫執行某個自動化技能，其識別碼為 ef4e12a6-636f-4e58-8e14-212089e6fd23
await api.run('ef4e12a6-636f-4e58-8e14-212089e6fd23')

// 將工作資料夾中的CSV格式大檔案分割成多個CSV格式小檔案，每個檔案不超過5000筆資料
let files = await api.splitCSV('large.csv', ',', 0, 'small.csv', 5000)

// 寫出的檔案：['small(0).csv', 'small(1).csv', ... ] 存成一個檔案列表
await api.writeCSV('list.csv', files.map((file, index) => {return {file, index}}), ['index','file'])

// 讀取工作資料夾中的CSV檔案並且印出資料
let list = await api.readCSV('list.csv')
console.log(list) 

// 將 JSON 物件轉換成XML格式並寫出檔案，其中<addr>加上屬性，輸出header並縮排
let obj = {
  root: [
    { date: '2023/03/12' },
    { item: 'coffee' },
    { item: 'tea' },
    {
      _name: 'addr',
      _content: '101F, #1, Taiwan Road',
      _attrs: {
        country: 'TWN',
        city: 'TPE'
      }
    }
  ]
}
await api.writeXML('result.xml', obj, { header: true, indent: '\t' })
```

另外也提供 zip 讀寫 API 以針對工作資料夾內的檔案做壓縮或解壓縮，此類 API 皆為非同步函式：

```javascript
// 讀取 input.zip 內檔案
let inputZip = api.zip()
await inputZip.load('input.zip')
let filesInZip = await inputZip.files()
filesInZip.forEach((file) => console.log(file))

// 解壓縮 input.zip 內的檔案 a.txt
await inputZip.extract('a.txt')

// 壓縮工作資料夾中 b.jpg 與 c.pdf 成 output.zip
let outputZip = api.zip()
await outputZip.add('b.jpg')
await outputZip.add('c.pdf')
await outputZip.save('output.zip')
```

如果在 Windows 上想解壓縮的 zip 檔內有中文檔名的檔案需要解壓卻發現出現亂碼錯誤，這是由於 Windows 的中文編碼不是 UTF-8，可以在 load(filename, encoding = 'utf8') API 中指定編碼模式。

```javascript
// assign encoding type in load()
await inputZip.load('input.zip', 'Big5')
```

需要對 PDF 檔案做刪除或合併頁面時，可以使用 pdf API：

```javascript
// 讀取 a.pdf 刪除第一頁後存成 b.pdf
let inputPdf = api.pdf()
await inputPdf.load('a.pdf')
let count = inputPdf.pageCount()
console.log(`a.pdf has ${count} pages`)
await inputPdf.removePage(0)
await inputPdf.save('b.pdf')

// 將 c.pdf 的第1,3,5頁，與 d.pdf 的第2頁合併成 e.pdf
let outputPdf = api.pdf()
await outputPdf.create()
await outputPdf.addPagesFrom('c.pdf',[0,2,4])
await outputPdf.addPagesFrom('d.pdf',[1])
await outputPdf.save('e.pdf')
```