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 o modifiche al codice per farle funzionare 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 essere disponibile 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 componente aggiuntivo Macro Converter Icona Macro Converter. 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 che vuoi 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 al convertitore macro con lo stato di compatibilità e i dettagli di ogni 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, seleziona uno stato dal menu a discesa in basso.

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

Stabilisci come procedere

Ecco cosa consigliamo per ogni stato:

Stato Suggerimento
Supportato esattamente La stessa logica delle tue 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 il 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à, vedi Convertire le macro VBA in Apps Script.