Déterminer si les macros VBA sont compatibles

Un fichier Excel comportant 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 apporter des modifications à 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
Entièrement compatible 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 qui peut être compatible 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 peut ne pas y avoir d'API équivalente, ou Macro Converter peut ne pas avoir 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 droit, cliquez sur le module complémentaire Google Workspace Macro Converter Icône représentant le module complémentaire Macro Converter. 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 les dossiers que vous souhaitez analyser, puis cliquez sur Sélectionner. Sélectionnez moins de 2 000 fichiers à la fois.
  5. Pour modifier l'emplacement d'enregistrement de votre rapport de compatibilité, cliquez sur Modifier le dossier de destination , puis sélectionnez le dossier de votre choix. 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 comment procéder avec la conversion de votre fichier. Votre rapport comprend les sections suivantes :

  • Résumé : cette feuille fournit une analyse agrégée de la compatibilité de tous les fichiers envoyés et de leurs API.
  • Fichiers – Compatibilité : cette feuille liste tous les fichiers envoyés à Macro Converter 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 sur les actions que vous pouvez effectuer pour convertir chaque API. Tout d'abord, dans le menu déroulant en haut, sélectionnez un fichier. Ensuite, dans le menu déroulant en bas, sélectionnez un état.

Si plusieurs fichiers portent le même nom, utilisez les identifiants uniques à côté des noms de fichiers pour les différencier. Ouvrez les fichiers dans Drive et recherchez les identifiants uniques dans les URL : https://drive.google.com/file/d/<file_identifier>/view.

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

Déterminer comment procéder

Voici nos recommandations pour chaque état :

État Recommandation
Entièrement compatible La même logique que celle de vos API VBA est reproductible 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 général, vous pouvez procéder à la conversion.

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

Nécessite une enquête plus approfondie Au moins une API ne peut pas être convertie. Selon 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. Remplacez manuellement les API VBA marquées comme Nécessite une enquête avant ou après la conversion du fichier. Nous vous recommandons d'apporter vos modifications à l'avance.

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