Determinare se le macro VBA sono compatibili

Un file Excel con macro Visual Basic for Applications (VBA) è considerato compatibile se tutte le API utilizzate nelle macro hanno un equivalente diretto in Apps Script. Se le macro non sono completamente compatibili, potresti essere in grado di applicare soluzioni alternative o modificare il codice in modo che funzionino con Apps Script.

Utilizza il report sulla compatibilità del Convertitore di macro per determinare se puoi convertire automaticamente i file così come sono o se devi apportare modifiche al codice.

Quando generi un report sulla compatibilità, a ogni file e API viene applicato uno dei seguenti stati:

Stato Definizione
Supportato esattamente Questi file contengono API che hanno tutte equivalenti diretti in Apps Script.
Supportato con soluzioni alternative Questi file contengono almeno un'API che può essere supportata con una workaround.
Richiede ulteriori indagini Questi file contengono almeno un'API che devi esaminare per determinare come procedere. Ad esempio, potrebbe non esserci un'API equivalente o il Convertitore di macro potrebbe non aver determinato l'API in uso.

Generare un report sulla compatibilità

  1. Sul computer, apri Google Drive.
  2. Nel riquadro laterale a destra, fai clic sul plug-in Icona del convertitore di macroConvertitore di macro. Se non vedi il riquadro laterale, fai clic su Mostra riquadro laterale in basso a destra.
  3. Fai clic su Aggiungi file e cartelle. Macro Converter riconosce solo i file Excel.
  4. Scegli i file o le cartelle da analizzare e fai clic su Seleziona. Seleziona meno di 2000 file alla volta.
  5. Per modificare la posizione in cui viene salvato il report sulla compatibilità, fai clic su Cambia cartella di destinazione e seleziona la cartella che preferisci. In caso contrario, viene salvato nella cartella Il mio Drive.
  6. Fai clic su Genera report.
  7. Al termine dell'analisi, fai clic su Visualizza report.

Esamina il report sulla compatibilità

Utilizza i dettagli del report sulla compatibilità per decidere come procedere con la conversione dei file. Il report include le seguenti sezioni:

  • Riepilogo: questo foglio fornisce un'analisi aggregata della compatibilità di tutti i file inviati e delle relative API.
  • File - compatibilità: questo foglio elenca tutti i file inviati a Macro Converter con lo stato di compatibilità e i dettagli di ciascun file.

  • File - analisi dettagliata: questo foglio fornisce ulteriori informazioni sulle API all'interno di un file e sulle azioni che puoi intraprendere per convertire correttamente ogni API. Innanzitutto, seleziona un file dal menu a discesa in alto. Poi, dal menu a discesa in basso, seleziona uno stato.

Puoi anche esaminare il report per API utilizzando i fogli API da esaminare e API con soluzioni alternative.

Decidi come procedere

Ecco i nostri consigli per ogni stato:

Stato Suggerimento
Supportato esattamente La stessa logica delle API VBA sarà replicabile in Apps Script. Procedi con la conversione.
Supportato con soluzioni alternative Devi scrivere codice per sostituire almeno un'API VBA con l'API Apps Script equivalente. In genere, puoi procedere con la conversione.

Puoi sostituire manualmente le API VBA contrassegnate come Supportate con soluzioni alternative prima o dopo la conversione del file. Ti consigliamo di apportare le modifiche in anticipo.

Richiede ulteriori indagini Non è possibile convertire almeno un'API. A seconda dell'importanza di questa API nel codice, potresti non essere in grado di convertire il file. La valutazione finale deve essere eseguita da una persona che comprenda il codice VBA originale.

Se decidi di convertire il file, devi scrivere codice per sostituire almeno un'API VBA con Apps Script. Puoi sostituire manualmente le API VBA contrassegnate come Richiede indagine prima o dopo la conversione del file. Ti consigliamo di apportare le modifiche in anticipo.

Dopo aver valutato il report sulla compatibilità, consulta Convertire le macro VBA in Apps Script.