Campos personalizados
Defina campos próprios da sua conta para registar informação adicional nos seus ingredientes.
O que é
Os campos personalizados permitem-lhe alargar a informação dos seus ingredientes com dados próprios que o catálogo padrão não inclui: origem, certificação, número de lote, etc. Os campos que definir aplicam-se ao nível da sua conta.
Como aceder
A partir do catálogo de ingredientes, clique no botão Campos personalizados do cabeçalho. Abre-se uma janela com o texto «Defina campos próprios para registar informação adicional nos seus ingredientes (origem, certificação, lote, etc.).».
Secções da janela
A janela mostra a lista Campos definidos (N) — com o número de campos criados entre parênteses — e uma tabela dos campos que já tiver criado:
| 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 caixote do lixo para eliminar. Se ainda não tiver criado nenhum, verá «Sem campos definidos. Crie o primeiro para alargar o seu catálogo.».
Criar um campo
Abra o editor
Clique em Novo campo. Abre-se um subformulário em branco.
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 por uma letra minúscula e não pode ser alterada depois de o campo ser criado. - Tipo — escolha entre Texto, Número, Data, Seleção (lista pendente) ou Booleano (sim/não).
- Opções — apenas para o tipo Seleção: a lista de valores separados por vírgulas, por exemplo Venezuela, Equador, Madagáscar.
- Ajuda (opcional) — um texto de apoio para quem preencher o campo.
- Campo obrigatório — caixa de verificação para marcar o campo como obrigatório. Leia o aviso de Estado atual antes de a assinalar.
Guarde
Clique em Criar campo. O campo aparece na lista de campos definidos.
Editar e eliminar
- Editar (ícone de lápis) — abre o editor com os dados do campo. A chave interna fica bloqueada e não pode ser modificada.
- Eliminar (ícone de caixote do lixo) — apaga a definição do campo, com confirmação prévia. Os valores que já tiver registado nos ingredientes não são apagados: continuam guardados, embora sem a respetiva definição.
Validações
- O Rótulo é obrigatório: se o deixar vazio, verá «O rótulo é obrigatório».
- A Chave deve começar por uma letra minúscula e estar em
snake_case; caso contrário, verá «Chave inválida — deve começar por uma letra minúscula e estar em snake_case».
Estado atual
Hoje, este ecrã serve apenas para definir os campos. A janela antecipa-o com a nota «Depois de definidos, 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 seus valores na interface (a importação CSV ou JSON também não os carrega).
Se assinalar um campo como Campo obrigatório, deixa de conseguir criar ingredientes personalizados novos em Novo ingrediente: ao guardar, o servidor responde «O campo «…» é obrigatório» e o formulário não tem onde o preencher. Deixe a caixa por assinalar enquanto o formulário não mostrar estes campos.
Não confunda as duas coisas: os campos personalizados acrescentam colunas de dados; os ingredientes personalizados são fichas completas novas.