Este guia é para administradores do Kanban. Não é necessário acessar código. Use a tela do Card e, para criar a etapa, o quadro Kanban.
O que você vai fazer
- Criar a coluna Cancelado no formulário do card.
- Criar a etapa Cancelado.
- Exigir o preenchimento dessa coluna ao entrar nessa etapa.
Antes de começar
- Você precisa ser administrador do Kanban (sem isso, os botões de edição não aparecem).
- Abra qualquer card desse Kanban. A coluna e a etapa valem para todo o fluxo, não só para aquele card.
- No PUCA não existe um tipo de campo chamado “cancelado”. Use o tipo Booleano e o rótulo Cancelado (sim/não).
Se o objetivo for um motivo de cancelamento (texto livre), no passo da coluna escolha Texto (varchar) e o rótulo Motivo do cancelamento. O restante do manual é o mesmo.
Parte 1 — Criar a coluna no Card
- Abra um card do Kanban.
- Na coluna da esquerda (Detalhes), clique em Modo Edição.
- No bloco Formulário (centro da tela), clique no ícone de grade/lista ao lado do título (dica: Configurar layout do formulário).
- Se o sistema avisar que há alterações não salvas, clique em SALVAR ALTERAÇÕES.
- Abre a tela Personalizar Layout do Formulário.
- No canto das abas, clique no engrenagem e depois em Nova Coluna.
- Em Adicionar novo campo, clique em Coluna Padrão.
- Preencha:
| Campo | O que informar |
|---|---|
| Nome do Campo | Comece com user_ e use só letras minúsculas, números e _. Exemplo: user_cancelado |
| Novo Label | Cancelado (é o que as pessoas veem na tela) |
| Tipo do Campo | Booleano |
| Valor Padrão | Deixe em branco (o card não deve nascer já cancelado) |
| Coluna Inativa | Desligado |
- Clique em Confirmar. Deve aparecer a mensagem Campo criado com sucesso!.
- Você volta para o layout. Se Cancelado estiver em Campos ocultos (esquerda), clique no + para torná-lo visível na aba atual (em geral Geral).
- Clique em Confirmar de novo para gravar o layout.
- Recarregue o card se o novo campo ainda não aparecer no formulário.
Parte 2 — Criar a etapa Cancelado
A lista de etapas no Card só permite editar etapas que já existem. A etapa nova é criada no quadro Kanban.
- No próprio card, em Detalhes, clique na linha Kanban (nome do fluxo). Isso abre o quadro.
- No canto do quadro, clique na engrenagem e depois em Modo de Edição.
- À direita das colunas, clique em Nova Etapa (Clique para criar uma nova etapa).
- Em Nome da Etapa, digite
Cancelado. - Clique em Confirmar.
Recomendado (volta no Card): marque a etapa como fim de fluxo, para o card poder ir para Cancelado sem cumprir todas as etapas anteriores.
- Abra de novo um card e clique em Modo Edição.
- Na coluna Etapas (direita), clique no lápis ao lado de Cancelado.
- Clique em Configurações Básicas.
- Ligue Último Passo.
- Ligue Ignorar verificação dos passos anteriores.
- Clique em Aplicar.
Parte 3 — Obrigatório ao entrar na etapa
Isso impede mover o card para Cancelado se o campo Cancelado não estiver preenchido (marcado).
- No card, clique em Modo Edição (se ainda não estiver).
- Na coluna Etapas, clique no lápis da etapa Cancelado.
- Clique em Configurar Colunas.
- Clique em Colunas que devem ser preenchidas ao entrar na etapa.
- Clique em Adicionar coluna.
- Preencha:
| Campo | Valor |
|---|---|
| Coluna | Cancelado (o campo criado na Parte 1) |
| Modo | Simples |
| Obrigatório | Ligado |
- Clique em Aplicar. Deve aparecer Alterações confirmadas com sucesso.
- Feche o editor da etapa (X) e saia do Modo Edição.
Como conferir se funcionou
- Abra um card que não esteja em Cancelado.
- Tente avançar para a etapa Cancelado sem marcar o campo. O sistema deve bloquear e pedir a informação.
- Marque Cancelado (ou preencha o motivo, se usou texto).
- Tente de novo. Desta vez o card deve entrar na etapa.
Problemas comuns
| Situação | O que fazer |
|---|---|
| Não aparece Modo Edição no card | Sua conta não é administradora desse Kanban. Peça a um admin. |
| Não aparece o ícone de layout no formulário | Ative Modo Edição no card primeiro. |
| Não aparece Nova Etapa no quadro | Ative Modo de Edição pela engrenagem do Kanban (não é o mesmo botão do card). |
| A coluna nova não entra na lista ao configurar a etapa | Confirme o layout (Parte 1, passo 10), recarregue o card e abra de novo o lápis da etapa. |
| O nome do campo foi recusado | O nome técnico precisa começar com user_ (ex.: user_cancelado). O rótulo pode ser Cancelado. |
Resumo: no Card, Modo Edição → layout do formulário → Nova Coluna (Booleano / Cancelado). No Kanban, Modo de Edição → Nova Etapa. De volta no Card, lápis da etapa → Configurar Colunas → ao entrar na etapa → Adicionar coluna → Aplicar.