判斷 VBA 巨集是否相容

如果巨集內使用的所有 API 在 Apps Script 中都具有直接對等項目，則包含 Visual Basic for Applications (VBA) 巨集的 Excel 檔案被視為相容。如果巨集不完全相容，您或許可以套用解決方法或調整程式碼，讓巨集能搭配 Apps Script 運作。

請使用 Macro Converter 的相容性報表，判斷是否可依原樣自動轉換檔案，或是否需要調整程式碼。

產生相容性報表時，每個檔案和 API 都會套用下列其中一種狀態：

狀態 定義
確切支援 這些檔案包含在 Apps Script 中具有直接對等項目的 API。
支援變通方法 這些檔案包含至少一個可解決解決方法的 API。
需要進一步調查 這些檔案含有至少一個您需要查看的 API，才能判斷後續做法。例如，可能沒有對等的 API，或是 Macro Converter 可能未確定 API 正在使用中。

產生相容性報表

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

查看相容性報表

使用相容性報表中的詳細資料來協助您決定如何繼續進行檔案轉換。報告包含以下部分：

  • 摘要：這份工作表提供所有提交檔案及其 API 的相容性匯總分析。
  • 檔案 - 相容性：這份工作表列出提交給 Macro 轉換工具的每個檔案，以及每個檔案的相容性狀態和詳細資料。

  • 檔案 - 詳細分析：這份工作表進一步說明檔案中的 API，以及成功轉換每個 API 可採取的動作。首先，在頂端的下拉式選單中選取檔案。然後從底部的下拉式選單中選取狀態。

您也可以使用稱為「要調查的 API」和「具備解決方法的 API」試算表，逐一查看每個 API 的報表。

決定如何進行

以下是每個狀態適用的建議步驟：

狀態 建議
確切支援 您可以在 Apps Script 中複製 VBA API 的相同邏輯。繼續進行轉換作業。
支援變通方法 您需要編寫程式碼，將至少一個 VBA API 替換為對等的 Apps Script API。一般來說，您可以繼續執行轉換作業。

您可以在轉換檔案之前或之後，手動取代標示為「支援解決方法」的 VBA API。建議您事先進行變更。
需要進一步調查 無法轉換至少一個 API。視該 API 在程式碼中的重要性而定，您可能無法轉換檔案。熟悉原始 VBA 程式碼的人應進行最終評估。

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

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