Adapte o KrakenDock ao jeito do seu time. Os campos customizados acrescentam informações próprias aos cards, como cliente, severidade ou trimestre. Os templates de card preenchem cards repetitivos, como um relato de bug, com descrição, labels e subtarefas prontas. Os templates de projeto criam projetos novos já com boards, colunas, labels, campos e templates de card.
Este guia é para quem administra projetos e organizações e para quem cria cards no dia a dia.
Versão em Markdown puro deste guia: https://app.krakendock.com/docs/fields-templates.md?lang=pt-BR. Use-a para colar num assistente de IA ou na documentação interna do seu time.
| Recurso | O que faz | Onde se configura |
|---|---|---|
| Campos customizados | campos extras que todo card do projeto pode ter | Configurações do projeto → Campos |
| Templates de card | modelos que preenchem um card novo | Configurações do projeto → Templates |
| Templates de projeto | a estrutura inicial de um projeto novo | Configurações → Templates de projeto (sua conta ou a organização) |
Os detalhes estão em Campos customizados, Templates de card e Templates de projeto.
Cada projeto define os próprios campos. Os campos valem para todos os cards do projeto, em qualquer board.
Você precisa da permissão Gerenciar projeto.
O tipo não muda depois de criado. Para trocar o tipo, crie outro campo.
| Tipo | Valor no card |
|---|---|
| Texto | até 5.000 caracteres |
| Número | entre -10¹⁵ e 10¹⁵, com decimais |
| Data | um dia, sem hora |
| Seleção única | uma das opções |
| Seleção múltipla | várias opções |
| Caixa de seleção | marcada ou desmarcada |
| Link | um endereço http:// ou https://, até 2.048 caracteres |
| Pessoa | um membro do projeto |
#RRGGBB. Use Adicionar opção e as setas para ordenar. Renomear uma opção mantém os cards que a usam.* e destaca o valor vazio. O card pode ser criado sem o valor, mas, depois de preenchido, o valor não pode ser apagado, só trocado. A caixa de seleção é exceção: desmarcar sempre é permitido.Abra o card. A seção Campos mostra todos os campos do projeto, na ordem definida nas configurações. Cada valor é salvo assim que você o altera. Para limpar um valor, apague o texto ou escolha a opção vazia.
Na página Cards do projeto, o botão Campos abre um filtro para cada campo:
| Tipo do campo | Filtro |
|---|---|
| Seleção única, seleção múltipla e pessoa | marque uma ou mais opções (ou Eu, em pessoa) e Vazio |
| Caixa de seleção | Qualquer, Marcado ou Desmarcado |
| Número | Mín. e Máx. |
| Data | De e Até |
| Texto e link | Contém… (sem diferenciar maiúsculas) |
cf=<id do campo>:<operador>:<valor>), então dá para mandar o link ou guardar num filtro salvo.A board não tem filtro por campo. Use a lista.
Um template de card guarda um card pronto de um tipo (tarefa, bug ou história). Ele fica no projeto e não muda os cards já criados com ele.
Você precisa da permissão Gerenciar projeto.
[Bug] . Inclua o espaço no fim, se quiser um.Ao criar um card com o template:
O que você preenche no card vale mais do que o template.
+ no topo de uma coluna da board ou o botão flutuante no celular.Escolha Nenhum em Template para criar o card em branco. A criação rápida no rodapé da coluna (Adicionar card, atalho c) não usa templates.
A lista mostra os templates prontos e os templates salvos pelo dono escolhido: os seus (selo Salvo) num projeto pessoal, ou os da organização (selo Da organização). Para abrir a página já com um template escolhido, use o parâmetro template, por exemplo /new?template=scrum.
| Template | Board e colunas | Também traz |
|---|---|---|
| Scrum | Sprint (Scrum): A fazer, Em andamento, Em revisão, Concluído | 4 labels, 3 templates de card e a sprint "Sprint 1" |
| Kanban simples | Kanban (Kanban): A fazer, Fazendo, Feito | 3 labels e 1 template de card |
| Bugs/Suporte | Suporte (Kanban): Novo, Triagem, Em correção, Aguardando cliente, Resolvido | 4 labels, campos Severidade e Cliente, 2 templates de card |
| Roadmap | Roadmap (Kanban): Ideias, Próximo, Agora, Lançado | 4 labels, campos Trimestre e Impacto, 1 template de card |
Os templates prontos aparecem no idioma da interface.
O template é uma cópia do momento. Mudanças posteriores no projeto não mudam o template, e vice-versa. Num projeto pessoal, o template vai para a sua biblioteca. Num projeto de organização, vai para a biblioteca da organização.
A biblioteca fica em:
/settings/templates), para os seus projetos pessoais;/<organização>/settings/templates), para os projetos da organização.Para criar um template sem partir de um projeto, clique em Novo template, escolha em Começar de (Em branco, um template pronto ou um salvo) e clique em Continuar. O editor tem estas seções:
Clique em Criar template ou em Salvar alterações. Editar um template não muda os projetos já criados com ele. Se outra pessoa salvou o template enquanto você editava, o editor avisa: Recarregar descarta as suas mudanças, e Salvar por cima grava a sua versão.
get_project lista os campos (com opções) e os templates de card. create_card aceita template (id ou nome) e custom_fields (por nome ou id do campo; seleção aceita o nome da opção). update_card altera valores, e null limpa um campo. Veja o guia do MCP.custom_fields com os valores preenchidos (id, nome, tipo, valor e as opções escolhidas). Em card.updated, a mudança de um campo aparece em changes como custom_field. Veja o guia de webhooks.| Ação | Permissão necessária |
|---|---|
| Ver campos e templates de card | Ver projeto |
| Preencher valores e criar cards com template | Editar cards |
| Criar, editar e excluir campos e templates de card | Gerenciar projeto |
| Salvar o projeto como template | Gerenciar projeto e criar projetos no dono |
| Ver e criar templates de projeto da organização | Criar projetos ou Gerenciar projetos |
| Editar e excluir um template de projeto da organização | ser o autor ou ter Gerenciar projetos |
| Free | Pro | Business | |
|---|---|---|---|
| Campos customizados por projeto | 3 | 50 | 50 |
| Templates de card por projeto | 50 | 50 | 50 |
| Templates de projeto por conta ou organização | 50 | 50 | 50 |
PLAN_LIMIT_REACHED. Escolha outro template ou mude de plano.Veja os planos em https://app.krakendock.com/pricing.
O tipo é fixo, porque os valores já gravados dependem dele. Crie um campo novo com o tipo certo, copie os valores e exclua o antigo.
Não. O card é criado sem o valor e fica destacado até alguém preencher. Depois de preenchido, o valor só pode ser trocado.
Não. O template só age no momento da criação. O mesmo vale para os templates de projeto: editar ou excluir o template não mexe nos projetos criados com ele.
O diálogo mostra só os templates do tipo escolhido. Troque o Tipo do card. A criação rápida no rodapé da coluna também não usa templates (veja Usar ao criar um card).
A lista mostra os templates do dono escolhido. Um template pessoal não aparece num projeto da organização, e o contrário também. Na organização, você precisa de Criar projetos ou Gerenciar projetos (veja Quem vê e quem edita).
Os campos existentes continuam funcionando. Você só não cria campos novos até ficar abaixo do limite.