Spaceflows

Acompanhe a execução dos seus fluxos

A tela de Spaceflows exibe todos os fluxos de trabalho disponíveis no workspace. Cada fluxo aparece como um card em formato de grade, permitindo uma visão geral rápida de todos os fluxos configurados.

No topo da tela, uma barra de busca e filtros ajudam a localizar fluxos específicos. No rodapé, a paginação permite navegar quando há muitos fluxos cadastrados.

Esta tela é voltada ao acompanhamento de execuções. Para criar ou editar a estrutura dos fluxos, acesse Configurações > Estrutura > Spaceflow.

O card do Spaceflow

Cada card representa um fluxo de trabalho e exibe:

• Ícone — identifica visualmente o tipo do fluxo.
• Nome — o título do fluxo.
• Versão — a versão atual do fluxo (ex: v0.0.1).
• Descrição — um resumo do que o fluxo faz.
• Seta de acesso — clique para abrir os detalhes e as execuções do fluxo.

Detalhes do fluxo

A página de detalhes centraliza as informações principais do fluxo: nome, descrição, versão atual e status em tempo real. No canto superior direito, o botão Abrir Editor direciona para o editor do Spaceflow em Configurações.

Abaixo das informações principais, a página organiza-se em duas abas:

Execuções

Lista o histórico de todas as execuções do fluxo, com as seguintes colunas:

• Referência — identificação da execução vinculada.
• Status — situação atual do processamento.
• Versão — em qual versão do Spaceflow a execução ocorreu.
• Iniciado em — data e horário de início.

Use o campo de busca acima da tabela para localizar execuções específicas ou personalize as colunas visíveis pelo menu de configurações de exibição à direita.

Logs

Exibe os eventos técnicos do fluxo em formato de linhas, com as seguintes informações:

• Nível — a severidade do evento (informação, aviso, erro).
• Evento — o tipo de evento registrado. Exemplos: workflow.started (fluxo iniciado), node.started (etapa iniciada), node.completed (etapa concluída), edge.traversed (transição entre etapas), node.error (erro em uma etapa).
• Mensagem — descrição complementar do evento, quando aplicável.
• Nó — a qual etapa do fluxo o evento se refere (ex: "Início", "Análise da Demanda", "Requisição HTTP").
• Duração — tempo de processamento da etapa (ex: 160ms), quando aplicável.
• Data — registro cronológico do evento.

Os logs de Spaceflows são retidos por 90 dias e deletados automaticamente após esse período.

A paginação no rodapé permite definir a quantidade de itens por página e navegar entre elas.

Detalhes da execução

Ao selecionar uma execução na lista, o sistema abre o detalhamento em um painel lateral à direita.

Na lateral esquerda, uma coluna de informações pode ser expandida arrastando o limite entre a coluna e o canvas. Ela exibe:

• Referência — identificador da execução.
• Status e Versão — situação atual e versão utilizada.
• Datas — quando o fluxo foi iniciado e a última atualização.

O painel se divide em três abas: Fluxo de Execução, Detalhes e Logs.

Fluxo de Execução — Visualização do canvas

O canvas exibe o desenho visual do fluxo, utilizando cores para indicar o caminho percorrido:

• Verde — etapas concluídas com sucesso.
• Amarelo — etapas em execução (processando dados ou aguardando uma ação do responsável, como o cumprimento de uma tarefa).
• Vermelho — etapa interrompida por erro técnico.

Na barra superior do canvas, você acompanha o status geral, o tempo total de execução e a contagem de etapas processadas. O botão Centralizar fluxo reposiciona o diagrama no centro da tela.

Inspecionando etapas

Cada etapa (nó) do fluxo pode ser inspecionada:

• Ao passar o mouse — uma janela flutuante exibe os dados de entrada da etapa.

• Ao clicar — abre o detalhamento completo da etapa:
  • Configuração — parâmetros da ação (nome, responsáveis, conteúdo).
  • Entrada e Saída — dados recebidos e resultados processados, em formato JSON.
  • Task/Item — referências e caminhos utilizados para buscar dados dinâmicos.
  • Logs da etapa — histórico de eventos exclusivo daquela etapa.

Detalhes

A aba de detalhes exibe os dados técnicos e de auditoria da execução:

• Referência — identificador único da execução.
• Versão — versão do fluxo utilizada.
• Iniciado e Atualizado — data e hora do início e da última alteração de estado.
• Status — situação atual (Em execução, Concluído, Erro).
• Entrada (Payload) — dados recebidos pelo fluxo no momento do disparo, em formato JSON.

Logs da execução

O histórico cronológico de todos os eventos disparados durante a execução. Cada linha registra:

• Tipo de evento — início do fluxo, início/conclusão de uma etapa, transição entre etapas, erro.
• Etapa — qual etapa do fluxo gerou o evento.
• Duração — tempo de processamento (em milissegundos, quando aplicável).
• Data e hora — registro cronológico com precisão de segundos.

Indicadores visuais acompanham cada evento: ícone de "play" para início, "check" para conclusão e "spinner" para processos em andamento.

Fluxos manuais

Alguns Spaceflows são configurados para serem iniciados manualmente pelo usuário, em vez de serem disparados automaticamente por um evento.

A principal diferença visual é que, na tela de detalhes de um fluxo manual, um botão para iniciar o fluxo aparece à direita do botão Abrir Editor, no canto superior direito. Ao clicar, o fluxo é executado e uma nova execução é criada na lista.

Caso um fluxo apresente erro (indicado em vermelho no canvas), não é possível reprocessá-lo diretamente. É necessário corrigir a configuração do fluxo no editor e executar novamente.

O acompanhamento de execuções funciona da mesma forma que nos fluxos automáticos.