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 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 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
Exactement compatible Ces fichiers contiennent des API qui ont tous un équivalent direct dans Apps Script.
Compatible avec des solutions alternatives Ces fichiers contiennent au moins une API compatible avec une solution de contournement.
Examen supplémentaire 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'existe pas d'API équivalente ou que Macro Converter 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 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. Choisissez 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 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.

Consulter le rapport sur la compatibilité

Utilisez les détails du rapport de compatibilité pour vous aider à décider comment convertir vos fichiers. Votre rapport comprend les sections suivantes:

  • Résumé: cette fiche fournit une analyse agrégée de la compatibilité de tous les fichiers envoyés et de leurs API.
  • Files - Compatibilité (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 les actions à effectuer pour convertir chaque API. Tout d'abord, dans le menu déroulant supérieur, sélectionnez un fichier. Ensuite, dans le menu déroulant du bas, sélectionnez un état.

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

Déterminer comment procéder

Voici nos recommandations pour chaque état:

État Recommandation
Exactement compatible La logique de vos API VBA peut être répliquée dans Apps Script. Procédez à la conversion.
Compatible avec des solutions alternatives 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 au préalable.

Examen supplémentaire requis 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 afin de remplacer au moins une API VBA par Apps Script. Vous pouvez remplacer manuellement les API VBA marquées comme Needs investigation (Investigation requise) avant ou après la conversion du fichier. Nous vous recommandons d'apporter vos modifications au préalable.

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