Como criar o campo Cancelado, a etapa e torná-lo obrigatório ao entrar na etapa

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

  1. Criar a coluna Cancelado no formulário do card.
  2. Criar a etapa Cancelado.
  3. 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

  1. Abra um card do Kanban.
  2. Na coluna da esquerda (Detalhes), clique em Modo Edição.
  3. 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.
  4. Abre a tela Personalizar Layout do Formulário.
  5. No canto das abas, clique no engrenagem e depois em Nova Coluna.
  6. Em Adicionar novo campo, clique em Coluna Padrão.
  7. 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
  1. Clique em Confirmar. Deve aparecer a mensagem Campo criado com sucesso!.
  2. 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).
  3. Clique em Confirmar de novo para gravar o layout.
  4. 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.

  1. No próprio card, em Detalhes, clique na linha Kanban (nome do fluxo). Isso abre o quadro.
  2. No canto do quadro, clique na engrenagem e depois em Modo de Edição.
  3. À direita das colunas, clique em Nova Etapa (Clique para criar uma nova etapa).
  4. Em Nome da Etapa, digite Cancelado.
  5. 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.

  1. Abra de novo um card e clique em Modo Edição.
  2. Na coluna Etapas (direita), clique no lápis ao lado de Cancelado.
  3. Clique em Configurações Básicas.
  4. Ligue Último Passo.
  5. Ligue Ignorar verificação dos passos anteriores.
  6. 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).

  1. No card, clique em Modo Edição (se ainda não estiver).
  2. Na coluna Etapas, clique no lápis da etapa Cancelado.
  3. Clique em Configurar Colunas.
  4. Clique em Colunas que devem ser preenchidas ao entrar na etapa.
  5. Clique em Adicionar coluna.
  6. Preencha:
Campo Valor
Coluna Cancelado (o campo criado na Parte 1)
Modo Simples
Obrigatório Ligado
  1. Clique em Aplicar. Deve aparecer Alterações confirmadas com sucesso.
  2. Feche o editor da etapa (X) e saia do Modo Edição.

Como conferir se funcionou

  1. Abra um card que não esteja em Cancelado.
  2. Tente avançar para a etapa Cancelado sem marcar o campo. O sistema deve bloquear e pedir a informação.
  3. Marque Cancelado (ou preencha o motivo, se usou texto).
  4. 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.