Convertir des macros VBA en Apps Script

Utilisez le module complémentaire Macro Converter pour convertir automatiquement vos fichiers Excel comportant du code Visual Basic for Applications (VBA) au format 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 Exactement compatible, 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 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 d’API VBA compatibles.

  • Pour les API Compatible 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 investigation, vérifiez si votre code contient l'une des API suivantes :

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

    Si vos macros utilisent ces API, envisagez de ne pas convertir ces fichiers. Ces API gèrent généralement des fonctions essentielles telles que la connectivité à une base de données ou l'accès à un système local, qu'Apps Script ne peut pas facilement répliquer.

Étape 1 : Convertir vos fichiers

  1. Sur votre ordinateur, ouvrez Google Drive.
  2. Dans le panneau latéral droit, 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. Macro Converter ne reconnaît que les fichiers Excel.
  4. Sélectionnez les fichiers ou les dossiers que vous souhaitez convertir, puis cliquez sur Sélectionner. Sélectionnez moins de 2 000 fichiers à la fois.
  5. Pour modifier l'emplacement d'enregistrement de 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 : Tester vos fichiers convertis

Après avoir converti vos fichiers, 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 normalement 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 la section Remédier aux 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 ce fichier.

  • 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 : Corriger 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 déterminer la cause du problème et appliquez le correctif recommandé.

Après avoir corrigé les erreurs, testez à nouveau le fichier pour vous assurer que tout fonctionne comme prévu.