如果宏中使用的所有 API 在 Apps 脚本中有直接等效项，则包含 Visual Basic for Application (VBA) 宏的 Excel 文件可被视为兼容。如果您的宏不完全兼容，您或许可以应用解决方法或调整代码，使其与 Apps 脚本配合使用。
您可以使用 Macro Converter 的兼容性报告确定是否可以按原样自动转换文件，或者是否需要对代码进行调整。
生成兼容性报告时，系统会对您的每个文件和 API 应用以下状态之一：
| 状态 | 定义 |
|---|---|
| 完全支持 | 这些文件包含在 Apps 脚本中都有直接等效项的 API。 |
| 支持，但有解决方法 | 这些文件包含至少一个可通过解决办法获得支持的 API。 |
| 需要进一步调查 | 这些文件包含至少一个 API，您需要检查该 API 才能确定后续操作。例如，可能没有等效的 API，或者宏转换器可能尚未确定正在使用的 API。 |
生成兼容性报告
- 在计算机上打开 Google 云端硬盘。
- 在右侧面板中，点击 Macro Converter 插件
。如果您没有看到侧边栏，请点击右下角的“显示侧边栏”图标 。 - 点击添加文件和文件夹。宏转换器只能识别 Excel 文件。
- 选择要分析的文件或文件夹，然后点击选择。一次选择的文件少于 2,000 个。
- 如需更改兼容性报告的保存位置，请点击“更改目标文件夹”，然后选择所需的文件夹。否则，系统会将该文件保存在“我的云端硬盘”文件夹中。
- 点击生成报告。
- 分析完成后，点击查看报告。
查看兼容性报告
兼容性报告中的详细信息可以帮助您决定如何进行文件转换。您的报告包含以下部分：
- 摘要：此表格对提交的所有文件及其 API 的兼容性进行了汇总分析。
- 文件 - 兼容性：此表格列出了提交到宏转换器的每个文件，以及每个文件的兼容性状态和详细信息。
文件 - 详细分析：此表格提供了有关文件中的 API 的更多信息，以及您可以执行哪些操作来成功转换每个 API。首先，从顶部的下拉菜单中选择一个文件。然后，从底部的下拉菜单中选择一种状态。
您还可以使用名为要调查的 API 和包含解决办法的 API 表格，按 API 查看报告。
确定如何继续操作
以下是我们针对每种状态的建议：
| 状态 | 建议 |
|---|---|
| 完全支持 | 您的 VBA API 中的相同逻辑将可以在 Apps 脚本中复制。继续转换。 |
| 支持，但有解决方法 | 您需要编写代码，将至少一个 VBA API 替换为等效的 Apps Script API。一般来说，您可以继续转换。
您可以在转换文件之前或之后手动替换标记为有解决方案且支持解决的 VBA API。我们建议您提前进行更改。 |
| 需要进一步调查 | 至少有一个 API 无法转换。您可能无法转换该文件，具体取决于相应 API 在代码中的重要性。
了解原始 VBA 代码的人员应执行最终评估。
如果您决定转换文件，则需要编写代码，将至少一个 VBA API 替换为 Apps 脚本。您可以在转换文件之前或之后手动替换标记为需要调查的 VBA API。我们建议您提前进行更改。 |
评估兼容性报告后，请参阅将 VBA 宏转换为 Apps 脚本。