Convertir macros de VBA en Apps Script

Antes de comenzar

Es posible que desees actualizar las APIs incompatibles en tu código de VBA antes de convertir los archivos. Para los archivos que tienen el estado Compatible exactamente, puedes continuar con el Paso 1: Convierte tus archivos.

Modifica las APIs de VBA incompatibles

Para los archivos que tienen el estado Compatible con la solución alternativa o Requiere investigación, puedes aplicar las soluciones alternativas y las correcciones después de la conversión en Apps Script, pero te recomendamos que modifiques el código 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, te recomendamos lo siguiente:

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

  • Para las APIs con el estado Requiere investigación, verifica si tu código contiene alguna de las siguientes APIs:

    • Adodb.connection
    • CreateObject: Esta API suele usarse para conectarse a una base de datos y un 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 los archivos

  1. En la computadora, abre Google Drive.
  2. En el panel lateral derecho, haz clic en el complemento de 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 quieras. De lo contrario, se guardarán en la carpeta Mi unidad.
  6. Haz clic en Convertir.
  7. Cuando se complete la conversión, haz clic en Ver resultados.

Paso 2: Prueba tus archivos convertidos

Ejecuta tu código de Apps Script

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

Prueba tus activadores

Si tus archivos contienen activadores como onOpen(), onEdit() o onClick(), prueba también los activadores. Algunos activadores de VBA no se convierten automáticamente y deben corregirse en Apps Script. Consulta el artículo Cómo solucionar problemas habituales.

Revisar los archivos ReadMe

Si se generó un archivo readme con el archivo convertido, revisa los problemas de conversión que se enumeran dentro del archivo.

  • Si los problemas podrían ser problemáticos para los 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 te encuentras con errores mientras pruebas los archivos, consulta Cómo corregir errores en el código convertido.

Si el código se ejecuta sin errores, pero el resultado no es el que esperabas, abre el archivo readme del archivo. Revisa cada sección para determinar la causa del problema y aplicar 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.