Passar dados de e para scripts no Power Automate

O Power Automate encadeia 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 escritos para expandir a ação "Executar Script" do Power Automate para obter entrada adicional ou fornecer 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 de 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 e para scripts executados por meio do cliente Excel. Saiba mais sobre como fornecer entrada para scripts em Obter entrada do usuário para scripts.

A captura de tela a seguir mostra o que um script com a assinatura function main(workbook: ExcelScript.Workbook, location: string = "Seattle") exibiria.

A ação Executar script mostrando um campo de parâmetro adicional chamado 'Location' com um valor pré-preenchido de 'Seattle'.

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

A ação Executar script mostrando um campo de parâmetro adicional chamado 'Local' com opções entre 'Seattle' e 'Redmond'.

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 do 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 é denominado "resultado".

O seletor de conteúdo dinâmico no Power Automate mostrando uma entrada de uma ação Executar script chamada 'result'.

Os 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

  • Last updated on