Kompatibilität der VBA-Makros ermitteln

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.

Im Kompatibilitätsbericht des Macro Converter können Sie sehen, ob Sie Ihre Dateien automatisch konvertieren können oder ob Sie Anpassungen am Code vornehmen müssen.

Wenn Sie einen Kompatibilitätsbericht erstellen, wird jeder Ihrer Dateien und APIs einer der folgenden Status zugewiesen:

Status Definition
Vollständig unterstützt Diese Dateien enthalten APIs, die alle ein direktes Äquivalent in Apps Script haben.
Mit Problemumgehungen unterstützt Diese Dateien enthalten mindestens eine API, die mit einer Problemumgehung unterstützt werden kann.
Weitere Untersuchung erforderlich Diese Dateien enthalten mindestens eine API, die Sie überprüfen müssen, um zu bestimmen, wie Sie vorgehen. Möglicherweise gibt es keine entsprechende API oder der Macro Converter hat die verwendete API nicht erkannt.

Kompatibilitätsbericht erstellen

  1. Öffnen Sie auf dem Computer Google Drive.
  2. Klicken Sie in der Seitenleiste rechts auf das Macro Converter Google Workspace-Add-on Symbol für das Add-on „Macro Converter“. Wenn die Seitenleiste nicht angezeigt wird, klicken Sie rechts unten auf „Seitenleiste einblenden“ Show side panel .
  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 analysieren 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 den Kompatibilitätsbericht ändern möchten, klicken Sie auf „Zielordner ändern“ , und wählen Sie den gewünschten Ordner aus. Andernfalls wird er im Ordner „Meine Ablage“ gespeichert.
  6. Klicken Sie auf Bericht generieren.
  7. Wenn die Analyse abgeschlossen ist, klicken Sie auf Bericht ansehen.

Kompatibilitätsbericht prüfen

Anhand der Details im Kompatibilitätsbericht können Sie entscheiden, wie Sie mit der Dateikonvertierung fortfahren. Der Bericht enthält die folgenden Abschnitte:

  • Zusammenfassung: In diesem Tabellenblatt finden Sie eine aggregierte Analyse der Kompatibilität von allen eingereichten Dateien und ihren APIs.
  • Dateien – Kompatibilität: In diesem Tabellenblatt sind alle Dateien aufgeführt, die an den 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 zu den Maßnahmen, die 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.

Wenn mehrere Dateien denselben Namen haben, verwenden Sie neben den Dateinamen die eindeutigen IDs, um sie zu unterscheiden. Öffnen Sie die Dateien in Drive und suchen Sie in den URLs nach den eindeutigen IDs: https://drive.google.com/file/d/<file_identifier>/view.

Sie können den Bericht auch API-basiert in den Tabellenblättern Zu untersuchende APIs und APIs mit Problemumgehungen prüfen.

Vorgehensweise festlegen

Hier sind unsere Empfehlungen für die einzelnen Status:

Status Empfehlung
Vollständig unterstützt Die gleiche Logik Ihrer VBA-APIs kann in Apps Script repliziert werden. Fahren Sie mit der Konvertierung fort.
Mit Problemumgehungen unterstützt 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 Problemumgehungen unterstützt gekennzeichneten VBA-APIs entweder vor oder nach der Konvertierung der Datei manuell ersetzen. Wir empfehlen die Änderungen vorher 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. 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. Ersetzen Sie die als Weitere Untersuchung erforderlich gekennzeichneten VBA-APIs entweder vor oder nach der Konvertierung der Datei manuell. Wir empfehlen, die Änderungen vorher vorzunehmen.

Nachdem Sie den Kompatibilitätsbericht geprüft haben, lesen Sie VBA-Makros in Apps Script konvertieren.