Criar e editar propriedades

Em Desenvolvimento → Campos Personalizados aparecem os objetos que têm campos personalizados ou substituições cadastradas (Contact, Deal, Company, User, Product, Note…), cada um com uma chave Ativo para habilitar ou desabilitar seus campos sem perder os dados já salvos.

A tabela depende do espaço de trabalho

Não é uma linha fixa para cada objeto do sistema: a consulta filtra pelo espaço de trabalho ativo. Um espaço onde nenhum foi cadastrado mostra a tabela vazia, com o estado Crie seu primeiro registro, mesmo que seus contatos exibam campos personalizados na ficha. Se não vir o que esperava, confira primeiro em qual espaço de trabalho você está.

A coluna Campos personalizados abre o JSON Schema que aquele objeto usa, com cada campo, seu tipo e seu título. O painel traz um botão Copiar para levar o esquema inteiro para o formulário de edição.

Adicionar um objeto à lista

O botão de criar abre Criar Campo personalizado, com quatro controles:

• Objeto atribuído (obrigatório) — um seletor com busca que lista todos os objetos do sistema. É o objeto ao qual os campos serão atribuídos.
• Campos personalizados — o JSON Schema dos campos, que ficam aninhados sob a propriedade customFields (por exemplo, Deal.customFields.color).
• Substituições — para modificar atributos existentes ou criar campos novos na raiz do esquema.
• Ativo — chega desligado.

Os textos de ajuda que acompanham cada caixa (Set the object(s) where the custom fields should be assigned, Custom fields nested under the customFields property, Override existing attributes or create new fields at root level of the schema) aparecem sempre em inglês, qualquer que seja o idioma da conta. Os rótulos dos campos, sim, são traduzidos.

Criar por este formulário falha

Criar sempre termina em erro, seja digitando o JSON manualmente ou ligando antes a chave Ativo. O servidor responde 400 com a mensagem “At least one of customFields or overrides must be provided”, e o corpo da requisição que sai do formulário contém apenas o objeto escolhido (por exemplo {"objectAssigned":"Contact"}) — nenhuma das duas caixas JSON é enviada, mesmo com o texto visível na tela. O erro também não aparece na interface: só no console do navegador.

Enquanto isso continuar assim, a via para cadastrar um objeto é a API.

Editar o esquema de um objeto

Ao selecionar Editar na linha de um objeto, o campo Campos personalizados é uma caixa de texto onde você escreve o JSON Schema manualmente: não há formulário visual para criar a propriedade. Também existe uma caixa Substituições para modificar ou adicionar atributos no nível raiz do esquema. Para adicionar uma regra de validação (formato, intervalo etc.), veja Regras de validação de propriedade.

Esta é a única via para criar ou editar propriedades: o Prolibu não tem um editor visual de formulários.

Importante: isso só vale para os campos que você adiciona dentro de customFields. As propriedades padrão do Prolibu — como E-mail — já vêm com sua própria validação integrada (o campo E-mail exige um formato de e-mail válido ao salvar) e essa validação não é editada nesta tela; esses campos estão documentados em Propriedades.

Uma vez ativo, um campo personalizado se comporta como qualquer outro: você pode exibi-lo como coluna em Visualizações e colunas e preenchê-lo pelo arquivo de importação.

Campos personalizados adiciona propriedades aos objetos que já existem no sistema.