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.

Busca e filtro
Seção intitulada “Busca e filtro”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.
Colunas
Seção intitulada “Colunas”| 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
Seção intitulada “Novo campo”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.

| 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.
Excluir
Seção intitulada “Excluir”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. |
Permissões desta tela
Seção intitulada “Permissões desta tela”| 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.