Passar dados de e para scripts no Power Automate

O Power Automate reúne programas separados em um único fluxo de trabalho automatizado. Cada conector tem parâmetros diferentes que aceita e valores diferentes que retorna. Seus scripts podem ser gravados para expandir a ação "Executar script" do Power Automate para obter entrada adicional ou dar saída.

A entrada para o script é especificada adicionando parâmetros à main função. A saída do script é declarada adicionando um tipo de retorno a main.

Observação

Quando você cria um bloco "Executar script" em seu fluxo, os parâmetros aceitos e os tipos retornados são preenchidos. Se você alterar os parâmetros ou retornar tipos do script, precisará refazer o bloco "Executar script" do fluxo. Isso garante que os dados estão sendo analisados corretamente.

Passar dados para scripts com parâmetros

Adicione parâmetros aos scripts para fornecer entrada de outras partes do fluxo. É o mesmo processo para adicionar parâmetros para scripts baseados em fluxo como é para scripts executados por meio do cliente do Excel. Saiba mais sobre como fornecer entrada para scripts em Obter entrada do usuário para scripts.

A captura de tela a seguir mostra qual script com a assinatura function main(workbook: ExcelScript.Workbook, location: string = "Seattle") seria exibido.

Os menus suspensos criados por uniões de tipo também funcionam da mesma forma no Power Automate.

Retornar dados de um script

Os scripts podem retornar dados da pasta de trabalho para serem usados como conteúdo dinâmico em um fluxo do Power Automate. Para retornar um objeto, adicione a sintaxe de tipo de retorno à main função. Por exemplo, se você quisesse retornar um string valor do script, sua main assinatura seria function main(workbook: ExcelScript.Workbook): string.

Os valores retornados são mostrados como conteúdo dinâmico da ação Executar script no fluxo. O conteúdo dinâmico é chamado de "resultado".

Tipos aceitáveis para retornar dados são os mesmos que para parâmetros. Detalhes sobre restrições de tipo são encontrados no artigo Obter entrada do usuário para scripts.

Confira também

• Tutorial: atualizar uma planilha de um fluxo do Power Automate
• Obter entrada do usuário para scripts
• Executar scripts do Office com o Power Automate
• Solução de problemas de informações para o Power Automate com scripts do Office