雖然您可以使用線上 Apps Script 環境完成所有連接器相關工作,但隨著時間推移,部分工作可能會變得重複且容易出錯。
dscc-gen 是一項有主觀判斷的工具,旨在解決這些重複性工作,讓您專注於解決業務問題,而非透過自動化避免錯誤。
需求條件
- npm 5.2.0 以上版本
- 熟悉指令列。
使用dscc-gen
dscc-gen 可以建立新的社群連結器專案,或搭配現有專案使用。
現有連接器
dscc-gen 也可搭配現有專案使用。首先,複製 scriptId,然後執行下列指令 (將 YOUR_SCRIPT_ID 替換為 scriptId):
npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID
系統會提示您輸入連接器的詳細資料。如果您沒有名為「Production」的部署作業,系統會為您建立一個。現有程式碼不會有任何變更,但您將可存取dscc-gen的所有功能。
新連接器
如要使用 dscc-gen 建立新的社群連結器,請執行下列指令:
npx @google/dscc-gen connector
系統會提示您輸入新連接器的詳細資料。首次使用時,系統會要求使用者驗證 clasp。clasp 是一種工具,可透過指令列建立及修改 Apps Script 專案。
完成提示後,dscc-gen 會建立新的 Apps Script 專案,並列印所有可執行的動作。
「dscc-gen」可以執行的操作
| 指令 | 說明 |
|---|---|
npm run open |
在 Apps Script 中開啟專案。 |
npm run push |
將本機變更推送至 Apps Script。 |
npm run watch
|
監控本機變更,並將變更推送到 Apps Script。 |
npm run prettier |
使用社群標準格式化程式碼。 |
npm run try_latest
|
在數據分析中開啟含有最新程式碼的部署作業。 |
npm run try_production |
在數據分析中開啟正式版部署。 |
npm run update_production
|
更新正式版部署作業,使用最新程式碼。 |
如何使用?
使用 dscc-gen 的過程通常如下:
- 找出要新增至連接器的功能。
- 執行
npm run watch,將本機變更推送至 Apps Script。 - 使用慣用的 JavaScript 編輯器修改程式碼。
- 執行
npm run tryLatest,確認新功能是否正常運作。 - 執行
npm run updateProduction,將新功能更新至正式版部署作業。 - 執行
npm run tryProduction,並仔細檢查新功能是否正常運作。
取得指令碼 ID
如要取得 scriptId,請前往現有專案,然後複製 /d/ 後方和 /edit 前方的網址部分。例如:以下網址:
- 原始網址:
https://script.google.com/a/google.com/d/example-script-id/edit - 指令碼 ID:
example-script-id