Pular para o conteúdo

Campos personalizados

Um campo personalizado é um campo a mais nos formulários de site, localização ou contato, definido pela organização: um patrimônio, um ramal, um turno. Ele aparece no fim do formulário, em Campos personalizados, e, no site, também na aba Dados quando tem valor. Vale para a organização inteira: não é de um cliente nem de um site. A tela Campos personalizados fica no menu Organização › Campos personalizados.

A lista de campos personalizados da organização Exemplo Redes: Ramal, Turno e Site de referência, todos de contato, com o tipo de cada um.

O campo Buscar mostra os campos cujo nome ou chave contém o texto, sem diferenciar maiúsculas. A busca vale ao apertar Enter. O filtro Vale para mostra só os campos de site, de localização ou de contato. Os dois ficam guardados no endereço da página.

Coluna O que mostra
Nome O nome do campo, como aparece no formulário.
Chave O nome curto com que o valor é gravado.
Vale para Site, Localização ou Contato.
Tipo O tipo do campo. Na lista de escolhas, quantas escolhas ela tem; na referência, o cadastro para onde aponta.
Obrigatório Sim, ou um traço quando o campo pode ficar vazio.
Ordem no formulário O número que ordena os campos no formulário: o menor aparece primeiro.

Nome, Chave e Ordem no formulário ordenam; a lista começa pela ordem no formulário, 25 por página. No fim de cada linha ficam os ícones de Editar e Excluir, para quem pode editar campos personalizados na organização inteira.

Novo campo abre o formulário num diálogo. O Tipo vem primeiro, porque ele decide os campos que aparecem embaixo; trocá-lo limpa o que já foi preenchido. Com o filtro Vale para escolhido na lista, o formulário já começa com ele. O botão só aparece para quem pode editar campos personalizados na organização inteira: quem edita só em alguns sites vê a lista sem ele. Com o plano vencido, ele não aparece para ninguém.

O formulário de novo campo com o tipo Lista de escolhas: o nome Andar, a chave andar, Vale para Contato e as escolhas Térreo, 1º andar e 2º andar, uma por linha.

Campo O que aceita Começa com
Tipo Texto, Número inteiro, Sim ou não, Data, Lista de escolhas, Endereço (URL) ou Referência a outro cadastro. Texto
Nome * De 1 a 120 caracteres. vazio
Chave * Até 50 caracteres: letras minúsculas sem acento, números e _, começando por letra (por exemplo ramal). Dois campos do mesmo objeto não podem ter a mesma chave. vazio
Vale para * Site, Localização ou Contato. Site, ou o filtro da lista
Escolhas * Só na lista de escolhas: uma por linha, até 100, de até 120 caracteres cada. Linhas em branco e repetidas são ignoradas. vazio
Aponta para * Só na referência: Site, Localização, Região, Contato ou Etiqueta. No formulário do registro, o campo pede o identificador dele. vazio
Obrigatório Marcado, o formulário do registro não salva sem o valor, também nos registros gravados antes do campo existir. desmarcado
Ordem no formulário Um número de 0 a 10000; o menor aparece primeiro. 100
Descrição Até 2000 caracteres. vazio

A tela não deixa mudar o tipo, a chave, Vale para nem o alvo da referência depois de criados: mudá-los invalidaria os valores já gravados. Para trocar um deles, crie outro campo. Uma escolha com mais de 120 caracteres, ou mais de 100 escolhas, é recusada: na criação o aviso aparece no campo Escolhas, e na edição, no topo do formulário.

O ícone de Editar de uma linha abre o formulário com o Nome, as Escolhas (na lista de escolhas), o Obrigatório, a Ordem no formulário e a Descrição. As regras de tamanho e de formato que um campo de texto ou de número tenha recebido pela API continuam como estavam.

Duas mudanças pesam nos registros já gravados, e o formulário avisa delas: marcar Obrigatório faz o registro sem o valor ser recusado na próxima vez que for salvo, até ser preenchido; e tirar uma escolha em uso faz o registro que a tem ser recusado da mesma forma, até escolher outra. Numa referência, excluir o registro para onde ela aponta (um site, por exemplo) tem o mesmo efeito: o valor fica sem destino até ser trocado ou esvaziado.

O ícone de Excluir pergunta “Excluir o campo nome? Ele sai dos formulários, e os valores já gravados nos objetos deixam de aparecer.” O campo é excluído mesmo em uso, e o registro de auditoria guarda em quantos objetos havia valor.

Aviso Quando aparece
Nenhum campo personalizado cadastrado ainda. A organização não tem campos personalizados.
Nenhum campo corresponde à busca. A busca ou o filtro não acharam nenhum.
Você não tem permissão para ver os campos personalizados. A tela foi aberta pelo endereço por quem não vê campos personalizados.
já existe um campo com esta chave para este tipo de objeto Outro campo do mesmo objeto já tem a chave.
use minúsculas, números e _ A chave tem outro caractere, começa por número ou _, ou passa de 50 caracteres.
Para… Precisa de
Ver os campos personalizados Campos personalizados › Ver
Criar, editar e excluir um campo Campos personalizados › Editar, na organização inteira

Os nomes são os da tela de papéis; veja Permissões e plano.