判斷 VBA 巨集是否相容

如果巨集中使用的所有 API 在 Apps Script 中都有直接對應項目，則含有 Visual Basic for Applications (VBA) 巨集的 Excel 檔案就會視為相容。如果巨集不完全相容，您可以嘗試使用因應措施或調整程式碼，讓巨集與 Apps Script 搭配運作。

請參閱巨集轉換工具的「相容性」報表，判斷是否可以自動轉換現有檔案，或是需要調整程式碼。

產生相容性報告時，系統會將下列其中一種狀態套用至每個檔案和 API：

狀態 定義
完全支援 這些檔案包含的 API 在 Apps Script 中都有直接對應項目。
支援，但有因應措施 這些檔案至少包含一個可透過因應措施支援的 API。
需要進一步調查 這些檔案至少包含一個 API，您必須查看這些檔案，才能決定後續處理方式。舉例來說，可能沒有等同的 API，或是巨集轉換工具可能未判斷使用的 API。

產生相容性報表

  1. 在電腦上開啟 Google 雲端硬碟。
  2. 在右側面板中，按一下「巨集轉換器」外掛程式 巨集轉換器圖示。如果沒有看到側邊面板，請按一下右下方的「顯示側邊面板」圖示 。
  3. 按一下「新增檔案和資料夾」。巨集轉換工具只會辨識 Excel 檔案。
  4. 選擇要分析的檔案或資料夾，然後按一下「選取」。一次選取的檔案數量不得超過 2,000 個。
  5. 如要變更相容性報告的儲存位置，請按一下「變更目的地資料夾」圖示 ，然後選取所需資料夾。否則會儲存在「我的雲端硬碟」資料夾。
  6. 按一下「產生報表」。
  7. 分析完成後，按一下「查看報告」。

查看相容性報表

請參考相容性報告中的詳細資料，決定如何繼續進行檔案轉換作業。報表包含以下幾個部分：

  • 摘要：這個試算表會針對所有提交的檔案及其 API 提供綜合分析。
  • 檔案 - 相容性：這個工作表會列出提交至巨集轉換工具的每個檔案，並顯示相容性狀態和每個檔案的詳細資料。

  • 檔案 - 詳細分析：這個工作表會提供檔案中 API 的詳細資訊，以及如何成功轉換每個 API 的相關操作。首先，請從頂端的下拉式選單中選取檔案。接著，從下方的下拉式選單中選取狀態。

您也可以使用名為「要調查的 API」和「有解決方法的 API」工作表，逐一查看每個 API 的報告。

決定後續處理方式

以下是各狀態的建議做法：

狀態 建議
完全支援 您可以將 VBA API 中的相同邏輯複製到 Apps Script。 繼續進行轉換。
支援，但有因應措施 您需要編寫程式碼，將至少一個 VBA API 替換為等效的 Apps Script API。一般來說，您可以繼續進行轉換。

您可以在轉換檔案前或後，手動取代標示為「支援使用因應措施」的 VBA API。建議您先進行變更。
需要進一步調查 至少有一項 API 無法轉換。視該 API 在程式碼中的重要性而定，您可能無法轉換檔案。請由瞭解原始 VBA 程式碼的人員進行最終評估。

如果您決定轉換檔案，就必須編寫程式碼，將至少一個 VBA API 替換為 Apps Script。您可以在轉換檔案前或後，手動取代標示為「需要調查」的 VBA API。建議您先進行變更。

評估相容性報告後，請參閱「將 VBA 巨集轉換為 Apps Script」。