Convertir des macros VBA en Apps Script

Avant de commencer

Vous pouvez mettre à jour les API incompatibles dans votre code VBA avant de convertir vos fichiers. Pour les fichiers dont l'état est Compatible exactement, vous pouvez passer à l'étape 1: Convertir vos fichiers.

Modifier les API VBA incompatibles

Pour les fichiers dont l'état est Compatible avec une solution de contournement ou Nécessite une investigation, vous pouvez appliquer vos solutions de contournement et corrections après la conversion dans Apps Script. Toutefois, nous vous recommandons de modifier d'abord le code VBA que vous connaissez avant de convertir vos fichiers.

Pour chaque API marquée comme Compatible avec une solution de contournement ou Nécessite une investigation dans le rapport de compatibilité, nous vous recommandons les mesures suivantes:

  • Si la fonction effectuée par l'API n'est pas essentielle au bon fonctionnement de votre macro VBA, supprimez-la de votre code VBA. Si c'est le cas, modifiez votre code pour implémenter un comportement similaire avec les API VBA compatibles.
  • Pour les API dont l'état est Compatible avec une solution de contournement, si vous ne pouvez pas passer aux API VBA compatibles, laissez vos API VBA telles quelles. Une solution de contournement connue pour cette API est recommandée dans les commentaires du code Apps Script converti après la conversion.
  • Si le problème provient d'un construct de langage non implémenté, réécrivez votre code pour éviter d'utiliser ces constructions.

  • Pour les API dont l'état est Needs investigation (Examen requis), vérifiez si votre code contient l'une des API suivantes:

    • Adodb.connection
    • CreateObject: cette API est souvent utilisée pour se connecter à des bases de données et à des logiciels de planification des ressources de l'entreprise.
    • Shell.execute
    • OleObject

    Si c'est le cas, nous vous recommandons de ne pas convertir les fichiers auxquels ces API appartiennent et d'examiner d'autres options. Ces API ont tendance à effectuer des opérations critiques pour une macro, comme se connecter à une base de données ou accéder à une ressource locale. Apps Script n'est généralement pas une bonne solution.

Étape 1: Convertissez vos fichiers

  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. Sélectionnez les fichiers ou dossiers à convertir, puis cliquez sur Sélectionner. Sélectionnez moins de 2 000 fichiers à la fois.
  5. Pour modifier l'emplacement où sont enregistrés vos fichiers convertis, cliquez sur Modifier le dossier de destination , puis sélectionnez le dossier souhaité. Sinon, les fichiers sont enregistrés dans votre dossier Mon Drive.
  6. Cliquez sur Convertir.
  7. Une fois la conversion terminée, cliquez sur Afficher les résultats.

Étape 2: Tester vos fichiers convertis

Exécuter votre code Apps Script

Après avoir converti vos fichiers, testez les fonctions Apps Script. Testez les fichiers convertis avec les données que vous utilisez habituellement avec vos fichiers Excel. Si possible, comparez la sortie de vos fichiers Sheets convertis à celle de vos fichiers Excel d'origine.

Tester vos déclencheurs

Si vos fichiers contiennent des déclencheurs tels que onOpen(), onEdit() ou onClick(), testez-les également. Certains déclencheurs VBA ne seront pas convertis automatiquement et devront être traités dans Apps Script. Consultez la section Résoudre les problèmes courants.

Examiner les fichiers ReadMe

Si un fichier ReadMe a été généré avec votre fichier converti, examinez les problèmes de conversion listés dans le fichier ReadMe.

  • Si les problèmes peuvent poser problème pour des cas que vous n'avez pas testés, appliquez les modifications recommandées à votre code.
  • Si vous avez testé tous les scénarios possibles et que tout fonctionne comme prévu, vous n'avez probablement pas besoin d'apporter de modifications.

Étape 3: Corrigez les erreurs

Si vous rencontrez des erreurs lors du test de vos fichiers, consultez Corriger les erreurs dans votre code converti.

Si le code s'exécute sans erreur, mais que le résultat ne correspond pas à vos attentes, ouvrez le fichier ReadMe. Examinez chaque section pour déterminer l'origine du problème et appliquer la solution recommandée.

Une fois les erreurs corrigées, testez à nouveau le fichier pour vous assurer que tout fonctionne comme prévu.