如果 VBA 宏中使用的所有 API 在 Apps 脚本中都有直接对应的 API，则包含 VBA 宏的 Excel 文件被视为兼容。如果您的宏不完全兼容，您或许可以采用一些解决方法或调整代码，使其与 Apps 脚本搭配使用。
使用宏转换器的兼容性报告来确定您是否可以按原样自动转换文件，或者是否需要调整代码。
生成兼容性报告后，系统会为每个文件和 API 应用以下状态之一：
| 状态 | 定义 |
|---|---|
| 完全支持 | 这些文件包含的 API 在 Apps 脚本中都有直接对等项。 |
| 支持，但需采取变通方法 | 这些文件包含至少一个可以通过变通方法支持的 API。 |
| 需要进一步调查 | 这些文件包含至少一个需要您查看的 API，以便确定后续操作。例如，可能没有等效的 API，或者宏转换器可能未确定所使用的 API。 |
生成兼容性报告
- 在电脑上打开 Google 云端硬盘。
- 在右侧面板中，点击“宏转换器”插件
。
如果您没有看到侧边栏，请点击右下角的“显示侧边栏”图标 。 - 点击添加文件和文件夹。宏转换器仅识别 Excel 文件。
- 选择要分析的文件或文件夹，然后点击选择。每次选择的文件数量不得超过 2,000 个。
- 如需更改兼容性报告的保存位置，请点击“更改目标文件夹”图标 ，然后选择所需文件夹。否则，系统会将该文件保存在“我的云端硬盘”文件夹中。
- 点击生成报告。
- 分析完成后，点击查看报告。
查看兼容性报告
借助兼容性报告中的详细信息，您可以决定如何继续进行文件转换。您的报告包含以下部分：
- 摘要：此工作表汇总分析了所有提交的文件及其 API 的兼容性。
- 文件 - 兼容性：此工作表列出了提交给宏转换器的每个文件，以及每个文件的兼容性状态和详细信息。
文件 - 详细分析：此工作表会提供有关文件内 API 的更多信息，以及您可以采取哪些措施来成功转换每个 API。首先，从顶部下拉菜单中选择一个文件。然后，从底部下拉菜单中选择一种状态。
您还可以使用名为 APIs to investigate 和 APIs with workarounds 的工作表，逐个 API 地查看报告。
确定后续操作
以下是我们针对每种状态的建议：
| 状态 | 建议 |
|---|---|
| 完全支持 | VBA API 中的相同逻辑可在 Apps 脚本中复制。 继续转换。 |
| 支持，但需采取变通方法 | 您需要编写代码，将至少一个 VBA API 替换为等效的 Apps 脚本 API。一般来说，您可以继续进行转换。
您可以在转换文件之前或之后手动替换标记为支持但需采用变通方法的 VBA API。我们建议您提前进行更改。 |
| 需要进一步调查 | 至少有一个 API 无法转换。根据相应 API 在代码中的重要性，您可能无法转换该文件。
应由了解原始 VBA 代码的人员进行最终评估。
如果您决定转换文件，则需要编写代码来替换至少一个 VBA API（使用 Apps 脚本）。您可以在转换文件之前或之后手动替换标记为 Needs investigation 的 VBA API。我们建议您提前进行更改。 |
评估兼容性报告后，请参阅将 VBA 宏转换为 Apps 脚本。