本機開發

雖然您可以使用線上 Apps Script 環境完成所有連接器相關工作,但隨著時間推移,部分工作可能會變得重複且容易出錯。

dscc-gen 是一項有主觀判斷的工具,旨在解決這些重複性工作,讓您專注於解決業務問題,而非透過自動化避免錯誤。

需求條件

使用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

系統會提示您輸入新連接器的詳細資料。首次使用時,系統會要求使用者驗證 claspclasp 是一種工具,可透過指令列建立及修改 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 的過程通常如下:

  1. 找出要新增至連接器的功能。
  2. 執行 npm run watch,將本機變更推送至 Apps Script。
  3. 使用慣用JavaScript 編輯器修改程式碼。
  4. 執行 npm run tryLatest,確認新功能是否正常運作。
  5. 執行 npm run updateProduction,將新功能更新至正式版部署作業。
  6. 執行 npm run tryProduction,並仔細檢查新功能是否正常運作。

取得指令碼 ID

如要取得 scriptId,請前往現有專案,然後複製 /d/ 後方和 /edit 前方的網址部分。例如:以下網址:

  • 原始網址: https://script.google.com/a/google.com/d/example-script-id/edit
  • 指令碼 ID:example-script-id