Eine Excel-Datei mit Makros für Visual Basic for Applications (VBA) 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 Behelfslösungen anwenden oder den Code anpassen, damit sie mit Apps Script funktionieren.
Ermitteln Sie anhand des Kompatibilitätsberichts des Macro Converters, ob Sie Ihre Dateien automatisch unverändert konvertieren können oder ob Sie Anpassungen an Ihrem Code vornehmen müssen.
Wenn Sie einen Kompatibilitätsbericht erstellen, wird einer der folgenden Status auf jede Ihrer Dateien und APIs angewendet:
| Status | Definition |
|---|---|
| Genau unterstützt | Diese Dateien enthalten APIs, die alle direkte Äquivalente in Apps Script haben. |
| Unterstützt mit Behelfslösungen | Diese Dateien enthalten mindestens eine API, die mit einer Behelfslösung unterstützt werden kann. |
| Weitere Untersuchung erforderlich | Diese Dateien enthalten mindestens eine API, die Sie prüfen müssen, um das weitere Vorgehen festzulegen. Es kann beispielsweise sein, dass es keine entsprechende API gibt oder der Makrokonverter die verwendete API nicht ermittelt hat. |
Kompatibilitätsbericht erstellen
- Öffnen Sie Google Drive auf dem Computer.
- Klicken Sie in der rechten Seitenleiste auf das Add-on Macro Converter
.
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 den Speicherort des Kompatibilitätsberichts ändern möchten, klicken Sie auf „Zielordner ändern“ und wählen Sie den gewünschten Ordner aus. Andernfalls wird sie im Ordner „Meine Ablage“ gespeichert.
- Klicken Sie auf Bericht erstellen.
- Klicken Sie nach Abschluss der Analyse auf Bericht ansehen.
Kompatibilitätsbericht ansehen
Anhand der Details im Kompatibilitätsbericht können Sie entscheiden, wie Sie mit der Dateikonvertierung fortfahren möchten. Der Bericht umfasst die folgenden Abschnitte:
- Zusammenfassung: Dieses Tabellenblatt enthält eine Zusammenfassung der Kompatibilität aller eingereichten Dateien und ihrer APIs.
- Dateien – Kompatibilität: Auf dieser Tabelle sind alle an den Macro Converter gesendeten Dateien mit dem Kompatibilitätsstatus und den Details jeder Datei aufgeführt.
Dateien – detaillierte Analyse: Diese Tabelle enthält weitere Informationen zu den APIs in einer Datei und dazu, welche Aktionen 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 prüfen. Verwenden Sie dazu die Tabellen Zu untersuchende APIs und APIs mit Behelfslösungen.
Festlegen, wie fortfahren soll
Empfehlungen für jeden Status:
| Status | Empfehlung |
|---|---|
| Genau unterstützt | Die Logik Ihrer VBA APIs kann auch in Apps Script repliziert werden. Fahren Sie mit der Umwandlung fort. |
| Unterstützt mit Behelfslösungen | 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 Umwandlung fortfahren.
Sie können die VBA APIs, die als Mit Behelfslösungen unterstützt gekennzeichnet sind, entweder vor oder nach der Dateikonvertierung manuell ersetzen. Wir empfehlen Ihnen, Ihre Änderungen vorab vorzunehmen. |
| Weitere Untersuchung 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.
Jemand, der den ursprünglichen VBA-Code versteht, sollte die endgültige Bewertung vornehmen.
Wenn Sie die Datei konvertieren möchten, müssen Sie Code schreiben, um mindestens eine VBA API durch Apps Script zu ersetzen. Sie können die mit Prüfung erforderlich gekennzeichneten VBA APIs entweder vor oder nach der Dateikonvertierung manuell ersetzen. Wir empfehlen Ihnen, Ihre Änderungen vorab vorzunehmen. |
Nachdem Sie sich Ihren Kompatibilitätsbericht angesehen haben, lesen Sie den Artikel VBA-Makros in Apps Script konvertieren.
Weitere Informationen
- Übersicht über das Add-on „Macro Converter“
- VBA-Makros in Apps Script umwandeln
- Fehler im konvertierten Code beheben
- Häufige Probleme beheben
- Anleitungen zum Makrokonverter ansehen
- Liste kompatibler VBA APIs