Converter macros VBA em Apps Script

Antes de começar

Atualize as APIs incompatíveis no código VBA antes de converter os arquivos. Para arquivos com o status Suportado 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 os reparos 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 Com suporte e solução alternativa ou Requer investigação no relatório de compatibilidade, recomendamos o seguinte:

  • Se a função desempenhada pela API não for essencial para o funcionamento correto da macro VBA, remova-a do código 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 Precisa de 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 um banco de dados e um software de planejamento de recursos corporativos.
    • Shell.execute
    • OleObject

    Em caso afirmativo, recomendamos não converter os arquivos a que essas APIs pertencem e investigar 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 alterar o local onde os arquivos convertidos são salvos, clique em "Alterar 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 de VBA não são convertidos automaticamente e precisam ser resolvidos 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 forem problemáticos para casos que você não testou, aplique as mudanças recomendadas no 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 os 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 ajudar a 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.