Sua primeira automaçãoEtapa 6 de 8

Seu primeiro flow

Um flow é uma cadeia de passos num canvas. Cada passo é um script, uma consulta, uma chamada HTTP, uma condição, um loop — e cada um pode usar o que um passo anterior retornou. Nesta lição você monta o report-pipeline: ele roda o daily-report, entrega o resultado a um segundo passo que escreve uma frase e mostra a execução inteira no canvas.

9 min de leituraAntes: Publique a versão testadaAbrir no Waiso
O que você vai aprender
  • Criar um flow e adicionar passos com o + entre eles
  • Reaproveitar um script do projeto como passo
  • Ligar a entrada de um passo à saída de um passo anterior
  • Rodar o flow e inspecionar cada passo no canvas

Um flow é uma coluna de passos

Todo flow começa no Início, onde as entradas dele são declaradas, e roda para baixo. Você nunca posiciona nem conecta nós à mão: o canvas organiza os passos para você, um abaixo do outro, e o único jeito de adicionar um é o + na linha entre dois passos (ou abaixo do último). Condições, loops e ramos em paralelo se abrem em colunas próprias e se fecham de novo abaixo.

Passos empilhados abaixo do Início; um passo posterior lê a saída de um anterior por uma ligação.

Um passo não vê o resultado do anterior automaticamente. Cada entrada de um passo é um valor fixo ou uma ligação — “pegue isto da saída daquele passo” — e você define isso explicitamente. É o que torna um flow legível: cada caminho de dados tem um nome.

Monte o report-pipeline

  1. Crie o flow

    Em Code, clique em + Novo → Flow, digite report-pipeline em Nome do flow e clique em Criar flow. O canvas abre com um único passo Início.

  2. Adicione o daily-report como passo

    Clique no + abaixo do Início. Em Adicionar nó, escolha Script existente (“Vincular um script do projeto”) e selecione daily-report. Ele entra abaixo do Início e o painel lateral dele abre.

  3. Adicione um passo que formata a mensagem

    Clique no + abaixo do daily-report e escolha Python (ou TypeScript, JavaScript). Cole o código abaixo no passo e dê o nome format-message. A entrada report mostra um alerta: ela ainda não tem valor.

  4. Ligue a entrada

    Na entrada report, clique em De nó e escolha daily-report → output. A linha passa a mostrar daily-report → output. Escolher output.passed passaria só aquele campo.

  5. Rode o flow

    Clique em Executar Flow no topo. A aba Execução abre e o canvas pinta a execução: cada passo aparece como rodando enquanto trabalha e fica verde quando termina com sucesso, com a duração ao lado.

  6. Abra o resultado de um passo

    Clique em format-message no canvas: o painel mostra as entradas que ele recebeu e a saída que retornou. O resultado do flow é a saída do último passo.

format-message.py
def main(report: dict):
    return {"message": f"{report['passed']} of {report['total']} passed (average {report['average']})"}
Saída esperadaSucessoSaída do format-message — e o resultado do flow
{
  "message": "2 of 3 passed (average 85)"
}

Lendo uma execução no canvas

Uma execução concluída: todos os passos verdes, cada um com o próprio tempo.
  • Um passo que falhou fica vermelho e o flow para ali; o painel dele guarda o erro. Comece a investigar pelo primeiro passo vermelho, não pelo status do flow. Veja Depurar flows.
  • A aba Execuções lista as execuções passadas do flow; escolha uma para pintá-la de novo no canvas. Voltar a editar tira a execução do canvas.
  • Na página Execuções do projeto, o flow é uma linha só; abra-a para ver as execuções de passos que ele iniciou.

Flows também são publicados

Um flow tem rascunho e versão publicada, igual a um script. Executar Flow roda o rascunho; um agendamento ou um endpoint de API roda a publicada. Clique em Publicar na página do flow antes da próxima lição se quiser agendar o flow em vez do script.

6 / 8

Assuntos relacionados