Convertir macros de VBA en Apps Script

Antes de comenzar

Te recomendamos que actualices las APIs incompatibles en tu código de VBA antes de convertir tus archivos. En el caso de los archivos que tienen el estado Compatible exactamente, puedes continuar con el Paso 1: Convierte tus archivos.

Modifica las APIs de VBA incompatibles

En el caso de los archivos que tienen el estado Se admite con una solución alternativa o Se necesita investigación, puedes aplicar las soluciones alternativas y correcciones después de la conversión en Apps Script, pero te recomendamos que primero modifiques el código de VBA con el que estés familiarizado antes de convertir los archivos.

Para cada API marcada como Compatible con una solución alternativa o Requiere investigación en el informe de compatibilidad, recomendamos lo siguiente:

  • Si la función que realiza la API no es fundamental para que la macro de VBA funcione correctamente, retírala de tu código de VBA. Si es así, cambia el código para implementar un comportamiento similar con las APIs de VBA compatibles.
  • En el caso de las APIs con el estado Se admite con una solución alternativa, si no puedes cambiar a las APIs de VBA compatibles, déjalas como están. Después de la conversión a Apps Script, se recomienda una solución alternativa conocida para esta API en los comentarios del código convertido de Apps Script.
  • Si el problema proviene de una construcción de lenguaje no implementada, reescribe el código para evitar usar esas construcciones.

  • En el caso de las APIs con el estado Se debe investigar, verifica si tu código contiene alguna de las siguientes APIs:

    • Adodb.connection
    • CreateObject: Esta API se suele usar para conectarse a bases de datos y software de planificación de recursos empresariales.
    • Shell.execute
    • OleObject

    Si es así, te recomendamos que no conviertas los archivos a los que pertenecen estas APIs y que investigues otras opciones. Estas APIs suelen realizar operaciones críticas para una macro, como conectarse a una base de datos o acceder a un recurso local, y Apps Script no suele ser una buena solución.

Paso 1: Convierte tus archivos

  1. En tu computadora, abre Google Drive.
  2. En el panel lateral derecho, haz clic en el complemento Macro Converter Ícono de Macro Converter. Si no ves el panel lateral, haz clic en Mostrar panel lateral en la esquina inferior derecha.
  3. Haz clic en Agregar archivos y carpetas. Macro Converter solo reconoce archivos de Excel.
  4. Elige los archivos o las carpetas que quieras convertir y haz clic en Seleccionar. Selecciona menos de 2,000 archivos a la vez.
  5. Para cambiar dónde se guardan los archivos convertidos, haz clic en Cambiar carpeta de destino y selecciona la carpeta que desees. De lo contrario, los archivos se guardan en tu carpeta de Mi unidad.
  6. Haz clic en Convertir.
  7. Cuando se complete la conversión, haz clic en Ver resultados.

Paso 2: Prueba los archivos convertidos

Ejecuta tu código de Apps Script

Después de convertir tus archivos, prueba las funciones de Apps Script. Prueba los archivos convertidos con los datos que usas normalmente con tus archivos de Excel. Si es posible, compara el resultado de los archivos de Hojas de cálculo convertidos con el de los archivos de Excel originales.

Prueba tus activadores

Si tus archivos contienen activadores como onOpen(), onEdit() o onClick(), prueba también los activadores. Algunos activadores de VBA no se convertirán automáticamente y deben abordarse en Apps Script. Consulta Cómo resolver problemas habituales.

Revisa los archivos Léeme

Si se generó un archivo readme con el archivo convertido, revisa los problemas de conversión que se indican en el archivo readme.

  • Si los problemas pueden ser problemáticos para casos que no probaste, aplica los cambios recomendados a tu código.
  • Si probaste todas las situaciones posibles y todo funciona según lo previsto, es probable que no necesites realizar cambios.

Paso 3: Corrige los errores

Si encuentras errores mientras pruebas tus archivos, consulta Cómo corregir errores en tu código convertido.

Si el código se ejecuta sin errores, pero el resultado no es el esperado, abre el archivo readme del archivo. Revisa cada sección para determinar qué está causando el problema y aplica la solución recomendada.

Después de corregir los errores, vuelve a probar el archivo para asegurarte de que todo funcione según lo previsto.