Transmitir dados de e para scripts no Power Automate

O Power Automate agrupará programas separados num único fluxo de trabalho automatizado. Cada conector tem parâmetros diferentes que aceita e valores diferentes que devolve. Os scripts podem ser escritos para expandir a ação "Executar script" do Power Automate para obter entradas adicionais ou fornecer saídas.

A entrada para o script é especificada ao adicionar parâmetros à main função. O resultado do script é declarado ao adicionar um tipo de retorno a main.

Observação

Quando cria um bloco "Executar script" no fluxo, os parâmetros aceites e os tipos devolvidos são preenchidos. Se alterar os parâmetros ou os tipos de retorno do script, terá de refazer o bloco "Executar script" do fluxo. Isto garante que os dados estão a ser analisados corretamente.

Transmitir dados para scripts com parâmetros

Adicione parâmetros a scripts para fornecer entradas de outras partes do fluxo. É o mesmo processo para adicionar parâmetros para scripts baseados em fluxos, tal como acontece com os scripts executados através do cliente do Excel. Saiba mais sobre como fornecer entradas para scripts em Obter entrada de utilizador para scripts.

A captura de ecrã seguinte mostra o que seria apresentado um script com a assinatura function main(workbook: ExcelScript.Workbook, location: string = "Seattle") .

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

Devolver dados de um script

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

Os valores devolvidos são apresentados como conteúdo dinâmico da ação Executar script no fluxo. O conteúdo dinâmico é denominado "resultado".

Os tipos aceitáveis para devolver dados são os mesmos que para os parâmetros. Os detalhes sobre as restrições de tipo encontram-se no artigo Obter a entrada do utilizador para scripts.

Confira também

• Tutorial: Atualizar uma folha de cálculo a partir de um fluxo do Power Automate
• Obter a entrada do utilizador para scripts
• Executar Scripts do Office com o Power Automate
• Informações de resolução de problemas do Power Automate com Scripts do Office