Tutorial: Atualizar uma folha de cálculo a partir de um fluxo do Power Automate

Este tutorial ensina-o a executar um Script do Office para Excel através do Power Automate. Você fará um script que atualizará os valores de duas células com a hora atual. Depois, você fará a conexão desse script a um fluxo do Power Automate acionado manualmente, para que o script seja executado sempre que um botão no Power Automate for selecionado. Depois de entender o padrão básico, você pode expandir o fluxo para incluir outros aplicativos e automatizar ainda mais o seu fluxo de trabalho diário.

Dica

Se não estiver familiarizado com os Scripts do Office, recomendamos que comece por Tutorial: Criar e formatar uma tabela do Excel. Os Scripts do Office usam TypeScript e este tutorial se destina a pessoas com conhecimento de nível iniciante a intermediário em JavaScript ou TypeScript. Se você é novo no JavaScript, recomendamos começar com o tutorial da Mozilla sobre JavaScript.

Pré-requisitos

Precisará de acesso aos Scripts do Office e ao Power Automate para este tutorial. Reveja o Suporte da plataforma se o separador Automatizar não for apresentado. As FAQ sobre a inscrição no Power Automate têm informações sobre como começar a utilizar o Power Automate.

Preparar a pasta de trabalho

O Power Automate não pode usarreferências relativascomoWorkbook.getActiveWorksheetacessar componentes da pasta de trabalho. Por isso, precisa de um livro e de uma folha de cálculo com nomes consistentes que o Power Automate possa referenciar.

1. Crie uma pasta de trabalho intitulada MyWorkbook.

2. Na pasta de trabalho MyWorkbook, crie uma planilha intitulada TutorialWorksheet.

Criar um Script do Office

1. Aceda ao separador Automatizar e selecione Novo Script>Criar no Editor de Código.

2. Substitua o script padrão pelo script abaixo. Esse script adiciona a data e hora atuais às duas primeiras células da planilha TutorialWorksheet.

   function main(workbook: ExcelScript.Workbook) {
     // Get the "TutorialWorksheet" worksheet from the workbook.
     let worksheet = workbook.getWorksheet("TutorialWorksheet");
   
     // Get the cells at A1 and B1.
     let dateRange = worksheet.getRange("A1");
     let timeRange = worksheet.getRange("B1");
   
     // Get the current date and time using the JavaScript Date object.
     let date = new Date(Date.now());
   
     // Add the date string to A1.
     dateRange.setValue(date.toLocaleDateString());
   
     // Add the time string to B1.
     timeRange.setValue(date.toLocaleTimeString());
   }
   

3. Renomeie o script como Definir data e hora. Selecione o nome do script para alterá-lo.

4. Salve o script selecionando Salvar script.

Criar um fluxo de trabalho automatizado com o Power Automate

1. Entre no site do Power Automate.

2. No menu exibido no lado esquerdo da tela, selecione Criar. Isto leva-o a uma lista de formas de criar novos fluxos de trabalho.

   

3. Na seção Começar no espaço em branco, selecione Fluxo instantâneo. Isso irá criar um fluxo de trabalho ativado manualmente. Também pode criar fluxos e fluxos agendados que começam com base em eventos. Estes são abordados nos próximos tutoriais.

   

4. Na caixa de diálogo exibida, insira o nome para seu fluxo na caixa de textoNome de Fluxo. Em Escolher como acionar o fluxo, selecione Acionar manualmente um fluxo na lista de opções. Selecione Criar para concluir a configuração inicial.

   

   Observe que o fluxo acionado manualmente é apenas um entre os diversos tipos de fluxo. No tutorial a seguir, você criará um fluxo que é executado automaticamente quando você recebe um email.

5. No construtor de fluxos, selecione o + botão e Adicionar uma ação.

6. No painel de tarefas Adicionar uma ação , procure "Script de execução do Excel". Selecione a ação Executar script do conector do Excel Online (Empresas). Esta ação executa um script a partir do seu OneDrive num livro. Se quiser utilizar um script armazenado na biblioteca do SharePoint da sua equipa, deve utilizar a ação Executar script a partir de uma biblioteca do SharePoint .

   

7. Poderá ser-lhe pedido para iniciar sessão na sua conta do Microsoft 365. Faça-o para continuar o tutorial.

8. Depois, você selecionará a pasta de trabalho e o script que será utilizado na etapa do fluxo. Para o tutorial, você fará o uso da pasta de trabalho criada no seu OneDrive, mas é possível usar qualquer pasta de trabalho em um site OneDrive ou no Microsoft Office SharePoint Online. Especifique os seguintes parâmetros para a ação Executar script :

   • Localização: OneDrive for Business
   • Biblioteca de Documentos: OneDrive
   • Arquivo: MyWorkbook.xlsx (Escolhido por meio do navegador de arquivos)
   • Script: Definir data e hora

   

9. Selecione Salvar.

   

Seu fluxo agora está pronto para ser executado por meio do Power Automate. Você pode testá-lo usando o botão Testar no editor de fluxo ou seguir as etapas restantes do tutorial para executar o fluxo a partir da sua coleção de fluxos.

Executar o script por meio da automação

1. Na página principal do Power Automate, selecione Meus fluxos.

   

2. Selecione Fluxo do meu tutorial na lista de fluxos exibida na guia Meus fluxos. Isso irá lhe mostrar os detalhes do fluxo que criamos anteriormente.

3. Selecione Executar.

   

4. Um painel de tarefas irá aparecer para executar o fluxo. Se você for solicitado a Entrar no Excel Online, entre selecionando Continuar.

5. Selecione Executar fluxo. Isso executará o fluxo, que, por sua vez, executará o Script do Office relacionado.

6. Selecione Concluído. Deverá ver a atualização do histórico de execuções em conformidade.

7. Atualize a página para ver os resultados do Power Automate. Se tiver falhado, verifique as configurações do fluxo e execute-o novamente.

   

8. Abra o livro para ver as células atualizadas. Deverá ver a data atual na célula A1 e a hora atual na célula B1. O Power Automate utiliza a Hora Universal Coordenada (UTC), pelo que é provável que a hora seja desfasada do fuso horário atual.

   

Próximas etapas

Tutorial Completo: guardar automaticamente conteúdo de e-mails num livro. O tutorial ensinará como transferir dados de um serviço de fluxo de trabalho para o seu Script do Office e executar o fluxo do Power Automate quando certos eventos ocorrerem.