> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
