Eine Excel-Datei mit VBA-Makros (Visual Basic for Applications) gilt als kompatibel, wenn alle in den Makros verwendeten APIs eine direkte Entsprechung in Apps Script haben. Wenn Ihre Makros nicht vollständig kompatibel sind, können Sie möglicherweise Umgehungslösungen anwenden oder den Code so anpassen, dass sie mit Apps Script funktionieren.
Anhand des Kompatibilitätsberichts des Makro-Konverters können Sie feststellen, ob Sie Ihre Dateien automatisch unverändert konvertieren können oder ob Sie Anpassungen am Code vornehmen müssen.
Wenn Sie einen Kompatibilitätsbericht generieren, wird auf jede Ihrer Dateien und APIs einer der folgenden Status angewendet:
| Status | Definition |
|---|---|
| Genau unterstützt | Diese Dateien enthalten APIs, die alle direkte Entsprechungen in Apps Script haben. |
| Unterstützung mit Problemumgehungen | Diese Dateien enthalten mindestens eine API, die mit einer Umgehung unterstützt werden kann. |
| Weitere Untersuchungen erforderlich | Diese Dateien enthalten mindestens eine API, die Sie prüfen müssen, um zu entscheiden, wie Sie fortfahren möchten. Möglicherweise gibt es beispielsweise keine entsprechende API oder der Makrokonverter hat die verwendete API nicht ermittelt. |
Kompatibilitätsbericht erstellen
- Öffnen Sie Google Drive auf dem Computer.
- Klicken Sie auf der rechten Seite auf das Add-on
für den Makrokonverter.
Wenn die Seitenleiste nicht angezeigt wird, klicken Sie rechts unten auf „Seitenleiste einblenden“ . - 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 weniger als 2.000 Dateien gleichzeitig aus.
- Wenn Sie ändern möchten, wo der Kompatibilitätsbericht gespeichert wird, klicken Sie auf „Zielverzeichnis ändern“ und wählen Sie den gewünschten Ordner aus. Andernfalls wird sie im Ordner „Meine Ablage“ gespeichert.
- Klicken Sie auf Bericht generieren.
- Klicken Sie nach Abschluss der Analyse auf Bericht ansehen.
Kompatibilitätsbericht prüfen
Anhand der Details im Kompatibilitätsbericht können Sie entscheiden, wie Sie mit der Dateikonvertierung fortfahren möchten. Der Bericht enthält die folgenden Abschnitte:
- Zusammenfassung: In diesem Tabellenblatt 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 den Macro Converter gesendet wurden, mit dem Kompatibilitätsstatus und Details zu den einzelnen Dateien.
Dateien – detaillierte Analyse: Auf diesem Blatt finden Sie weitere Informationen zu den APIs in einer Datei und zu den Aktionen, die Sie ausführen können, um die einzelnen APIs 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 für einzelne APIs verwenden. Verwenden Sie dazu die Tabellen Zu untersuchende APIs und APIs mit Behelfslösungen.
Legen Sie fest, wie Sie fortfahren möchten.
Hier sind unsere Empfehlungen für die einzelnen Status:
| Status | Empfehlung |
|---|---|
| Genau unterstützt | Die Logik Ihrer VBA-APIs kann in Apps Script repliziert werden. Fahren Sie mit der Umwandlung fort. |
| Unterstützt mit Problemumgehungen | Du musst Code schreiben, um mindestens eine VBA API durch die entsprechende Apps Script API zu ersetzen. Im Allgemeinen können Sie mit der Umwandlung fortfahren.
Sie können die VBA APIs, die als Mit Problemumgehungen unterstützt gekennzeichnet sind, entweder vor oder nach der Konvertierung der Datei manuell ersetzen. Wir empfehlen Ihnen, die Änderungen im Voraus vorzunehmen. |
| Weitere Untersuchungen erforderlich | Mindestens eine API kann nicht konvertiert werden. Je nachdem, wie wichtig diese API in Ihrem Code ist, können Sie die Datei möglicherweise nicht konvertieren.
Die endgültige Bewertung sollte von einer Person durchgeführt werden, die 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 VBA APIs, die mit Prüfung erforderlich gekennzeichnet sind, entweder vor oder nach der Konvertierung der Datei manuell ersetzen. Wir empfehlen Ihnen, die Änderungen im Voraus vorzunehmen. |
Nachdem Sie den Kompatibilitätsbericht ausgewertet haben, lesen Sie den Hilfeartikel VBA-Makros in Apps Script konvertieren.
Weitere Informationen
- Macro Converter-Add-on – Übersicht
- VBA-Makros in Apps Script konvertieren
- Fehler im konvertierten Code beheben
- Häufige Probleme beheben
- Anleitungen für den Makrokonverter ansehen
- Liste der kompatiblen VBA-APIs