Campos personalizados
Defina campos próprios da sua conta para registrar informações adicionais nos seus ingredientes.
O que é
Os campos personalizados permitem ampliar as informações dos seus ingredientes com dados próprios que o catálogo padrão não registra: origem, certificação, número de lote etc. Os campos que você definir valem para a sua conta.
Como acessar
No catálogo de ingredientes, clique no botão Campos personalizados do cabeçalho. Um modal é aberto com o texto “Defina campos próprios para registrar informações adicionais nos seus ingredientes (origem, certificação, lote etc.).”.
Seções do modal
O modal mostra a lista Campos definidos (N) — com o número de campos criados entre parênteses — e uma tabela com os campos que você já criou:
| Coluna | Conteúdo |
|---|---|
| Rótulo | Nome visível do campo. |
| Chave | Chave interna do campo. |
| Tipo | Tipo de dado do campo. |
| Obrigatório | Se o campo é obrigatório. |
Cada linha tem um ícone de lápis para editar e um de lixeira para excluir. Se você ainda não criou nenhum, verá “Nenhum campo definido. Crie o primeiro para ampliar o seu catálogo.”.
Criar um campo
Abra o editor
Clique em Novo campo. Um subformulário em branco é aberto.
Preencha os dados
- Rótulo (obrigatório) — o nome visível do campo, por exemplo País de origem.
- Chave (interna) — a chave interna. É gerada automaticamente a partir do rótulo no formato
snake_case, deve começar com letra minúscula e não pode ser alterada depois que o campo é criado. - Tipo — escolha entre Texto, Número, Data, Seleção (lista suspensa) ou Booleano (sim/não).
- Opções — só para o tipo Seleção: a lista de valores separados por vírgulas, por exemplo Venezuela, Equador, Madagascar.
- Ajuda (opcional) — um texto de apoio para quem preencher o campo.
- Campo obrigatório — caixa de seleção para marcar o campo como obrigatório. Leia o aviso de Estado atual antes de marcá-la.
Salve
Clique em Criar campo. O campo aparece na lista de campos definidos.
Editar e excluir
- Editar (ícone de lápis) — abre o editor com os dados do campo. A chave interna fica bloqueada e não pode ser modificada.
- Excluir (ícone de lixeira) — apaga a definição do campo, com confirmação prévia. Os valores que você já tiver preenchido nos ingredientes não são apagados: continuam salvos, embora sem a definição.
Validações
- O Rótulo é obrigatório: se você deixá-lo vazio, verá “O rótulo é obrigatório”.
- A Chave deve começar com letra minúscula e estar em
snake_case; caso contrário, você verá “Chave inválida — deve começar com letra minúscula e estar em snake_case”.
Estado atual
Hoje esta tela serve só para definir os campos. O modal antecipa com a nota “Depois de definidos, você poderá preencher valores em cada ingrediente personalizado.”, mas o formulário do ingrediente personalizado ainda não mostra os campos definidos; por enquanto, não há onde preencher os valores deles na interface (a importação CSV ou JSON também não os carrega).
Se você marcar um campo como Campo obrigatório, não vai conseguir criar ingredientes personalizados novos em Novo ingrediente: ao salvar, o servidor responde “O campo “…” é obrigatório” e o formulário não tem onde preenchê-lo. Deixe a caixa desmarcada enquanto o formulário não mostrar esses campos.
Não confunda os dois: os campos personalizados acrescentam colunas de dados; os ingredientes personalizados são fichas completas novas.