Campos Personalizados

Os campos personalizados são os elementos fundamentais dos modelos de incidentes. Eles definem quais dados são coletados para cada tipo de incidente. Esta página apresenta uma referência completa de todos os tipos de campo suportados, o seu comportamento e como utilizar a visibilidade condicional para criar formulários dinâmicos.

Tipos de campo

Tipo	Entrada	Caso de uso
Texto	Campo de texto de linha única	Respostas curtas: nomes, códigos, descrições.
Número	Campo numérico (suporta decimais)	Medições: pressão, diâmetro, distância, estimativas de custo.
Seleção	Menu suspenso com opções predefinidas	Categorias: níveis de prioridade, tipos de vazamento, gravidade de danos.
Área de texto	Campo de texto multilinha	Descrições longas, observações detalhadas, notas de reparo.
Data	Seletor de data	Datas programadas, datas de inspeção, prazos de acompanhamento.
Caixa de seleção	Opção booleana (marcada/desmarcada)	Perguntas sim/não: “Requer escavação?”, “Risco para a segurança pública?”.

Propriedades dos campos

Todos os campos, independentemente do tipo, possuem as seguintes propriedades:

Propriedade	Obrigatório	Descrição
Rótulo	Sim	O nome do campo exibido aos usuários. Suporta múltiplos idiomas (inglês, espanhol, português).
Nome	Sim	Identificador interno utilizado para armazenamento de dados. Definido automaticamente a partir do rótulo e não pode ser alterado após a criação.
Tipo	Sim	Um dos tipos listados acima. Não pode ser alterado após a criação.
Obrigatório	Não	Se ativado, o usuário deve preencher este campo antes de salvar o incidente. Padrão: não obrigatório.
Opções	Apenas seleção	A lista de valores disponíveis no menu suspenso. Cada opção é uma cadeia de texto.
Visibilidade condicional	Não	Regras que determinam quando o campo é exibido ou ocultado. Veja abaixo.

Configurando opções de um campo de seleção

Para campos do tipo seleção (menu suspenso), você define a lista de opções que os usuários podem escolher:

Abra o modelo no construtor de modelos.
Clique no campo de seleção que deseja configurar.
Adicione cada opção como uma entrada separada.
Reordene as opções arrastando-as para a posição desejada.
Salve o modelo.

Os usuários verão essas opções em um menu suspenso ao criar ou editar um incidente. A primeira opção não é pré-selecionada — o usuário deve escolher ativamente um valor.

Visibilidade condicional

A visibilidade condicional permite exibir ou ocultar campos com base no valor de outro campo. Esta funcionalidade é útil para criar formulários dinâmicos que se adaptam à entrada do usuário sem a necessidade de criar múltiplos modelos.

Configurando uma condição

Abra o modelo no construtor de modelos.
Clique no campo que deseja tornar condicional.
Na seção Visível quando, configure:
- Campo pai — O campo de seleção ou caixa de seleção cujo valor determina a visibilidade. O campo pai deve aparecer antes do campo dependente na lista de campos.
- Operador — A comparação a ser aplicada. Os operadores disponíveis dependem do tipo do campo pai (veja abaixo).
- Valor(es) — Para operadores baseados em seleção, escolha um ou mais valores entre as opções do campo pai.
Salve o modelo.

Operadores para campos de seleção

Quando o campo pai é do tipo seleção (menu suspenso), os seguintes operadores estão disponíveis:

Operador	Comportamento	Exemplo
igual	O campo é exibido quando o valor do campo pai corresponde exatamente a um valor.	Mostrar “Material da Tubulação” quando “Categoria” é igual a “Vazamento de Água”.
diferente	O campo é exibido quando o valor do campo pai não corresponde ao valor especificado.	Mostrar “Notas Gerais” quando “Categoria” é diferente de “Outro”.
contido em	O campo é exibido quando o valor do campo pai é um dos vários valores selecionados.	Mostrar “Detalhe de Gravidade” quando “Prioridade” é “Alta” ou “Crítica”.
não contido em	O campo é exibido quando o valor do campo pai não está na lista selecionada.	Mostrar “Nota de Baixa Prioridade” quando “Prioridade” não é “Alta” nem “Crítica”.

Todos os quatro operadores exigem que você selecione um ou mais valores entre as opções do campo pai.

Operadores para campos de caixa de seleção

Quando o campo pai é do tipo caixa de seleção, os seguintes operadores estão disponíveis:

Operador	Comportamento	Exemplo
verdadeiro	O campo é exibido quando a caixa de seleção está marcada.	Mostrar “Data de Acompanhamento” quando “Requer Acompanhamento” está marcado.
falso	O campo é exibido quando a caixa de seleção está desmarcada.	Mostrar “Motivo Sem Atribuição” quando “Atribuído” está desmarcado.

Esses operadores não requerem nenhuma seleção de valor — eles respondem exclusivamente ao estado da caixa de seleção (marcada ou desmarcada).

Condições encadeadas

As condições podem ser encadeadas em múltiplos níveis. Se o campo B depende do campo A e o campo C depende do campo B, então o campo C só aparecerá quando ambas as condições forem satisfeitas. O Nexalix avalia a cadeia completa automaticamente.

Quando o valor de um campo pai é alterado e faz com que um campo dependente seja ocultado, o valor do campo oculto é automaticamente limpo para evitar que dados desatualizados sejam salvos.

Regras de ordenação

Um campo pai deve aparecer antes do seu campo dependente na lista de campos.
Se você reordenar um campo de modo que ele fique após um campo que depende dele, a condição será automaticamente removida.
Se um campo pai for excluído, todos os campos dependentes perdem a sua condição de visibilidade.
Se o tipo de um campo pai for alterado de seleção ou caixa de seleção para outro tipo, todas as condições que o referenciam são removidas.

Boas práticas

Use campos de seleção para dados estruturados. Quando os usuários precisam escolher entre um conjunto conhecido de valores, um campo de seleção é sempre preferível a um campo de texto — ele garante consistência e permite estatísticas significativas.
Mantenha as listas de opções gerenciáveis. Menus suspensos com mais de 15 a 20 opções tornam-se difíceis de usar em campo. Considere dividir em dois campos (por exemplo, “Categoria” e depois “Subcategoria” com visibilidade condicional).
Marque campos como obrigatórios apenas quando necessário. Equipes de campo trabalhando em condições adversas precisam enviar relatórios rapidamente. Cada campo obrigatório adiciona um obstáculo.
Teste a visibilidade condicional antes de implantar. Crie um incidente de teste para verificar se os campos aparecem e desaparecem corretamente ao alterar os valores do campo pai.