Converti le macro VBA in Apps Script

Prima di iniziare

Potrebbe essere opportuno aggiornare le API incompatibili nel codice VBA prima di convertire i file. Per i file con lo stato Supportato esattamente, puoi andare al Passaggio 1: converti i file.

Modifica API VBA incompatibili

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

Per ogni API contrassegnata come Supportato con 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 Supportata con soluzione alternativa, se non puoi passare alle API VBA supportate, lascia le API VBA invariate. Dopo la conversione ad Apps Script, ti consigliamo di adottare una soluzione alternativa nota nei commenti del codice Apps Script convertito.
  • Se il problema proviene da un costrutto del linguaggio 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 esaminare 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 Apps Script in genere non è una buona soluzione.

Passaggio 1: converti i file

  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 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 cambiare la posizione in cui vengono salvati i file convertiti, fai clic su Cambia cartella di destinazione e seleziona la cartella che ti interessa. 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 risultati.

Passaggio 2: verifica i file convertiti

Eseguire il codice 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 di Fogli convertiti con l'output dei file Excel originali.

Testa gli attivatori

Esegui anche il test degli attivatori se i file contengono attivatori come onOpen(), onEdit() o onClick(). Alcuni trigger VBA non verranno convertiti automaticamente e devono essere risolti in Apps Script. Vedi Risolvere i problemi comuni.

Esamina i file Leggimi

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

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

Passaggio 3: correggi gli errori

Se si verificano errori durante il test dei file, consulta la sezione Correggere gli errori nel codice convertito.

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

Dopo aver corretto gli errori, verifica nuovamente il file per assicurarti che tutto funzioni come previsto.