Campos personalizados e extensibilidade

Adicionar um campo que a plataforma não inclui, sem uma nova versão e sem alterar as tabelas principais.

Um campo necessário para o seu negócio, mas que a plataforma não oferece, é adicionado como um campo personalizado. Ele é definido por empresa, vinculado a um recurso, recebe um tipo e um rótulo e, em seguida, aparece no formulário desse recurso, em suas colunas de lista, em seus filtros, em seu mapeamento de importação e em sua exportação.

• Os campos personalizados ficam fora das tabelas principais, portanto, adicionar um não altera o esquema que todas as empresas compartilham.
• Uma vez definidos, são campos comuns — filtráveis, classificáveis, importáveis e exportáveis, e não um campo de notas com um rótulo.
• São por empresa, portanto, os acréscimos de uma empresa são invisíveis para outra.
• Um campo "Sim/Não" é desenhado como as caixas de seleção do próprio produto: a caixa ao lado do rótulo, o rótulo clicável e a ajuda logo abaixo.

Tornar um campo obrigatório

Para tornar um campo sempre obrigatório, ou obrigatório antes de uma etapa como Enviar ou Publicar, use Plataforma › Personalização › Requisitos de Campo: marque a caixa, sem necessidade de escrever uma regra. Consulte Tornando qualquer campo obrigatório: Requisitos de Campo. A Lógica Personalizada, abaixo, refere-se a uma condição.

Plataforma → Personalização → Lógica Personalizada contém as regras que uma empresa define para si mesma: uma validação que impede o salvamento, um valor calculado sempre que um registro é salvo e um valor padrão para um novo registro. Para tornar um campo obrigatório — seja um campo que o produto inclui no pacote ou um campo adicionado por você — crie uma validação nessa tela que seja verdadeira apenas quando o campo tiver um valor e defina a mensagem que os usuários devem ver quando o campo estiver vazio.

1. Acesse Plataforma → Personalização → Lógica Personalizada e escolha o módulo e a tela — RH, Funcionários.
2. Adicione uma regra do tipo Validar, executada a cada salvamento.
3. Escreva a condição que deve ser verdadeira. `not_empty(iqama_number)` torna o número do Iqama obrigatório para todos os funcionários. `is_saudi or not_empty(iqama_number)` exige o número do Iqama de todos que não são cidadãos sauditas, que é geralmente o que se quer dizer: um cidadão saudita possui um documento de identidade nacional, não um Iqama.
4. Escreva a mensagem — "O número do Iqama é obrigatório para funcionários que não sejam cidadãos sauditas" — e salve. Teste-a na mesma tela, comparando-a com um registro, antes de utilizá-la definitivamente.

A regra é verificada pelo servidor a cada salvamento, independentemente da forma como o registro chega: formulário, importação, ASK ou API. Alterar um registro existente de forma que viole a regra também é recusado.

Visualizando os valores contidos em seus campos.

Em Plataforma → Personalização → Campos Personalizados, é exibida, para a tela selecionada, uma tabela com os registros dessa tela e os campos personalizados da sua empresa como colunas. A tabela permite buscas e paginação, como qualquer lista, para que você possa verificar os campos preenchidos sem precisar abrir os registros um por um.

• Somente os registros que você já podia abrir nessa tela são exibidos.
• Os campos são exibidos por seus rótulos, conforme aparecem no formulário — e não por qualquer nome interno.

A mesma apresentação simples é utilizada sempre que os valores são listados para sua leitura: os detalhes de uma entrada de auditoria, a solicitação de aprovação de um agente e o resultado de uma ação mostram uma tabela de campos e valores em vez de dados brutos.