Determinar se as macros VBA são compatíveis

Um arquivo do Excel com macros Visual Basic for Applications (VBA) será considerado compatível se todas as APIs usadas nas macros tiverem um equivalente direto no Apps Script. Se suas macros não forem totalmente compatíveis, será 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 você pode converter os arquivos automaticamente no estado em que se encontram ou se precisa fazer ajustes no código.

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

Status Definição
Exatamente compatível Esses arquivos contêm APIs que têm equivalentes diretos no Apps Script.
Compatível 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 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 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 a pasta de destino e selecione a pasta desejada. Caso contrário, ele será salvo na sua pasta "Meu Drive".
  6. Clique em Gerar relatório.
  7. Quando a análise for concluída, clique em Ver relatório.

Analisar o relatório de compatibilidade

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

  • Resumo: essa planilha oferece uma análise agregada da compatibilidade de todos os arquivos enviados e as respectivas APIs.
  • Files - Support: 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: essa página oferece mais informações sobre as APIs de um arquivo e as ações necessárias para converter cada API. Primeiro, no menu suspenso superior, selecione um arquivo. Em seguida, no menu suspenso da parte inferior, selecione um status.

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

Determinar como proceder

Veja o que recomendamos para cada status:

Status Recomendação
Exatamente compatível A mesma lógica de suas APIs do VBA poderá ser replicada no Apps Script. Prossiga com a conversão.
Compatível com soluções alternativas Você precisa escrever o código para substituir pelo menos uma API VBA pela API Apps Script equivalente. Em geral, é possível 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 seu código, talvez não seja possível converter o arquivo. Alguém que entenda o código VBA original precisa fazer a avaliação final.

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

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