Converter macros VBA em Apps Script

Use o complemento Macro Converter para converter automaticamente seus arquivos do Excel com código Visual Basic for Applications (VBA) em Planilhas e Apps Script.

Antes de começar

Talvez seja necessário atualizar as APIs incompatíveis no código VBA antes de converter os arquivos. Para arquivos com o status Suportado exatamente, siga para a Etapa 1: converter seus arquivos.

Modificar APIs VBA incompatíveis

Para arquivos com o status Suportado com solução alternativa ou Necessita investigação, é possível aplicar soluções alternativas e correções após a conversão no Apps Script, mas recomendamos que você modifique primeiro o código VBA com que está familiarizado antes de converter os arquivos.

Para cada API marcada como Compatível com solução alternativa ou Precisa de investigação no relatório de compatibilidade, recomendamos o seguinte:

  • Se a função realizada pela API não for essencial para sua macro do VBA, remova-a do código VBA. Se a função for essencial, mude o código para implementar um comportamento semelhante usando APIs VBA compatíveis.

  • Para APIs Suportadas com solução alternativa, se você não encontrar uma alternativa VBA compatível, deixe o código VBA no estado em que se encontra. Após a conversão, procure soluções alternativas recomendadas nos comentários do código do Apps Script.

  • Se o problema for causado por um elemento de linguagem não implementado, reescreva o código para evitar o uso desses elementos.

  • Para APIs com o status Necessita investigação, verifique se o código contém alguma das seguintes APIs:

    • Adodb.connection
    • CreateObject: essa API é usada com frequência para se conectar a bancos de dados e softwares de planejamento de recursos empresariais.
    • Shell.execute
    • OleObject

    Se as macros usarem essas APIs, reconsidere a conversão dos arquivos. Essas APIs geralmente gerenciam funções críticas, como conectividade de banco de dados ou acesso ao sistema local, que o Apps Script não pode replicar facilmente.

Etapa 1: converter os arquivos

  1. No computador, abra o Google Drive.
  2. No painel lateral à direita, clique no complemento Macro Converter Ícone do Macro Converter. Se o painel lateral não aparecer, clique em Mostrar painel lateral no canto inferior direito.
  3. Clique em Adicionar arquivos e pastas. O Macro Converter só reconhece arquivos do Excel.
  4. Escolha os arquivos ou pastas que você quer converter e clique em Selecionar. Selecione menos de 2.000 arquivos por vez.
  5. Para mudar onde os arquivos convertidos são salvos, clique em "Mudar pasta de destino" e selecione a pasta desejada. Caso contrário, os arquivos serão salvos na pasta Meu Drive.
  6. Clique em Converter.
  7. Quando a conversão for concluída, clique em Ver resultados.

Etapa 2: testar os arquivos convertidos

Depois de converter os arquivos, teste-os para garantir que eles funcionem conforme o esperado.

Executar o código do Apps Script

Depois de converter os arquivos, teste as funções do Apps Script. Teste os arquivos convertidos com os dados que você normalmente usa com os arquivos do Excel. Se possível, compare a saída dos arquivos convertidos do Google Planilhas com a dos arquivos originais do Excel.

Testar os gatilhos

Se os arquivos tiverem gatilhos como onOpen(), onEdit() ou onClick(), teste-os também. Alguns gatilhos do VBA não são convertidos automaticamente e precisam ser tratados no Apps Script. Consulte Resolver problemas comuns.

Revisar arquivos ReadMe

Se um arquivo ReadMe foi gerado com o arquivo convertido, revise os problemas de conversão listados nele.

  • Se os problemas forem problemáticos para casos que você não testou, aplique as mudanças recomendadas ao seu código.
  • Se você testou todos os cenários possíveis e tudo funciona como esperado, provavelmente não precisa fazer mudanças.

Etapa 3: corrigir erros

Se você encontrar erros ao testar os arquivos, consulte Corrigir erros no código convertido.

Se o código for executado sem erros, mas o resultado não for o esperado, abra o arquivo ReadMe. Analise cada seção para determinar o que está causando o problema e aplique a correção recomendada.

Depois de corrigir os erros, teste o arquivo novamente para garantir que tudo funcione como esperado.