Converter macros VBA em Apps Script

Antes de começar

Atualize as APIs incompatíveis no código VBA antes de converter seus arquivos. Para arquivos com o status Exatamente compatível, você pode continuar Etapa 1: converter seus arquivos.

Modificar APIs VBA incompatíveis

Para arquivos com o status Compatível com solução alternativa ou Necessidades uma investigação, aplique as soluções alternativas após a conversão no Apps Script, mas recomendamos que você modifique o código VBA que está conhecer antes de converter seus arquivos.

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

  • Se a função desempenhada pela API não for essencial para o funcionamento da macro VBA corretamente, 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, não mexa nas APIs VBA. Depois de converter para Apps Google Script, uma solução alternativa conhecida para esta API é recomendada nos comentários do código convertido do Apps Script.
  • Se o problema for causado por uma construção de linguagem não implementada, reescreva seu código para evitar o essas construções.

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

    • Adodb.connection
    • CreateObject: essa API costuma ser usada para se conectar ao banco de dados e 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 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 Geralmente, o Apps Script 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 vir o painel lateral, na parte No canto inferior direito, clique em Mostrar painel lateral .
  3. Clique em Adicionar arquivos e pastas. O Conversor de Macro só reconhece arquivos do Excel.
  4. Escolha os arquivos ou as pastas que você quer converter e clique em Selecionar. Selecionar 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 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

Executar o código do Apps Script

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

Testar os gatilhos

Se os arquivos tiverem gatilhos como onOpen(), onEdit() ou onClick(), faça o teste seus gatilhos também. Alguns acionadores de VBA não são convertidos automaticamente e precisam ser abordada no Apps Script. Consulte Resolver problemas comuns.

Analisar arquivos ReadMe

Se um arquivo ReadMe tiver sido gerado com o arquivo convertido, revise a conversão problemas listados no arquivo ReadMe.

  • Se os problemas forem problemáticos para casos que não foram testados, aplique o recomendações de alterações no código.
  • Se você testou todos os cenários possíveis e tudo funciona como esperado, provavelmente não precisarão fazer alterações.

Etapa 3: corrigir os erros

Se você encontrar erros ao testar seus arquivos, consulte Corrigir erros nos 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 verificar se tudo está funcionando corretamente pretendido.