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 soluzione alternativa o Richiede indagine, puoi applicare le soluzioni alternative e le correzioni dopo la conversione in Apps Script, ma ti consigliamo di modificare prima il codice VBA che conosci, prima di convertire i file.

Per ogni API contrassegnata come Supportata con soluzione alternativa o Richiede indagine nel report di compatibilità, ti consigliamo di:

  • Se la funzione eseguita dall'API non è fondamentale per il corretto funzionamento della macro VBA, rimuovila dal codice VBA. In questo caso, 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 riesci a passare alle API VBA supportate, lasciale invariate. Dopo la conversione ad Apps Script, nei commenti del codice Apps Script convertito viene consigliata una soluzione alternativa nota per questa API.
  • Se il problema deriva da un costrutto di linguaggio non implementato, riscrivi il codice per evitare di utilizzare questi costrutti.
  • Per le API con lo stato Richiede indagine, controlla se il tuo 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 Apps Script in genere 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 Strumento di conversione delle macro Icona di 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 modificare la posizione in cui vengono salvati i file convertiti, fai clic su Cambia 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 risultati.

Passaggio 2: prova i file convertiti

Eseguire il codice Apps Script

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

Testare i trigger

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

Esaminare 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 i 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 si verificano 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.