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 di modificare il codice per renderle compatibili con Apps Script.

Utilizza il report di compatibilità di Macro Converter per determinare se è possibile 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 soluzione alternativa.
Richiede ulteriori indagini Questi file contengono almeno un'API che devi esaminare per determinare come procedere. Ad esempio, potrebbe non esistere un'API equivalente o il convertitore macro potrebbe non aver determinato l'API in uso.

Generare un report di compatibilità

  1. Apri Google Drive sul computer.
  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 di 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 di compatibilità, fai clic su Cambia cartella di destinazione e seleziona quella che ti interessa. In caso contrario, viene salvata nella cartella Il mio Drive.
  6. Fai clic su Genera report.
  7. Al termine dell'analisi, fai clic su Visualizza report.

Esaminare il report sulla compatibilità

Utilizza i dettagli contenuti nel 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 di macro insieme allo stato di compatibilità e ai dettagli di ciascun file.

  • File - analisi dettagliata: questo foglio fornisce ulteriori informazioni sulle API contenute in un file e sulle azioni che puoi intraprendere per convertire ciascuna 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 API per API utilizzando i fogli chiamati API da esaminare e API con soluzioni alternative.

Stabilire come procedere

Ecco cosa consigliamo 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 il codice per sostituire almeno un'API VBA con l'API Apps Script equivalente. In generale, puoi procedere con la conversione.

Puoi sostituire manualmente le API VBA contrassegnate come Supportato 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 dovrebbe 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 rapporto sulla compatibilità, consulta l'articolo Convertire le macro VBA in Apps Script.