Nós
Ações
Nós que executam tarefas, aprovações, comunicações e operações sobre dados dentro dos Spaceflows.
atualizado
Execute ações e interações dentro dos seus fluxos
Os nós de Ações são responsáveis por executar atividades operacionais dentro de um Spaceflow. Eles permitem criar tarefas, coletar informações por formulário, solicitar aprovações, enviar e-mails, manipular itens das categorias do workspace e disparar notificações baseadas em comparações.
Alguns nós de ação geram tarefas que pausam o fluxo até serem concluídas por um membro (como formulários, aprovações e tarefas manuais). Outros executam de forma totalmente automática (como envio de e-mail e notificações de comparação).
Quando usar os nós de Ações
Utilize os nós de Ações quando precisar executar atividades operacionais dentro de um Spaceflow.
Eles são ideais para:
- Coletar dados de usuários durante a execução do fluxo
- Solicitar decisões de aprovação ou rejeição
- Criar tarefas manuais para atividades operacionais
- Enviar comunicações automáticas por e-mail
- Criar, consultar, editar ou excluir itens em categorias
- Disparar alertas baseados em comparações previamente configuradas
Para nós que apenas direcionam o fluxo sem executar ações (Condicional, Rotas, Mesclar), consulte a documentação de Lógica e Controle.
Tipos disponíveis e quando utilizar
Como os nós de Ações funcionam
Os nós de Ações funcionam como os executores do Spaceflow. Eles recebem os dados dos nós anteriores, realizam uma operação específica e, quando aplicável, geram saídas para os nós seguintes.
Em programação, esse padrão é chamado de side effect — uma operação que altera o estado do sistema (cria uma tarefa, envia um e-mail, salva um item) em vez de apenas transformar dados.
- Entradas — recebem variáveis dos nós anteriores do fluxo. Um formulário pode usar dados de um item para pré-preencher campos; um e-mail pode usar o nome do solicitante para personalizar a mensagem.
- Saídas — nós que coletam dados (Formulário, Aprovação) geram variáveis com as respostas. Nós automáticos (E-mail, Notificação de Comparação) não geram saídas novas, apenas executam a ação.
- Pausa do fluxo — nós que geram tarefa interrompem a execução até que um membro complete a ação. O fluxo permanece no estado "Aguardando" até a conclusão.
- Execução automática — nós que não geram tarefa executam imediatamente e o fluxo avança para o próximo nó sem interrupção.
Comparação entre os nós
| Recurso | Formulário | Aprovação | Tarefa | CRUD | Comparação | |
|---|---|---|---|---|---|---|
| Gera tarefa | Sim | Sim | Sim | Não | Configurável | Não |
| Coleta dados do usuário | Sim | Não | Não | Não | Configurável | Não |
| Decide caminhos do fluxo | Não | Sim | Não | Não | Não | Não |
| Envia comunicação | Não | Não | Não | Sim | Não | Sim |
| Opera sobre itens | Não | Não | Não | Não | Sim | Não |
Nós disponíveis
| Nó | Descrição | Gera tarefa? |
|---|---|---|
| Formulário | Exibe um formulário para coleta de dados. As respostas ficam disponíveis como variáveis para os nós seguintes. | Sim |
| Aprovação | Solicita que um responsável aprove ou rejeite antes de o fluxo continuar. O fluxo segue por caminhos diferentes conforme a decisão. | Sim |
| Tarefa | Cria uma tarefa manual com título, descrição e responsável. Não exige nenhuma ação específica além de alterar o status da tarefa (ex: pendente → concluído). | Sim |
| Envia e-mails automáticos pelo ENSPACE para avisos, confirmações ou notificações. O remetente é o sistema, não o e-mail pessoal do membro. | Não | |
| Operações de Dados (CRUD) | Cria, consulta, edita ou exclui itens em qualquer categoria do workspace. Pode ser configurado como manual (gera tarefa) ou automático (execução direta). | Configurável |
| Notificação de Comparação | Envia notificações automáticas com base em resultados de comparações configuradas no módulo de Comparações. | Não |
Como configurar
Acesse o Spaceflow no editor
Navegue até Estrutura > Spaceflow, selecione o fluxo desejado e clique para abrir o canvas.
Adicione um nó de Ação
Clique em Adicionar Nó ou arraste a partir do semicírculo amarelo de um nó existente. Selecione o grupo Ações e escolha o nó desejado.
Conecte o nó ao fluxo
Arraste o semicírculo amarelo do nó anterior até a entrada do novo nó de Ação. O fluxo só avança para este nó se a conexão estiver ativa.
Configure o nó
Dê um duplo clique no nó para abrir o painel de configuração. As opções variam conforme o tipo:
- Formulário — selecione o formulário a ser exibido e defina o responsável pela tarefa.
- Aprovação — configure o responsável, o prazo e os caminhos para "Aprovado" e "Rejeitado".
- Tarefa — defina título, descrição, responsável e prazo de conclusão.
- E-mail — configure destinatários, assunto, corpo da mensagem (aceita variáveis com
{{). - Operações de Dados (CRUD) — escolha a operação (criar, consultar, editar, excluir), a categoria e o mapeamento de campos.
- Notificação de Comparação — selecione a comparação previamente configurada no módulo de Comparações.
Salve o nó
Clique em Salvar para aplicar as configurações. O nó exibirá no canvas um resumo da ação configurada.
Comportamento dos dados
As configurações dos nós de Ações afetam diretamente o estado do fluxo e do workspace:
- Formulário — os dados preenchidos ficam disponíveis como variáveis de saída para todos os nós subsequentes. Campos obrigatórios devem ser preenchidos para que a tarefa seja concluída.
- Aprovação — a decisão (Aprovado/Rejeitado) determina por qual aresta o fluxo seguirá. A variável de decisão fica disponível para nós seguintes.
- Tarefa — apenas a conclusão da tarefa libera o fluxo. Não gera variáveis de saída, apenas pausa a execução.
- E-mail — não altera variáveis do fluxo. O envio é registrado nos logs do Spaceflow.
- Operações de Dados (CRUD) — no modo automático, executa imediatamente e pode gerar variáveis com os dados do item criado/consultado. No modo manual, gera uma tarefa para que um membro revise antes de executar.
- Notificação de Comparação — dispara notificações para os destinatários configurados no módulo de Comparações. Não gera variáveis de saída.
Alterações na configuração de um nó de Ação aplicam-se apenas a novas execuções. Execuções em andamento mantêm a configuração original do momento em que passaram pelo nó.
Casos de uso
| Cenário | Nós utilizados |
|---|---|
| Aprovação de contrato com notificação | Formulário → Aprovação → E-mail |
| Cadastro automático de cliente a partir de formulário | Formulário → Operações de Dados (CRUD) |
| Processo de onboarding com etapas manuais | Tarefa → E-mail → Operações de Dados (CRUD) |
| Alerta automático ao detectar divergência em comparação | Notificação de Comparação → E-mail |
| Atualização de status após aprovação | Aprovação → Operações de Dados (CRUD) |
Boas práticas
- Utilize Formulário quando precisar coletar dados estruturados durante o fluxo — prefira formulários já existentes na categoria para reaproveitar campos.
- Utilize Aprovação apenas quando houver caminhos distintos para "Aprovado" e "Rejeitado". Se precisar apenas de uma confirmação, use o nó Tarefa.
- Utilize Tarefa para atividades que não exigem coleta de dados nem decisão binária, mas precisam de registro manual de conclusão.
- Utilize E-mail para comunicações que não precisam de interação — evite sobrecarregar destinatários com notificações automáticas excessivas.
- Utilize Operações de Dados (CRUD) no modo automático para fluxos maduros e testados; use o modo manual durante a fase de validação para permitir revisão humana.
- Utilize Notificação de Comparação apenas quando já houver comparações configuradas e validadas no módulo de Comparações.
- Nomeie nós de Ação de forma descritiva no canvas (ex: "Aprovação — Diretoria Financeira") para facilitar a leitura do fluxo.
- Lembre-se de que nós que geram tarefa pausam o fluxo — posicione-os estrategicamente para não criar gargalos desnecessários.
- Revise periodicamente os logs de execução para identificar falhas em nós automáticos (E-mail, CRUD) que não geram tarefas visíveis.