如果巨集內使用的所有 API 在 Apps Script 中都具有直接對等項目,則包含 Visual Basic for Applications (VBA) 巨集的 Excel 檔案被視為相容。如果巨集不完全相容,您或許可以套用解決方法或調整程式碼,讓巨集能搭配 Apps Script 運作。
請使用 Macro Converter 的相容性報表,判斷是否可依原樣自動轉換檔案,或是否需要調整程式碼。
產生相容性報表時,每個檔案和 API 都會套用下列其中一種狀態:
狀態 | 定義 |
---|---|
確切支援 | 這些檔案包含在 Apps Script 中具有直接對等項目的 API。 |
支援變通方法 | 這些檔案包含至少一個可解決解決方法的 API。 |
需要進一步調查 | 這些檔案含有至少一個您需要查看的 API,才能判斷後續做法。例如,可能沒有對等的 API,或是 Macro Converter 可能未確定 API 正在使用中。 |
產生相容性報表
- 在電腦上開啟 Google 雲端硬碟。
- 在右側面板中,按一下「微距轉換器」外掛程式 。如果沒有看到側邊面板,請按一下右下方的「顯示側邊面板」圖示 。
- 按一下「新增檔案和資料夾」。巨集轉換器只能辨識 Excel 檔案。
- 選擇您要分析的檔案或資料夾,然後按一下「選取」。您一次最多只能選取 2,000 個檔案。
- 如要變更相容性報表的儲存位置,請按一下「變更目的地資料夾 」,然後選取要的資料夾。否則,檔案會儲存在你的「我的雲端硬碟」資料夾中。
- 按一下「產生報表」。
- 分析完成後,按一下「查看報表」。
查看相容性報表
使用相容性報表中的詳細資料來協助您決定如何繼續進行檔案轉換。報告包含以下部分:
- 摘要:這份工作表提供所有提交檔案及其 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。