VBA-Makros in Apps Script konvertieren

Mit dem Add-on „Macro Converter“ können Sie Ihre Excel-Dateien mit VBA-Code (Visual Basic for Applications) automatisch in Google Sheets und Apps Script konvertieren.

Hinweis

Möglicherweise möchten Sie inkompatible APIs in Ihrem VBA-Code aktualisieren, bevor Sie Ihre Dateien konvertieren. Bei Dateien mit dem Status Genau unterstützt können Sie mit Schritt 1: Dateien konvertieren fortfahren.

Inkompatible VBA-APIs ändern

Bei Dateien mit dem Status Mit Umgehungslösung unterstützt oder Untersuchung erforderlich können Sie Ihre Umgehungslösungen und Korrekturen nach der Konvertierung in Apps Script anwenden. Wir empfehlen jedoch, den VBA-Code mit dem Sie vertraut sind, zuerst zu ändern, bevor Sie Ihre Dateien konvertieren.

Für jede API, die im Kompatibilitätsbericht als Mit Umgehungslösung unterstützt oder Untersuchung erforderlich gekennzeichnet ist, empfehlen wir Folgendes:

  • Wenn die von der API ausgeführte Funktion für Ihr VBA-Makro nicht entscheidend ist, entfernen Sie sie aus Ihrem VBA-Code. Wenn die Funktion entscheidend ist, ändern Sie Ihren Code um ein ähnliches Verhalten mit unterstützten VBA APIs zu implementieren.

  • Wenn Sie für Mit Umgehungslösung unterstützt gekennzeichnete APIs keine unterstützte VBA-Alternative finden, lassen Sie Ihren VBA-Code unverändert. Suchen Sie nach der Konvertierung in den Kommentaren des Apps Script-Codes nach empfohlenen Umgehungslösungen.

  • Wenn das Problem auf ein nicht implementiertes Sprach konstrukt zurückzuführen ist, schreiben Sie Ihren Code so um, dass diese Konstrukte nicht verwendet werden.

  • Prüfen Sie bei APIs mit dem Status Untersuchung erforderlich, ob Ihr Code eine der folgenden APIs enthält:

    • Adodb.connection
    • CreateObject: Diese API wird häufig verwendet, um eine Verbindung zu Datenbank- und ERP-Software (Enterprise Resource Planning) herzustellen.
    • Shell.execute
    • OleObject

    Wenn Ihre Makros diese APIs verwenden, sollten Sie die Konvertierung dieser Dateien noch einmal überdenken. Diese APIs verwalten in der Regel kritische Funktionen wie die Datenbankverbindung oder den Zugriff auf das lokale System, die in Apps Script nicht einfach repliziert werden können.

Schritt 1: Dateien konvertieren

  1. Öffnen Sie Google Drive auf dem Computer.
  2. Klicken Sie in der rechten Seitenleiste auf das Add-on „Macro Converter“ Symbol für den Makrokonverter. Wenn die Seitenleiste nicht angezeigt wird, klicken Sie rechts unten auf „Seitenleiste einblenden“ .
  3. Klicken Sie auf Dateien und Ordner hinzufügen. Der Macro Converter erkennt nur Excel-Dateien.
  4. Wählen Sie die Dateien oder Ordner aus, die Sie konvertieren möchten, und klicken Sie auf Auswählen. Wählen Sie jeweils weniger als 2.000 Dateien aus.
  5. Wenn Sie den Speicherort für die konvertierten Dateien ändern möchten, klicken Sie auf „Zielordner ändern“ und wählen Sie den gewünschten Ordner aus. Andernfalls werden die Dateien im Ordner „Meine Ablage“ gespeichert.
  6. Klicken Sie auf Konvertieren.
  7. Klicken Sie nach Abschluss der Konvertierung auf Ergebnisse ansehen.

Schritt 2: Konvertierte Dateien testen

Testen Sie die konvertierten Dateien, um sicherzustellen, dass sie wie erwartet funktionieren.

Apps Script-Code ausführen

Testen Sie nach der Konvertierung der Dateien die Apps Script-Funktionen. Testen Sie die konvertierten Dateien mit den Daten, die Sie normalerweise mit Ihren Excel-Dateien verwenden. Vergleichen Sie nach Möglichkeit die Ausgabe der konvertierten Google Sheets-Dateien mit der Ausgabe der ursprünglichen Excel-Dateien.

Trigger testen

Wenn Ihre Dateien Trigger wie onOpen(), onEdit() oder onClick() enthalten, testen Sie auch diese. Einige VBA-Trigger werden nicht automatisch konvertiert und müssen in Apps Script behandelt werden. Weitere Informationen finden Sie unter Häufige Probleme beheben.

ReadMe-Dateien prüfen

Wenn mit der konvertierten Datei eine ReadMe-Datei generiert wurde, prüfen Sie die darin aufgeführten Konvertierungsprobleme.

  • Wenn die Probleme in Fällen auftreten können, die Sie nicht getestet haben, wenden Sie die empfohlenen Änderungen auf Ihren Code an.
  • Wenn Sie alle möglichen Szenarien getestet haben und alles wie vorgesehen funktioniert, müssen Sie wahrscheinlich keine Änderungen vornehmen.

Schritt 3: Fehler beheben

Wenn beim Testen Ihrer Dateien Fehler auftreten, lesen Sie den Hilfeartikel Fehler im konvertierten Code beheben.

Wenn der Code ohne Fehler ausgeführt wird, das Ergebnis aber nicht Ihren Erwartungen entspricht, öffnen Sie die ReadMe-Datei der Datei. Prüfen Sie die einzelnen Abschnitte, um die Ursache des Problems zu ermitteln, und wenden Sie die empfohlene Korrektur an.

Testen Sie die Datei nach dem Beheben der Fehler noch einmal, um sicherzustellen, dass alles wie vorgesehen funktioniert.