Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Un fichier Excel avec des macros Visual Basic for Applications (VBA) est considéré comme compatible si toutes les API utilisées dans les macros ont un équivalent direct dans Apps Script. Si vos macros ne sont pas entièrement compatibles, vous pourrez peut-être appliquer des solutions de contournement ou ajuster le code pour qu'elles fonctionnent avec Apps Script.
Utilisez le rapport de compatibilité de Macro Converter pour déterminer si vous pouvez convertir automatiquement vos fichiers tels quels ou si vous devez ajuster votre code.
Lorsque vous générez un rapport de compatibilité, l'un des états suivants est appliqué à chacun de vos fichiers et API :
État
Définition
Prise en charge exacte
Ces fichiers contiennent des API qui ont toutes des équivalents directs dans Apps Script.
Pris en charge avec des solutions de contournement
Ces fichiers contiennent au moins une API qui peut être prise en charge avec une solution de contournement.
Nécessite une enquête plus approfondie
Ces fichiers contiennent au moins une API que vous devez examiner pour déterminer comment procéder. Par exemple, il se peut qu'il n'existe pas d'API équivalente ou que le convertisseur de macros n'ait pas déterminé l'API utilisée.
Dans le panneau de droite, cliquez sur le module complémentaire Macro Converter .
Si le panneau latéral ne s'affiche pas, cliquez sur Afficher le panneau latéral chevron_left en bas à droite.
Cliquez sur Ajouter des fichiers et des dossiers. Macro Converter ne reconnaît que les fichiers Excel.
Choisissez les fichiers ou dossiers que vous souhaitez analyser, puis cliquez sur Sélectionner. Sélectionnez moins de 2 000 fichiers à la fois.
Pour modifier l'emplacement d'enregistrement de votre rapport de compatibilité, cliquez sur Modifier le dossier de destination edit, puis sélectionnez le dossier de votre choix. Sinon, il est enregistré dans votre dossier "Mon Drive".
Cliquez sur Générer un rapport.
Une fois l'analyse terminée, cliquez sur Afficher le rapport.
Examiner le rapport de compatibilité
Utilisez les informations du rapport de compatibilité pour vous aider à décider comment procéder à la conversion de votre fichier. Votre rapport comprend les sections suivantes :
Récapitulatif : cette feuille fournit une analyse globale de la compatibilité de tous les fichiers envoyés et de leurs API.
Fichiers – Compatibilité : cette feuille liste tous les fichiers envoyés au convertisseur de macros, ainsi que l'état de compatibilité et les détails de chaque fichier.
Fichiers : analyse détaillée : cette feuille fournit plus d'informations sur les API d'un fichier et sur les actions que vous pouvez effectuer pour convertir chaque API. Tout d'abord, sélectionnez un fichier dans le menu déroulant en haut de la page. Ensuite, sélectionnez un état dans le menu déroulant en bas de l'écran.
Vous pouvez également examiner le rapport API par API à l'aide des feuilles API à examiner et API avec solutions de contournement.
Déterminer comment procéder
Voici ce que nous vous recommandons de faire pour chaque état :
État
Recommandation
Prise en charge exacte
La même logique que celle de vos API VBA sera réplicable dans Apps Script.
Procédez à la conversion.
Pris en charge avec des solutions de contournement
Vous devez écrire du code pour remplacer au moins une API VBA par l'API Apps Script équivalente. En général, vous pouvez procéder à la conversion.
Vous pouvez remplacer manuellement les API VBA marquées comme Prises en charge avec des solutions de contournement avant ou après la conversion du fichier. Nous vous recommandons d'effectuer vos modifications à l'avance.
Nécessite une enquête plus approfondie
Au moins une API ne peut pas être convertie. En fonction de l'importance de cette API dans votre code, il est possible que vous ne puissiez pas convertir le fichier.
L'évaluation finale doit être effectuée par une personne qui comprend le code VBA d'origine.
Si vous décidez de convertir votre fichier, vous devez écrire du code pour remplacer au moins une API VBA par Apps Script. Vous pouvez remplacer manuellement les API VBA marquées comme Nécessite une étude avant ou après la conversion du fichier. Nous vous recommandons d'effectuer vos modifications à l'avance.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 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)"]]
.
Si le panneau latéral ne s'affiche pas, cliquez sur Afficher le panneau latéral en bas à droite.