Converter macros VBA em Apps Script

Antes de começar

Convém atualizar APIs incompatíveis no seu código VBA antes de converter seus arquivos. Para arquivos com o status Exatamente compatível, prossiga para a Etapa 1: converter seus arquivos.

Modificar APIs VBA incompatíveis

Para arquivos com o status Compatível com solução alternativa ou Requer investigação, é possível aplicar as soluções alternativas e correções após a conversão no Apps Script. No entanto, recomendamos modificar o código VBA que você conhece 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 executada pela API não for essencial para o funcionamento correto da macro VBA, remova-a do código VBA. Se estiver, altere seu código para implementar um comportamento semelhante com as APIs VBA compatíveis.
  • Para APIs com o status Compatível com solução alternativa, se não for possível mudar para APIs VBA compatíveis, mantenha as APIs VBA como estão. Depois de converter para o Apps Script, recomendamos uma solução alternativa para essa API nos comentários do código convertido do Apps Script.
  • Se o problema vier de uma construção de linguagem não implementada, reescreva seu código para evitar o uso dessas construções.

  • Para APIs com o status Precisa de investigação, confira se o código contém alguma destas APIs:

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

    Em caso afirmativo, 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 lateral à direita, clique no complemento Macro Converter Ícone do Macro Converter. Se você não encontrar o painel lateral, no canto inferior direito, clique em Mostrar painel lateral .
  3. Clique em Adicionar arquivos e pastas. O Macro Converter só reconhece arquivos do Excel.
  4. Escolha as pastas ou os arquivos que você quer converter e clique em Selecionar. Selecione menos de 2.000 arquivos por vez.
  5. Para mudar o local em que os arquivos convertidos são salvos, clique em Alterar a pasta de destino e selecione a pasta. Caso contrário, os arquivos serão salvos na sua pasta "Meu Drive".
  6. Clique em Converter.
  7. Quando a conversão for concluída, clique em Conferir resultados.

Etapa 2: testar os arquivos convertidos

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 seus arquivos do Excel. Se possível, compare a saída dos arquivos convertidos do Planilhas com a dos arquivos originais do Excel.

Testar os acionadores

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

Analisar arquivos ReadMe

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

  • Se os problemas forem problemáticos para casos não testados, 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 vai ser necessário 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 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 conforme o esperado.