Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Eine Excel-Datei mit VBA-Makros (Visual Basic for Applications) gilt als kompatibel, wenn alle in den Makros verwendeten APIs ein direktes Äquivalent in Apps Script haben. Wenn Ihre Makros nicht vollständig kompatibel sind, können Sie möglicherweise Problemumgehungen anwenden oder den Code anpassen, damit sie mit Apps Script funktionieren.
Mithilfe des Kompatibilitätsberichts des Makro-Konverters können Sie feststellen, ob Sie Ihre Dateien automatisch konvertieren können oder ob Sie Anpassungen an Ihrem Code vornehmen müssen.
Wenn Sie einen Kompatibilitätsbericht erstellen, wird jeder Ihrer Dateien und APIs einer der folgenden Status zugewiesen:
Status
Definition
Genau unterstützt
Diese Dateien enthalten APIs, die alle direkte Entsprechungen in Apps Script haben.
Mit Workarounds unterstützt
Diese Dateien enthalten mindestens eine API, die mit einem Workaround unterstützt werden kann.
Weitere Untersuchungen erforderlich
Diese Dateien enthalten mindestens eine API, die Sie prüfen müssen, um zu entscheiden, wie Sie vorgehen. Beispielsweise gibt es möglicherweise keine entsprechende API oder der Makrokonverter hat die verwendete API nicht ermittelt.
Klicken Sie in der rechten Seitenleiste auf das Add-on „Makrokonverter“ .
Wenn die Seitenleiste nicht angezeigt wird, klicken Sie rechts unten auf „Seitenleiste einblenden“ chevron_left.
Klicken Sie auf Dateien und Ordner hinzufügen. Der Macro Converter erkennt nur Excel-Dateien.
Wählen Sie die Dateien oder Ordner aus, die Sie analysieren möchten, und klicken Sie auf Auswählen. Wählen Sie jeweils weniger als 2.000 Dateien aus.
Wenn Sie den Speicherort des Kompatibilitätsberichts ändern möchten, klicken Sie auf „Zielordner ändern“ edit und wählen Sie den gewünschten Ordner aus. Andernfalls wird sie im Ordner „Meine Ablage“ gespeichert.
Klicken Sie auf Bericht generieren.
Wenn die Analyse abgeschlossen ist, klicken Sie auf Bericht ansehen.
Kompatibilitätsbericht ansehen
Anhand der Details im Kompatibilitätsbericht können Sie entscheiden, wie Sie mit der Dateikonvertierung fortfahren. Ihr Bericht enthält die folgenden Abschnitte:
Zusammenfassung: Auf diesem Tab finden Sie eine zusammengefasste Analyse der Kompatibilität aller eingereichten Dateien und ihrer APIs.
Dateien – Kompatibilität: In diesem Tabellenblatt sind alle Dateien aufgeführt, die an Macro Converter gesendet wurden, zusammen mit dem Kompatibilitätsstatus und Details zu jeder Datei.
Dateien – detaillierte Analyse: In diesem Tabellenblatt finden Sie weitere Informationen zu den APIs in einer Datei und dazu, welche Maßnahmen Sie ergreifen können, um jede API erfolgreich zu konvertieren. Wählen Sie zuerst im Drop-down-Menü oben eine Datei aus. Wählen Sie dann im Drop-down-Menü unten einen Status aus.
Sie können den Bericht auch API-basiert in den Tabellenblättern APIs to investigate (Zu untersuchende APIs) und APIs with workarounds (APIs mit Workarounds) prüfen.
Vorgehensweise festlegen
Hier sind unsere Empfehlungen für die einzelnen Status:
Sie müssen Code schreiben, um mindestens eine VBA-API durch die entsprechende Apps Script-API zu ersetzen. Im Allgemeinen können Sie mit der Konvertierung fortfahren.
Sie können die als Mit Workarounds unterstützt gekennzeichneten VBA-APIs entweder vor oder nach der Konvertierung der Datei manuell ersetzen. Wir empfehlen Ihnen, die Änderungen vorab vorzunehmen.
Weitere Untersuchungen erforderlich
Mindestens eine API kann nicht konvertiert werden. Je nachdem, wie wichtig die API in Ihrem Code ist, können Sie die Datei möglicherweise nicht konvertieren.
Die endgültige Bewertung sollte von jemandem vorgenommen werden, der den ursprünglichen VBA-Code versteht.
Wenn Sie Ihre Datei konvertieren möchten, müssen Sie Code schreiben, um mindestens eine VBA-API durch Apps Script zu ersetzen. Sie können die als Needs investigation gekennzeichneten VBA-APIs entweder vor oder nach der Konvertierung der Datei manuell ersetzen. Wir empfehlen Ihnen, die Änderungen im Voraus vorzunehmen.
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[[["\u003cp\u003eVBA macros with direct Apps Script equivalents are considered compatible and can be automatically converted using the Macro Converter add-on.\u003c/p\u003e\n"],["\u003cp\u003eThe Macro Converter's compatibility report identifies files as "Supported exactly", "Supported with workarounds", or "Needs more investigation", guiding your conversion strategy.\u003c/p\u003e\n"],["\u003cp\u003eFor files needing workarounds or further investigation, manual code adjustments may be necessary before or after conversion using equivalent Apps Script APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe compatibility report provides detailed analysis at the file and API level to help assess conversion feasibility and required actions.\u003c/p\u003e\n"],["\u003cp\u003eAfter reviewing the report, proceed with file conversion, addressing potential issues as outlined in the documentation.\u003c/p\u003e\n"]]],[],null,["# Determine if VBA macros are compatible\n\nAn Excel file with Visual Basic for Applications (VBA) macros is considered\ncompatible if all APIs used in the macros have a direct equivalent in Apps\nScript. If your macros aren't fully compatible, you might be able to apply\nworkarounds or adjust the code to make them work with Apps Script.\n\nUse the Macro Converter's compatibility report to determine if you can\nautomatically convert your files as-is or if you need to make adjustments to\nyour code.\n\nWhen you generate a compatibility report, one of the following statuses is\napplied to each of your files and APIs:\n\n| Status | Definition |\n|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | These files contain APIs that all have direct equivalents in Apps Script. |\n| **Supported with workarounds** | These files contain at least one API that can be supported with a workaround. |\n| **Needs more investigation** | These files contain at least one API that you need to review to determine how to proceed. For instance, there might not be an equivalent API, or the Macro Converter might not have determined the API in use. |\n\nGenerate a compatibility report\n-------------------------------\n\n1. On your computer, open [Google Drive](https://drive.google.com/drive/my-drive).\n2. On the right side panel, click the Macro Converter add-on . If you don't see the side panel, at the bottom right, click Show side panel chevron_left.\n3. Click **Add files and folders**. The Macro Converter only recognizes Excel files.\n4. Choose the files or folders you want to analyze and click **Select**. Select fewer than 2,000 files at a time.\n5. To change where your compatibility report is saved, click Change destination folder edit, and select the folder you want. Otherwise, it's saved in your MyDrive folder.\n6. Click **Generate report**.\n7. When the analysis completes, click **View report**.\n\nReview the compatibility report\n-------------------------------\n\nUse the details in the compatibility report to help you decide how to proceed\nwith your file conversion. Your report includes the following sections:\n\n- **Summary**: This sheet gives an aggregated analysis of the compatibility of all submitted files and their APIs.\n- **Files - compatibility**: This sheet lists every file submitted to the Macro Converter with the compatibility status and details of each file.\n- **Files - detailed analysis**: This sheet gives more information about the\n APIs within a file and what actions you can take to successfully convert each\n API. First, from the top dropdown menu, select a file. Then, from the bottom\n dropdown menu, select a status.\n\n | **Note:** If multiple files have the same name, next to the file names, use the unique identifiers to tell the difference between them. You can open the files in Drive and look for the unique identifiers in the URLs: `https://drive.google.com/file/d/\u003cfile_identifier\u003e/view`.\n\nYou can also review the report on an API-by-API basis using the sheets called\n**APIs to investigate** and **APIs with workarounds**.\n\nDetermine how to proceed\n------------------------\n\nHere's what we recommend for each status:\n\n| Status | Recommendation |\n|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | The same logic from your VBA APIs will be replicable in Apps Script. [Proceed with the conversion](/apps-script/guides/macro-converter/convert-files). |\n| **Supported with workarounds** | You need to write code to replace at least one VBA API with the equivalent Apps Script API. In general, you can proceed with the conversion. You can manually replace the VBA APIs marked as *Supported with workarounds* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n| **Needs more investigation** | At least one API can't be converted. Depending on the importance of that API in your code, you might not be able to convert the file. Someone who understands the original VBA code should do the final evaluation. \u003cbr /\u003e If you decide to convert your file, you need to write code to replace at least one VBA API with Apps Script. You can manually replace the VBA APIs marked as *Needs investigation* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n\nAfter you assess your compatibility report, see [Convert VBA macros to Apps\nScript](/apps-script/guides/macro-converter/convert-files).\n\nRelated articles\n----------------\n\n- [Macro Converter add-on overview](/apps-script/guides/macro-converter/overview)\n- [Convert VBA macros to Apps Script](/apps-script/guides/macro-converter/convert-files)\n- [Fix errors in your converted code](/apps-script/guides/macro-converter/fix-conversion-errors)\n- [Address common issues](/apps-script/guides/macro-converter/address-conversion-issues)\n- [Watch Macro Converter tutorials](/apps-script/guides/macro-converter/tutorials)\n- [List of compatible VBA APIs](/apps-script/guides/macro-converter/compatible-vba-apis)"]]
.
Wenn die Seitenleiste nicht angezeigt wird, klicken Sie rechts unten auf „Seitenleiste einblenden“ .