Cómo determinar si las macros de VBA son compatibles

Un archivo de Excel con macros de Visual Basic para aplicaciones (VBA) se considera compatible si todas las APIs que se usan en las macros tienen un equivalente directo en Apps Script. Si tus macros no son completamente compatibles, es posible que puedas aplicar soluciones alternativas o ajustar el código para que funcionen con Apps Script.

Usa el informe de compatibilidad de Macro Converter para determinar si puedes convertir automáticamente tus archivos tal como están o si necesitas realizar ajustes en tu código.

Cuando generas un informe de compatibilidad, se aplica uno de los siguientes estados a cada uno de tus archivos y APIs:

Estado Definición
Totalmente compatible Estos archivos contienen APIs que tienen equivalentes directos en Apps Script.
Compatible con soluciones alternativas Estos archivos contienen al menos una API que se puede admitir con una solución alternativa.
Requiere más investigación Estos archivos contienen al menos una API que debes revisar para determinar cómo proceder. Por ejemplo, es posible que no haya una API equivalente API o que Macro Converter no haya determinado la API en uso.

Genera un informe de compatibilidad

  1. En tu computadora, abre Google Drive.
  2. En el panel lateral derecho, haz clic en el complemento de Macro Converter de Google Workspace Ícono que representa el complemento de Macro Converter. Si no ves el panel lateral, en la esquina inferior derecha, haz clic en Mostrar panel lateral .
  3. Haz clic en Agregar archivos y carpetas. Macro Converter solo reconoce archivos de Excel.
  4. Elige los archivos o las carpetas que deseas analizar y haz clic en Seleccionar. Selecciona menos de 2,000 archivos a la vez.
  5. Para cambiar la ubicación en la que se guarda el informe de compatibilidad, haz clic en Cambiar carpeta de destino , y selecciona la carpeta que desees. De lo contrario, se guardará en la carpeta Mi unidad.
  6. Haz clic en Generar informe.
  7. Cuando se complete el análisis, haz clic en Ver informe.

Revisa el informe de compatibilidad

Usa los detalles del informe de compatibilidad para decidir cómo proceder con la conversión de archivos. El informe incluye las siguientes secciones:

  • Resumen: Esta hoja proporciona un análisis agregado de la compatibilidad de todos los archivos enviados y sus APIs.
  • Archivos: Compatibilidad: En esta hoja, se enumeran todos los archivos enviados a Macro Converter con el estado de compatibilidad y los detalles de cada archivo.
  • Archivos: Análisis detallado: Esta hoja proporciona más información sobre las APIs dentro de un archivo y las acciones que puedes realizar para convertir cada API de forma correcta. Primero, en el menú desplegable superior, selecciona un archivo. Luego, en el menú desplegable inferior, selecciona un estado.

Si varios archivos tienen el mismo nombre, usa los identificadores únicos junto a los nombres de los archivos para diferenciarlos. Abre los archivos en Drive y busca los identificadores únicos en las URLs: https://drive.google.com/file/d/<file_identifier>/view.

También puedes revisar el informe API por API con las hojas llamadas APIs para investigar y APIs con soluciones alternativas.

Determina cómo proceder

Esto es lo que recomendamos para cada estado:

Estado Recomendación
Totalmente compatible La misma lógica de tus APIs de VBA se puede replicar en Apps Script. Continúa con la conversión.
Compatible con soluciones alternativas Debes escribir código para reemplazar al menos una API de VBA por la API equivalente de Apps Script. En general, puedes continuar con la conversión.

Puedes reemplazar manualmente las APIs de VBA marcadas como Compatible con soluciones alternativas antes o después de convertir el archivo. Te recomendamos que realices los cambios con anticipación.

Requiere más investigación No se puede convertir al menos una API. Según la importancia de esa API en tu código, es posible que no puedas convertir el archivo. Alguien que comprenda el código VBA original debe realizar la evaluación final.

Si decides convertir el archivo, debes escribir código para reemplazar al menos una API de VBA por Apps Script. Reemplaza manualmente las APIs de VBA marcadas como Requiere investigación antes o después de convertir el archivo. Te recomendamos que realices tus cambios con anticipación.

Después de evaluar tu informe de compatibilidad, consulta Cómo convertir macros de VBA a Apps Script.