Converter macros VBA em Apps Script

Antes de começar

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

Modificar APIs do VBA incompatíveis

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

Para cada API marcada como Suportada com solução alternativa ou Necessita de investigação no relatório de compatibilidade, recomendamos o seguinte:

  • Se a função executada pela API não for essencial para que a macro do VBA funcione corretamente, remova-a do código do VBA. Se for, mude o código para implementar um comportamento semelhante com as APIs VBA com suporte.
  • Para APIs com o status Com suporte e solução alternativa, se não for possível mudar para APIs VBA com suporte, deixe-as como estão. Depois de converter para o Apps Script, uma solução alternativa conhecida para essa API é recomendada nos comentários do código convertido do Apps Script.
  • Se o problema estiver vindo de um constructo de linguagem não implementado, reescreva o código para evitar o uso desses constructos.

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

    • Adodb.connection
    • CreateObject: essa API é usada com frequência para se conectar a um banco de dados e um software de planejamento de recursos corporativos.
    • Shell.execute
    • OleObject

    Se sim, recomendamos que você não converta os arquivos a que essas APIs pertencem e investigue outras opções. Essas APIs tendem a executar operações críticas para uma macro, como se conectar a um banco de dados ou acessar um recurso local, e o Apps Script geralmente não é uma boa solução.

Etapa 1: converter os arquivos

  1. No computador, abra o Google Drive.
  2. No painel à 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 o local de salvamento dos arquivos convertidos, clique em Mudar pasta de destino e selecione a pasta desejada. Caso contrário, os arquivos sã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

Executar o código do Apps Script

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

Testar os gatilhos

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

Analisar arquivos ReadMe

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

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

Etapa 3: corrigir erros

Se você encontrar erros ao testar seus 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 do arquivo. 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 corretamente.