Déterminer si les macros VBA sont compatibles

Un fichier Excel contenant 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 pouvez peut-être trouver des solutions de contournement ou ajuster le code pour les faire fonctionner 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 apporter des ajustements à 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
Compatible exactement Ces fichiers contiennent des API qui ont toutes des équivalents directs dans Apps Script.
Compatible avec des solutions de contournement Ces fichiers contiennent au moins une API compatible avec une solution de contournement.
Examen approfondi requis Ces fichiers contiennent au moins une API que vous devez examiner pour déterminer la marche à suivre. Par exemple, il se peut qu'il n'y ait pas d'API équivalente ou que le convertisseur de macro n'ait pas déterminé l'API utilisée.

Générer un rapport de compatibilité

  1. Sur votre ordinateur, ouvrez Google Drive.
  2. Dans le panneau latéral de droite, cliquez sur le module complémentaire Macro Converter Icône du convertisseur macro. Si le panneau latéral ne s'affiche pas, cliquez sur Afficher le panneau latéral en bas à droite.
  3. Cliquez sur Ajouter des fichiers et des dossiers. Macro Converter ne reconnaît que les fichiers Excel.
  4. Sélectionnez les fichiers ou dossiers que vous souhaitez analyser, puis cliquez sur Sélectionner. Sélectionnez moins de 2 000 fichiers à la fois.
  5. Pour modifier l'emplacement de votre rapport de compatibilité, cliquez sur Modifier le dossier de destination , puis sélectionnez le dossier souhaité. Sinon, il est enregistré dans votre dossier "Mon Drive".
  6. Cliquez sur Générer un rapport.
  7. 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 de la suite de la conversion de vos fichiers. Votre rapport comprend les sections suivantes:

  • Résumé: 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 macro, avec 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 les actions que vous pouvez effectuer pour convertir chaque API. Commencez par sélectionner un fichier dans le menu déroulant du haut. Ensuite, dans le menu déroulant du bas, sélectionnez un état.

Vous pouvez également examiner le rapport par API à l'aide des feuilles intitulées API à examiner et API avec des solutions de contournement.

Déterminer la marche à suivre

Voici nos recommandations pour chaque état:

État Recommandation
Compatible exactement La même logique que celle de vos API VBA pourra être reproduite dans Apps Script. Procédez à la conversion.
Compatible avec des solutions de contournement Vous devez écrire du code pour remplacer au moins une API VBA par l'API Apps Script équivalente. En règle générale, vous pouvez procéder à la conversion.

Vous pouvez remplacer manuellement les API VBA marquées comme Compatibles avec des solutions de contournement avant ou après la conversion du fichier. Nous vous recommandons de faire vos modifications à l'avance.

Examen approfondi requis Au moins une API ne peut pas être convertie. En fonction de l'importance de cette API dans votre code, vous ne pourrez peut-être pas convertir le fichier. Une personne qui comprend le code VBA d'origine doit effectuer l'évaluation finale.

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 investigation avant ou après la conversion du fichier. Nous vous recommandons d'effectuer vos modifications au préalable.

Après avoir évalué votre rapport de compatibilité, consultez Convertir des macros VBA en Apps Script.