> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/pesquisa-avancada/pesquisa-avancada-de-campos-de-maquina.md).

# Pesquisa Avançada de Campos de Máquina

A Pesquisa Avançada de Campos de Máquina é uma funcionalidade destinada à padronização da entrada, validação e exibição de dados técnicos nos módulos de gestão de ativos. Este recurso garante que informações críticas (como medidas, capacidades e parâmetros técnicos) sejam inseridas corretamente, respeitando as regras de negócio e o formato de armazenamento do sistema.

Este componente atua em quatro etapas: Dimensionamento, Pesquisa Assistida, Tratamento de Entrada e Exibição.

### Funcionalidades da Pesquisa Avançada

1. Definição Automática de Tamanho\
   O sistema ajusta o espaço de digitação na tela de acordo com a configuração prévia do campo técnico.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Em um campo configurado para 20 caracteres, a digitação é interrompida ao atingir este limite. Na ausência de configuração específica, é aplicado o padrão visual de 10 caracteres.</p></div>
2. Pesquisa Avançada (<kbd>F7</kbd>)\
   Para campos que possuem uma lista de valores pré-definidos (campos de seleção), o leitor habilita a função de busca.\
   **Como funciona:** Ao acionar a tecla de atalho de pesquisa no campo, o sistema abre uma janela com as opções válidas para aquela categoria de máquina, evitando erros de digitação e garantindo a integridade dos dados.
3. Validação e Tratamento de Dados\
   Ao finalizar o preenchimento de um campo, o leitor processa a informação antes de salvá-la no banco de dados. Este processo é essencial para campos numéricos.
   1. **Conversão de Símbolos:** Transforma automaticamente vírgulas em pontos (padrão de sistema) para permitir cálculos posteriores.
   2. **Normalização:** Ajusta o valor conforme o número de casas decimais permitidas.
   3. **Aplicação de Escala:** Se o campo exigir um fator de divisão, o sistema realiza o cálculo de forma transparente para o usuário.

      <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Conversão de gramas para quilos.</p></div>
4. Formatação de Visualização (Display)\
   Após a gravação do dado no banco de dados, o sistema processa a informação para reapresentação em tela. Este processo consiste na aplicação de uma "máscara" de leitura sobre o dado bruto, convertendo valores técnicos em formatos legíveis.
   1. Padronização Visual: Inserção automática de separadores de milhar e símbolos de unidade de medida.
   2. Clareza de Consulta: Garantia de que a informação técnica seja interpretada com precisão, independente da estrutura de armazenamento no banco de dados.

#### Resumo de Comportamento por Tipo de Dado

A tabela abaixo detalha a aplicação das regras de acordo com a natureza da informação:

<table><thead><tr><th width="140">Tipo de Dado</th><th width="294">Descrição</th><th>Funcionalidades Ativas</th></tr></thead><tbody><tr><td>Numérico</td><td>Valores decimais, medidas e pesos.</td><td>Conversão de pontuação, ajuste de casas decimais e aplicação de divisores.</td></tr><tr><td>Seleção</td><td>Lista de opções pré-configuradas.</td><td>Habilita a Pesquisa Avançada (F7) e validação de código existente.</td></tr><tr><td>Texto</td><td>Descrições ou observações técnicas.</td><td>Controle de tamanho máximo de caracteres.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/pesquisa-avancada/pesquisa-avancada-de-campos-de-maquina.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.