Convertir des macros VBA en Apps Script

Utilisez le module complémentaire Macro Converter pour convertir automatiquement vos fichiers Excel avec du code Visual Basic for Applications (VBA) en fichiers Sheets et 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 Pris en charge exactement, vous pouvez passer à l'étape 1 : Convertissez vos fichiers.

Modifier les API VBA incompatibles

Pour les fichiers dont l'état est Pris en charge avec une solution de contournement ou Nécessite une enquête, vous pouvez appliquer vos solutions de contournement et vos correctifs 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 de procéder comme suit :

  • Si la fonction exécutée par l'API n'est pas essentielle à votre macro VBA, supprimez-la de votre code VBA. Si la fonction est essentielle, modifiez votre code pour implémenter un comportement similaire à l'aide des API VBA compatibles.

  • Pour les API compatibles avec une solution de contournement, si vous ne trouvez pas d'alternative VBA compatible, laissez votre code VBA tel quel. Après la conversion, recherchez les solutions de contournement recommandées dans les commentaires du code Apps Script.

  • Si le problème provient d'une construction de langage non implémentée, réécrivez votre code pour éviter d'utiliser ces constructions.

  • Pour les API dont l'état est Nécessite une enquête, vérifiez si votre code contient l'une des API suivantes :

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

    Si vos macros utilisent ces API, réfléchissez bien avant de convertir ces fichiers. Ces API gèrent généralement des fonctions critiques telles que la connectivité aux bases de données ou l'accès au système local, qu'Apps Script ne peut pas répliquer facilement.

É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 de 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. Le convertisseur de macros 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 de votre choix. 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 : Testez vos fichiers convertis

Une fois vos fichiers convertis, testez-les pour vous assurer qu'ils fonctionnent comme prévu.

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 Google Sheets convertis avec 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 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 être problématiques pour les 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 n'est pas celui attendu, ouvrez le fichier ReadMe du fichier. Examinez chaque section pour identifier la cause du problème et appliquer la correction recommandée.

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