Scripts do Office no Excel Web: Um Guia Prático Completo

Se você usa o Excel na web diariamente, certamente existem tarefas que você repete constantemente: limpar dados, formatar tabelas, criar gráficos ou atualizar relatórios. Com Scripts do Office em Excel para a web Você pode automatizar todo esse trabalho e executá-lo com um clique ou até mesmo de acordo com um cronograma, sem precisar estar em frente ao computador.

Neste guia prático você descobrirá Como funcionam os scripts do Office, quais ferramentas o Excel inclui para criá-los, como compartilhá-los e como conectá-los ao Power Automate.Além de uma série de boas práticas e exemplos de código TypeScript para garantir que suas automações sejam estáveis, seguras e fáceis de manter, o objetivo é que você saia daqui com uma compreensão muito clara de todo o potencial dos scripts do Excel na web e como aplicá-los às suas próprias planilhas.

O que são scripts do Office no Excel para a Web?

Os scripts do Office no Excel são uma forma de Automatize processos repetitivos em suas planilhas. Utilizando duas ferramentas principais: um gravador de ações e um editor de código baseado em TypeScript, você pode gravar manualmente suas ações e transformá-las em um script reutilizável, ou escrever seu próprio código do zero.

A filosofia é simples: Tudo o que você repete sistematicamente no Excel. Tarefas como (limpar colunas, aplicar formatação, inserir fórmulas, preparar relatórios) podem ser agrupadas em um script e executadas a qualquer momento, tanto na mesma pasta de trabalho quanto em outras que tenham a mesma estrutura de dados.

Uma grande vantagem é que esses scripts são armazenados na nuvem, de modo que Você pode compartilhá-los com outros membros da sua organização. E todos terão acesso à mesma automação. Além disso, com a integração ao Power Automate, o Office Scripts se torna a conexão perfeita entre o Excel e os demais aplicativos do Microsoft 365.

Quando faz sentido usar scripts do Office?

Os scripts do Office são especialmente úteis quando você detecta que Você sempre segue a mesma sequência de passos. em uma ou mais pastas de trabalho do Excel. Por exemplo, todas as manhãs você abre uma arquivo .csv Os dados são provenientes do seu programa de contabilidade; você exclui as colunas desnecessárias, converte os dados em uma tabela, adiciona fórmulas e cria uma tabela dinâmica em uma nova planilha para o relatório diário.

Em vez de repetir esse ritual manualmente todos os dias, você pode Execute-o apenas uma vez enquanto o Gravador de Ações estiver ativo.O Excel irá capturar todas as operações e gerar um script que você poderá reutilizar sempre que receber um novo arquivo .csv com o mesmo formato. Isso economiza tempo, reduz erros e permite que qualquer pessoa da sua equipe execute o mesmo processo sem precisar conhecer todos os detalhes.

Outro caso típico é quando você trabalha com vários livros que compartilham uma estrutura: relatórios mensais, modelos de acompanhamento, painéis de controleEm vez de editar manualmente cada arquivo, você cria um script que faz o trabalho para você em todas as pastas de trabalho compatíveis. E se quiser ir além, você pode integrar esses scripts a fluxos do Power Automate para que sejam executados automaticamente, por exemplo, todas as noites ou quando um e-mail com um anexo específico for recebido.

O Gravador de Ações: automatizando sem saber programar

O Gravador de Ações é a ferramenta que permite que você Converta seus cliques e alterações no Excel em código executável.Funciona como uma espécie de "macro moderna" baseada em TypeScript, mas sem que você precise escrever uma única linha de código, se não quiser.

Ao ativar o gravador, o Excel irá Registrar as operações que você realiza em células, intervalos, tabelas, gráficos e outros objetos.Edições, alterações de formatação, criação de tabelas, etc. Tudo isso é traduzido automaticamente em código e, quando a gravação é interrompida, é salvo como um script do Office.

Então você pode Reproduzir esse roteiro em outros livros ou em outras folhasIsso funciona desde que os elementos referenciados (por exemplo, uma tabela específica) existam com o mesmo nome ou estrutura. É a maneira mais rápida de começar a usar os Scripts do Office, pois também serve como uma "aula" para ver como cada ação é codificada em TypeScript.

Se em algum momento você precisar de código para uma operação específica e não tiver certeza de como escrevê-lo, você pode usar o gravador: Ative-o, execute a ação no Excel e, em seguida, copie o código gerado. Para colar e adaptar ao seu script principal.

Editor de código: leve seus scripts para o próximo nível.

O editor de código é onde você pode Visualize, edite e crie scripts do Office baseados em TypeScript.É aqui que a automação deixa de ser apenas uma "reprodução" do que você fez manualmente e se torna um pequeno programa com lógica, condições e estruturas de controle.

A partir do editor, você pode abrir roteiros gravados anteriormente. Modifique o código gerado pelo Gravador de Ações. e adicione melhorias como condicionais, loops, funções auxiliares ou validação de dados. Isso permite que você as ajuste às especificidades dos seus livros e as torne muito mais resistentes a mudanças.

Dentre as funcionalidades disponíveis apenas por meio de código, destacam-se as seguintes: estruturas condicionais (if/else), laços de repetição e funções reutilizáveisGraças a eles, você não fica limitado a repetir etapas, mas pode tomar decisões em tempo de execução: ignorar operações se uma tabela estiver faltando, excluir planilhas somente se elas existirem ou processar dados em blocos quando forem muito grandes.

Os tutoriais oficiais de script do Office são muito úteis para entender a lógica do editor. Após dominar os exemplos básicos e editar roteiros gravadosRecomenda-se aprofundar-se nos fundamentos da API ExcelScript e no próprio ambiente do editor, para entender o que cada parte do código faz e como o Excel organiza os objetos na pasta de trabalho.

Compartilhe scripts do Office com sua organização.

Uma das grandes vantagens dos Scripts do Office é que Eles não ficam só por sua causa.Você pode compartilhá-los com outras pessoas em sua organização e fazer com que elas trabalhem com o mesmo fluxo de trabalho automatizado, sem precisar saber programar ou acessar o editor.

Ao salvar e compartilhar um roteiro em uma pasta de trabalho compartilhada, Qualquer pessoa com permissões nesse arquivo pode visualizar e executar o script. Na guia Automatizar. Dessa forma, você centraliza a lógica de negócios em um único script e evita que cada um "invente" sua própria maneira de lidar com os dados.

Também é possível Adicione botões dentro do próprio livro que executem scripts específicos.Isso permite que qualquer usuário execute a automação com um único clique na faixa de opções. Isso é especialmente útil quando você deseja que pessoas sem conhecimento técnico possam se beneficiar dos scripts sem precisar navegar por menus ou painéis.

Agende scripts para serem executados automaticamente.

Além de executá-los sob demanda, você também pode Configure seus scripts do Excel para serem executados automaticamente em intervalos regulares.O mecanismo depende do Power Automate, que será responsável por executar o script mesmo que o livro esteja fechado.

Para programar um script, abra o Editor de Código, selecione o script que deseja automatizar e acesse a seção. Programação dentro do painelA partir daí, você acessa o Excel pelo Power Automate, escolhe a frequência (por exemplo, diária, semanal ou a cada poucos minutos) e, finalmente, clica na opção para criar o fluxo.

Uma vez configurado, O Power Automate executará o script em segundo plano. De acordo com a programação que você especificou. Isso funciona perfeitamente com cenários como "atualizar este relatório todos os dias às 7h" ou "sincronizar esses dados sempre que forem carregados em uma pasta específica".

Integre scripts do Office com o Power Automate.

O Power Automate é um serviço da Microsoft projetado para criar fluxos de trabalho automatizados entre diferentes aplicativos e serviçosOs scripts do Office se encaixam aqui como mais uma peça, permitindo que o Excel atue tanto como fonte quanto como destino de informações dentro de um processo maior.

Entre as possibilidades mais interessantes está a de Executar scripts do Excel como parte de um fluxo de trabalho agendado.Imagine que um e-mail com um arquivo .csv chegue a uma caixa de entrada compartilhada; o Power Automate pode baixá-lo, abri-lo no Excel, executar um script que o limpa e processa, e salvar o resultado onde você precisar.

Se você quiser se familiarizar com essa integração, os tutoriais em Execute scripts do Office com o Power Automate. Eles explicam como vincular um script específico do editor a um fluxo e como passar parâmetros, coletar resultados e lidar com erros dentro do próprio fluxo.

Criando scripts do Office: três maneiras de trabalhar

Atualmente, o Excel para a Web oferece diversas maneiras de Crie novos scripts do Office personalizados para diferentes perfis de usuário.Você não precisa ser um desenvolvedor para começar, mas se for, também poderá aproveitar ao máximo a plataforma.

A primeira opção é usar o Gravador de ações para registrar seus passos habituaisÉ perfeito quando você já tem um processo bem definido que costuma repetir da mesma maneira. Nesse caso, você não precisa de nenhum conhecimento de programação: basta seguir seus passos habituais com o gravador ativo e deixar o Excel gerar o script para você.

A segunda maneira é ir diretamente para Editor de código para escrever ou aprimorar scripts em TypeScript.Essa é a abordagem recomendada quando você deseja criar automações mais complexas, otimizar scripts gerados pelo gravador ou incorporar lógica avançada que a interface do Excel não expõe diretamente.

Finalmente, existe a possibilidade de Gere um script inicial com a ajuda de IA.Este recurso, ainda em versão prévia e não disponível para todos os usuários, permite que você especifique o que deseja fazer e receba um rascunho de código que poderá revisar, depurar e adaptar às suas necessidades específicas. É um bom ponto de partida se você sabe o que quer alcançar, mas não tem certeza de como traduzir isso para TypeScript.

Como executar e gerenciar um script do Office

Executar um script recém-criado ou um que você compartilhou é bastante simples: Basta acessar a guia Automatizar no Excel na web.A partir daí, você verá a Galeria de Scripts do Office com aqueles com os quais trabalhou mais recentemente.

Para lançar um, tudo o que você precisa fazer é Acesse Automatizar > Exibir scripts, selecione o script e clique no botão Executar. No Editor de Código. Enquanto estiver em execução, o Excel exibe uma pequena notificação que desaparece quando o script termina.

Controle de versões no Office e no OneDrive

Requisitos e problemas comuns com a guia Automatizar

Em alguns casos pode acontecer que A guia Automatizar não aparece no Excel e os scripts do Office não estão disponíveis.Existem vários pontos que vale a pena verificar antes de presumir que algo está definitivamente "quebrado".

A primeira coisa a verificar é que Sua licença do Microsoft 365 inclui suporte para scripts do Office.Se sua assinatura não os incluir, você não verá a guia nem poderá usar esse recurso. Também é importante que você tenha os cookies de terceiros ativados no seu navegador ao usar o Excel na web.

Por outro lado, o administrador do Microsoft 365 pode Após desativar os scripts do Office no centro de administração. Ou você pode ter aplicado uma política de grupo que os bloqueia (em ambientes Windows). Em alguns casos, você também precisará ter o WebView2 instalado em seu computador.

Por fim, verifique se Não faça login como convidado ou usuário externo no locatário. da sua organização, visto que, nesse contexto, certas funcionalidades, como os Scripts do Office, podem ser restritas.

Registro de erros de script e problemas

Mesmo que um roteiro funcione bem na primeira gravação, ele pode... não conseguem reproduzir em outros livros ou em situações ligeiramente diferentes.As causas típicas incluem alterações nos nomes das planilhas, tabelas que não existem mais ou diferenças na estrutura dos dados.

Quando alguma dessas situações ocorre, O Excel exibe erros no painel do Editor de Código.Você pode usar o botão "Exibir registros" para exibir mensagens mais detalhadas na parte inferior do painel, ajudando você a entender exatamente o que deu errado e em que ponto do código.

Esses registros são essenciais para depurar scripts, porque Eles indicam a linha problemática e fornecem uma descrição do problema.Com essas informações, você pode ajustar os nomes dos objetos, adicionar verificações prévias ou modificar o fluxo lógico do script para torná-lo mais robusto.

Funcionalidades ainda não suportadas pelos Scripts do Office

A plataforma Office Scripts está em constante evolução, mas Ainda existem funcionalidades do Excel que não podem ser registradas ou automatizadas. usando o gravador ou a API disponível.

Ao tentar usar o Gravador de Ações com um recurso não compatível, Você verá uma anotação no painel de registro. indicando que a ação não pôde ser capturada. Essas operações não serão incluídas no roteiro e, portanto, serão omitidas durante a reprodução.

Diante dessa situação, a melhor estratégia é Procure uma alternativa equivalente que seja suportada. Ou consulte periodicamente a documentação técnica do Office Scripts, onde a lista de funcionalidades disponíveis é atualizada.

Melhores práticas para tornar seus scripts confiáveis.

Para garantir que seus scripts do Office se comportem de maneira previsível e não falhem à menor provocação, é recomendável seguir estas diretrizes. uma série de padrões e melhores práticasEstas diretrizes visam minimizar erros comuns na automatização de fluxos de trabalho no Excel.

A primeira ideia fundamental é usar o O gravador de ações como ferramenta de aprendizagemSempre que você não souber como traduzir uma função ou recurso do Excel para código, grave-o e observe o resultado. Em seguida, você pode copiar esse trecho de código e colá-lo em um script maior, ajustando-o conforme necessário.

Outra recomendação muito importante é Verifique sempre se os objetos que você vai usar realmente existem no livro.Muitos scripts dependem de uma planilha com um nome específico ou de uma tabela específica; se alguém renomeá-las ou excluí-las, o script falhará durante a execução.

Um padrão típico consiste em Recupere a planilha ou tabela pelo nome e valide o resultado antes de prosseguir.Por exemplo, você pode obter a planilha "Índice" com `workbook.getWorksheet('Index')` e verificar se a variável retornada não é nula. Se a planilha existir, você continua trabalhando com o intervalo dela; caso contrário, você registra uma mensagem clara no console para que o usuário saiba o que está faltando.

Você também pode usar o operador opcional ? do TypeScript para Chame os métodos somente se o objeto estiver definido.Por exemplo, workbook.getWorksheet('Index')?.delete(); garante que a operação delete() seja executada apenas se a planilha existir, evitando erros desnecessários.

Valide os dados e o estado do livro antes de fazer qualquer alteração.

Antes que seu script comece a escrever, excluir ou transformar informações, é uma boa ideia Verifique se o livro está nas condições esperadas.Isso inclui a presença de todas as planilhas, tabelas, nomes e outros elementos dos quais sua lógica depende.

Imagine um roteiro que precise duas tabelas denominadas “Tabela 1” e “Tabela 2” Para copiar dados de um para o outro, a abordagem recomendada é obter ambos os arquivos no início, verificar se não são nulos e, caso um deles esteja faltando, registrar uma mensagem explicando o problema e finalizar o script com uma instrução de retorno da função principal.

Se você realizar essa verificação em uma função auxiliar, você pode Retorna um valor booleano indicando se tudo está correto.A função principal a invoca e, se ela retornar falso, a execução é encerrada sem prosseguir. Esse padrão permite centralizar a validação de entrada e manter o código mais organizado e fácil de ler.

Quando lançar erros com `throw` e como usar `try…catch`

Na maioria dos casos, basta que Finalize o script usando Enter e exiba uma mensagem descritiva. para que o usuário saiba o que aconteceu. No entanto, há casos em que você deseja acionar um erro explícito que interrompa não apenas o script, mas também os processos que dependem dele.

Quando um script faz parte de um fluxo do Power Automate, ele pode ser fundamental. Impeça a continuidade do fluxo se faltarem informações críticas.Nesses casos, faz sentido usar uma instrução `throw` para gerar uma exceção com uma mensagem específica, por exemplo, quando uma tabela obrigatória estiver faltando. O erro fará com que tanto o script quanto o fluxo parem de ser executados.

Outra ferramenta útil é a estrutura. try…catch, que permite interceptar erros durante a execução de uma chamada de API.Por exemplo, se você tentar usar `setValues()` com um conjunto de dados muito grande para o Excel na web, o script falhará se você não tratar a exceção. Ao envolver essa chamada em um bloco try…catch, você pode exibir uma mensagem mais amigável ao usuário e encerrar o script de forma controlada.

Você pode até mesmo aproveitar o bloco de captura para Tente uma estratégia alternativa quando algo falhar.No exemplo anterior, se setValues() gerar um erro, você pode chamar uma função que processe os dados em lotes menores, minimizando o risco de o mesmo problema ocorrer novamente.

Aprendizagem, exemplos e recursos adicionais

Se você já possui um nível intermediário ou avançado de Excel e se sente confortável usando a versão online, A curva de aprendizado para scripts do Office será muito mais gerenciável.Idealmente, você deve primeiro consolidar seu conhecimento sobre funções, tabelas e formatos, e só depois se aprofundar na automação.

Existem cursos e materiais de treinamento focados em Ensinamos você a gravar, editar e executar scripts no momento certo.Além de mostrar as principais diferenças entre scripts e VBA e como eles se complementam, o curso frequentemente utiliza exemplos práticos, como modelos de faturas ou relatórios recorrentes, para que você possa aplicar os conceitos diretamente no seu trabalho diário.

Esse tipo de treinamento também costuma explicar Como adicionar botões personalizados aos scripts de inicialização e como compartilhar livros com scripts entre equipes. e como executar automações a partir de canais do Teams, o que abre ainda mais possibilidades de colaboração.

Se você quiser se aprofundar ainda mais, a documentação técnica da Microsoft inclui Guias sobre como gravar ações, tutoriais passo a passo e exemplos de scripts prontos para uso. e explicações sobre como criar botões específicos na interface que executam um script específico. Tudo isso ajudará você a construir soluções cada vez mais sofisticadas.