Determinar se as macros VBA são compatíveis

Um arquivo do Excel com macros do Visual Basic for Applications (VBA) é considerado compatível se todas as APIs usadas nas macros tiverem um equivalente direto no Apps Script. Se as macros não forem totalmente compatíveis, talvez seja possível aplicar soluções alternativas ou ajustar o código para que elas funcionem com o Apps Script.

Use o relatório de compatibilidade do Macro Converter para determinar se é possível converter automaticamente os arquivos como estão ou se é necessário fazer ajustes no código.

Quando você gera um relatório de compatibilidade, um dos seguintes status é aplicado a cada um dos seus arquivos e APIs:

Status Definição
Compatível exatamente Esses arquivos contêm APIs que têm equivalentes diretos no Apps Script.
Suporte com soluções alternativas Esses arquivos contêm pelo menos uma API que pode ser compatível com uma solução alternativa.
Precisa de mais investigação Esses arquivos contêm pelo menos uma API que você precisa analisar para determinar como proceder. Por exemplo, pode não haver uma API equivalente, ou o Macro Converter pode não ter determinado a API em uso.

Gerar um relatório de compatibilidade

  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 as pastas que você quer analisar e clique em Selecionar. Selecione menos de 2.000 arquivos por vez.
  5. Para mudar o local em que o relatório de compatibilidade é salvo, clique em Alterar pasta de destino e selecione a pasta desejada. Caso contrário, ele será salvo na pasta "Meu Drive".
  6. Clique em Gerar relatórios.
  7. Quando a análise for concluída, clique em Ver relatório.

Analisar o relatório de compatibilidade

Use os detalhes do relatório de compatibilidade para decidir como proceder com a conversão de arquivos. Seu relatório inclui as seguintes seções:

  • Resumo: essa planilha apresenta uma análise agregada da compatibilidade de todos os arquivos enviados e as APIs deles.
  • Files - compatibility: esta página lista todos os arquivos enviados ao Macro Converter com o status de compatibilidade e os detalhes de cada arquivo.

  • Arquivos: análise detalhada: esta página oferece mais informações sobre as APIs em um arquivo e as ações que você pode realizar para converter cada API. Primeiro, no menu suspenso de cima, selecione um arquivo. Em seguida, no menu suspenso inferior, selecione um status.

Também é possível analisar o relatório por API usando as planilhas APIs a serem investigadas e APIs com soluções alternativas.

Determinar como proceder

Confira o que recomendamos para cada status:

Status Recomendação
Compatível exatamente A mesma lógica das APIs do VBA pode ser replicada no Apps Script. Prossiga com a conversão.
Suporte com soluções alternativas É necessário escrever um código para substituir pelo menos uma API VBA pela API Apps Script equivalente. Em geral, você pode prosseguir com a conversão.

É possível substituir manualmente as APIs VBA marcadas como Compatível com soluções alternativas antes ou depois de converter o arquivo. Recomendamos que você faça as mudanças com antecedência.

Precisa de mais investigação Pelo menos uma API não pode ser convertida. Dependendo da importância dessa API no código, talvez não seja possível converter o arquivo. A avaliação final deve ser feita por alguém que entenda o código VBA original.

Se você decidir converter o arquivo, vai precisar escrever um código para substituir pelo menos uma API VBA com o Apps Script. É possível substituir manualmente as APIs do VBA marcadas como Necessita de investigação antes ou depois de converter o arquivo. Recomendamos que você faça as mudanças com antecedência.

Depois de avaliar o relatório de compatibilidade, consulte Converter macros do VBA em Apps Script.