Converti le macro VBA in Apps Script

Prima di iniziare

Ti consigliamo di aggiornare le API incompatibili nel codice VBA prima di convertire i file. Per i file con lo stato Supportato esattamente, puoi procedere al passaggio 1: converti i file.

Modificare le API VBA incompatibili

Per i file con lo stato Supportato con una soluzione alternativa o Richiede indagini, puoi applicare le soluzioni alternative e le correzioni dopo la conversione in Apps Script, ma ti consigliamo di modificare prima il codice VBA di cui hai familiarità, prima di convertire i file.

Per ogni API contrassegnata come Supportata con una soluzione alternativa o Richiede indagine nel report sulla compatibilità, consigliamo quanto segue:

  • Se la funzione eseguita dall'API non è fondamentale per il corretto funzionamento della macro VBA, rimuovila dal codice VBA. In caso affermativo, modifica il codice per implementare un comportamento simile con le API VBA supportate.
  • Per le API con lo stato Supportato con una soluzione alternativa, se non riesci a passare alle API VBA supportate, lascia le API VBA invariate. Dopo la conversione in Apps Script, nei commenti del codice di Apps Script convertito è consigliata una soluzione alternativa nota per questa API.
  • Se il problema è causato da un strumento linguistico non implementato, riscrivi il codice per evitare di utilizzare questi costrutti.

  • Per le API con lo stato Richiede indagine, controlla se il codice contiene una delle seguenti API:

    • Adodb.connection
    • CreateObject: questa API viene spesso utilizzata per connettersi a database e software di pianificazione delle risorse aziendali.
    • Shell.execute
    • OleObject

    In caso affermativo, ti consigliamo di non convertire i file a cui appartengono queste API e di valutare altre opzioni. Queste API tendono a eseguire operazioni critiche per una macro, come la connessione a un database o l'accesso a una risorsa locale, e in genere Apps Script non è una buona soluzione.

Passaggio 1: converti i file

  1. Sul computer, apri Google Drive.
  2. Nel riquadro laterale a destra, fai clic sul componente aggiuntivo Convertitore di macro Icona del convertitore 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 che vuoi convertire e fai clic su Seleziona. Seleziona meno di 2000 file alla volta.
  5. Per modificare la posizione in cui vengono salvati i file convertiti, fai clic su Modifica cartella di destinazione e seleziona la cartella che preferisci. In caso contrario, i file vengono salvati nella cartella Il mio Drive.
  6. Fai clic su Converti.
  7. Al termine della conversione, fai clic su Visualizza i risultati.

Passaggio 2: testa i file convertiti

Eseguire il codice di Apps Script

Dopo aver convertito i file, testa le funzioni di Apps Script. Verifica i file convertiti con i dati che utilizzi normalmente con i file Excel. Se possibile, confronta l'output dei file convertiti di Fogli con quello dei file Excel originale.

Testare gli attivatori

Se i file contengono trigger come onOpen(), onEdit() o onClick(), testa anche i trigger. Alcuni attivatori VBA non vengono convertiti automaticamente e devono essere indirizzati in Apps Script. Vedi Risolvere i problemi comuni.

Esamina i file ReadMe

Se è stato generato un file README con il file convertito, esamina i problemi di conversione elencati nel file README.

  • Se i problemi potrebbero essere problematici per casi che non hai testato, applica le modifiche consigliate al codice.
  • Se hai testato tutti gli scenari possibili e tutto funziona come previsto, probabilmente non devi apportare modifiche.

Passaggio 3: correggi gli errori

Se riscontri errori durante il test dei file, consulta Correggere gli errori nel codice convertito.

Se il codice viene eseguito senza errori, ma il risultato non è quello previsto, apri il file ReadMe del file. Esamina ogni sezione per determinare la causa del problema e applica la correzione consigliata.

Dopo aver corretto gli errori, testa di nuovo il file per assicurarti che tutto funzioni come previsto.