Convertir des macros VBA en Apps Script

Avant de commencer

Vous pouvez mettre à jour des 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: Convertissez vos fichiers.

Modifier les API VBA non compatibles

Pour les fichiers dont l'état est Compatible avec une solution de contournement ou Examen requis, vous pouvez appliquer vos solutions de contournement et vos correctifs après la conversion dans Apps Script. Toutefois, nous vous recommandons de commencer par modifier le code VBA que vous connaissez avant de convertir vos fichiers.

Pour chaque API marquée comme Compatible avec une solution de contournement ou Examen requis dans le rapport de compatibilité, nous recommandons ce qui suit:

  • Si la fonction exécuté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 mettre en œuvre un comportement similaire avec les API VBA compatibles.
  • Si vous ne pouvez pas passer aux API VBA compatibles avec l'état Compatible avec la solution de contournement, laissez vos API VBA telles quelles. Après la conversion vers Apps Script, une solution de contournement connue pour cette API est recommandée dans les commentaires du code Apps Script converti.
  • Si le problème provient d'une construction de langage non implémenté, réécrivez votre code pour éviter d'utiliser ces constructions.

  • Pour les API présentant l'état 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 à une base de données et à un logiciel de planification des ressources d'entreprise.
    • Shell.execute
    • OleObject

    Si c'est le cas, nous vous recommandons de ne pas convertir les fichiers auxquels ces API appartiennent et de rechercher 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. Choisissez 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 enregistrer vos fichiers convertis, cliquez sur Changer 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: Testez 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 normalement 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 également vos déclencheurs. Certains déclencheurs VBA ne sont pas convertis automatiquement et doivent être traités dans Apps Script. Consultez la page 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 répertoriés dans ce fichier.

  • 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'aurez 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 le code converti.

Si le code s'exécute sans erreur, mais que le résultat ne correspond pas à vos attentes, ouvrez le fichier ReadMe du fichier. Passez en revue chaque section pour déterminer la cause du problème et appliquez la correction recommandée.

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