Google Sheets 巨集

Google 試算表可讓您記錄您定義的特定 UI 互動系列。記錄巨集後,您可以將格式連結至 Ctrl+Alt+Shift+Number 中的鍵盤快速鍵。您可以使用這個捷徑,再次快速執行確切的巨集步驟 (通常是位於不同位置或不同資料)。您也可以透過 Google 試算表的「擴充功能」 >「巨集」選單啟用巨集。

錄製巨集時,Google 試算表會自動建立 Apps 指令碼函式 (即巨集函式),以便複製巨集步驟。巨集函式會新增至 Apps Script 專案繫結至工作表的檔案名稱中,名稱為 macros.gs。假如專案已繫結至具有該名稱的工作表,則巨集會附加至該函式。Google 試算表也會自動更新指令碼專案資訊清單,記錄指派給巨集的名稱和鍵盤快速鍵。

由於每個記錄巨集都是在 Apps Script 中定義,因此您可以直接透過 Apps Script 編輯器編輯。您甚至可以從 Apps Script 中從頭開始編寫巨集,甚至使用已編寫的函式並將其轉換成巨集。

在 Apps Script 中建立巨集

您可以運用以 Apps Script 編寫的函式,並將其做為巨集函式使用。 最簡單的做法是透過 Google 試算表編輯器匯入現有函式

您也可以在 Apps Script 編輯器中,按照下列步驟建立巨集:

  1. 在 Google Google 試算表 UI 中,依序選取「Extensions」>「Apps Script」,開啟與 AApps Script 編輯器中的工作表繫結的指令碼。
  2. 編寫巨集函式。巨集函式不應採用引數,且不會傳回任何值。
  3. 編輯指令碼資訊清單來建立巨集,並將其連結至巨集函式。為這個按鍵指派不重複的鍵盤快速鍵和名稱。
  4. 儲存指令碼專案。完成後,您就可以在工作表中使用這個巨集。
  5. 測試工作表中的巨集函式,確認函式能正常運作。

編輯巨集

如要編輯工作表附加的巨集,請按照下列步驟操作:

  1. 在 Google 試算表 UI 中,依序選取「擴充功能」>「巨集」>「管理巨集」
  2. 找到要編輯的巨集,然後依序選取 >「編輯巨集」。系統會開啟 Apps Script 編輯器,開啟內含巨集函式的專案檔案。
  3. 編輯巨集函式,以變更巨集行為。
  4. 儲存指令碼專案。完成後,您就可以在工作表中使用這個巨集。
  5. 測試工作表中的巨集函式,確認函式能正常運作。

將函式匯入為巨集

如果工作表已有指令碼繫結,你可以將指令碼中的函式匯入為新的巨集,然後指派鍵盤快速鍵。方法是編輯資訊清單檔,並在 sheets.macros[] 屬性中加入其他元素。

或者,請按照下列步驟,從試算表 UI 將函式匯入為巨集:

  1. 在 Google 試算表 UI 中,依序選取「擴充功能」>「巨集」>「匯入」
  2. 從顯示的清單中選取函式,然後按一下「新增函式」
  3. 選取 [] 即可關閉對話方塊。
  4. 依序選取「擴充功能」>「巨集」>「管理巨集」
  5. 在清單中找出剛匯入的函式。為巨集指派不重複的鍵盤快速鍵。您也可以在這裡變更巨集名稱;名稱預設為函式名稱。
  6. 按一下「更新」即可儲存巨集設定。

巨集的資訊清單結構

以下資訊清單檔案範例顯示定義 Google 試算表巨集的資訊清單部分。資訊清單的 sheets 部分會定義指派給巨集的名稱和鍵盤快速鍵,以及巨集函式的名稱。

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

如要進一步瞭解 Apps Script 資訊清單的建構方式,請參閱資訊清單結構指南。「試算表」和「Macro」章節會說明定義試算表巨集的欄位。

最佳做法

在 Apps Script 中建立或管理巨集時,建議您遵循下列規範。

  1. 巨集在淺色輕巧的情況下的成效較佳。請盡可能限制巨集執行的動作。
  2. 巨集最適合需頻繁重複或幾乎不需要設定的 Roro 作業。針對其他作業,請考慮改用自訂選單項目
  3. 請特別注意,巨集鍵盤快速鍵不得重複,而且指定工作表一次只能有十個包含捷徑的巨集。您只能透過「Extensions」>「Macros」選單執行其他巨集。
  4. 要變更單一儲存格的巨集,請先選取完整範圍並啟用巨集,即可將儲存格套用至儲存格範圍。也就是說,建立巨集時,在預先定義的儲存格範圍內複製相同的作業通常很必要。

你無法執行的操作

巨集的操作有下列限制:

在繫結指令碼外使用巨集

巨集已與特定 Google 試算表繫結至指令碼。如果你在獨立指令碼網頁應用程式中定義了巨集定義,則系統會忽略這些設定。

在 Google 試算表外掛程式中定義巨集

您無法使用試算表外掛程式發布巨集定義。外掛程式外掛程式專案中的任何巨集定義都會遭到該外掛程式的使用者忽略。

在指令碼庫發行巨集

您無法使用 Apps Script 程式庫發布巨集定義。

在 Google 試算表之外使用巨集

巨集僅是 Google 試算表的一項功能,不適用於 Google 文件、表單或簡報。