Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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 modificare il codice per farle funzionare con Apps Script.
Utilizza il report sulla compatibilità di Macro Converter 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 ciascuno dei tuoi file e delle tue 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.
Necessarie 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 di macro potrebbe non aver determinato l'API in uso.
Nel riquadro laterale a destra, fai clic sul componente aggiuntivo
Macro Converter .
Se non vedi il riquadro laterale, fai clic su Mostra riquadro
laterale chevron_left in basso a destra.
Fai clic su Aggiungi file e cartelle. Macro Converter riconosce solo i file Excel.
Scegli i file o le cartelle che vuoi analizzare e fai clic su Seleziona. Seleziona
meno di 2000 file alla volta.
Per modificare la posizione in cui viene salvato il report di compatibilità, fai clic su Cambia
cartella di destinazione edit e seleziona la
cartella che preferisci. In caso contrario, viene salvato nella cartella Il mio Drive.
Fai clic su Genera report.
Al termine dell'analisi, fai clic su Visualizza report.
Esaminare il report sulla compatibilità
Utilizza i dettagli del report sulla compatibilità per decidere come procedere
con la conversione del 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 a Macro
Converter 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, dal menu a discesa
in basso, seleziona uno stato.
Puoi anche esaminare il report API per API utilizzando i fogli denominati
API da esaminare e API 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 Supportate con
soluzioni alternative prima o dopo la conversione del file. Ti consigliamo di apportare le modifiche in anticipo.
Necessarie 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.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eVBA macros with direct Apps Script equivalents are considered compatible and can be automatically converted using the Macro Converter add-on.\u003c/p\u003e\n"],["\u003cp\u003eThe Macro Converter's compatibility report identifies files as "Supported exactly", "Supported with workarounds", or "Needs more investigation", guiding your conversion strategy.\u003c/p\u003e\n"],["\u003cp\u003eFor files needing workarounds or further investigation, manual code adjustments may be necessary before or after conversion using equivalent Apps Script APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe compatibility report provides detailed analysis at the file and API level to help assess conversion feasibility and required actions.\u003c/p\u003e\n"],["\u003cp\u003eAfter reviewing the report, proceed with file conversion, addressing potential issues as outlined in the documentation.\u003c/p\u003e\n"]]],[],null,["# Determine if VBA macros are compatible\n\nAn Excel file with Visual Basic for Applications (VBA) macros is considered\ncompatible if all APIs used in the macros have a direct equivalent in Apps\nScript. If your macros aren't fully compatible, you might be able to apply\nworkarounds or adjust the code to make them work with Apps Script.\n\nUse the Macro Converter's compatibility report to determine if you can\nautomatically convert your files as-is or if you need to make adjustments to\nyour code.\n\nWhen you generate a compatibility report, one of the following statuses is\napplied to each of your files and APIs:\n\n| Status | Definition |\n|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | These files contain APIs that all have direct equivalents in Apps Script. |\n| **Supported with workarounds** | These files contain at least one API that can be supported with a workaround. |\n| **Needs more investigation** | These files contain at least one API that you need to review to determine how to proceed. For instance, there might not be an equivalent API, or the Macro Converter might not have determined the API in use. |\n\nGenerate a compatibility report\n-------------------------------\n\n1. On your computer, open [Google Drive](https://drive.google.com/drive/my-drive).\n2. On the right side panel, click the Macro Converter add-on . If you don't see the side panel, at the bottom right, click Show side panel chevron_left.\n3. Click **Add files and folders**. The Macro Converter only recognizes Excel files.\n4. Choose the files or folders you want to analyze and click **Select**. Select fewer than 2,000 files at a time.\n5. To change where your compatibility report is saved, click Change destination folder edit, and select the folder you want. Otherwise, it's saved in your MyDrive folder.\n6. Click **Generate report**.\n7. When the analysis completes, click **View report**.\n\nReview the compatibility report\n-------------------------------\n\nUse the details in the compatibility report to help you decide how to proceed\nwith your file conversion. Your report includes the following sections:\n\n- **Summary**: This sheet gives an aggregated analysis of the compatibility of all submitted files and their APIs.\n- **Files - compatibility**: This sheet lists every file submitted to the Macro Converter with the compatibility status and details of each file.\n- **Files - detailed analysis**: This sheet gives more information about the\n APIs within a file and what actions you can take to successfully convert each\n API. First, from the top dropdown menu, select a file. Then, from the bottom\n dropdown menu, select a status.\n\n | **Note:** If multiple files have the same name, next to the file names, use the unique identifiers to tell the difference between them. You can open the files in Drive and look for the unique identifiers in the URLs: `https://drive.google.com/file/d/\u003cfile_identifier\u003e/view`.\n\nYou can also review the report on an API-by-API basis using the sheets called\n**APIs to investigate** and **APIs with workarounds**.\n\nDetermine how to proceed\n------------------------\n\nHere's what we recommend for each status:\n\n| Status | Recommendation |\n|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | The same logic from your VBA APIs will be replicable in Apps Script. [Proceed with the conversion](/apps-script/guides/macro-converter/convert-files). |\n| **Supported with workarounds** | You need to write code to replace at least one VBA API with the equivalent Apps Script API. In general, you can proceed with the conversion. You can manually replace the VBA APIs marked as *Supported with workarounds* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n| **Needs more investigation** | At least one API can't be converted. Depending on the importance of that API in your code, you might not be able to convert the file. Someone who understands the original VBA code should do the final evaluation. \u003cbr /\u003e If you decide to convert your file, you need to write code to replace at least one VBA API with Apps Script. You can manually replace the VBA APIs marked as *Needs investigation* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n\nAfter you assess your compatibility report, see [Convert VBA macros to Apps\nScript](/apps-script/guides/macro-converter/convert-files).\n\nRelated articles\n----------------\n\n- [Macro Converter add-on overview](/apps-script/guides/macro-converter/overview)\n- [Convert VBA macros to Apps Script](/apps-script/guides/macro-converter/convert-files)\n- [Fix errors in your converted code](/apps-script/guides/macro-converter/fix-conversion-errors)\n- [Address common issues](/apps-script/guides/macro-converter/address-conversion-issues)\n- [Watch Macro Converter tutorials](/apps-script/guides/macro-converter/tutorials)\n- [List of compatible VBA APIs](/apps-script/guides/macro-converter/compatible-vba-apis)"]]
.
Se non vedi il riquadro laterale, fai clic su Mostra riquadro
laterale in basso a destra.