> 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-mascaras-de-maquinas.md).

# Pesquisa Avançada de Máscaras de Máquinas

A Pesquisa Avançada de Máscaras de Máquinas é utilizada para a gestão, identificação hierárquica e classificação de equipamentos. O sistema utiliza códigos estruturados (máscaras) para a organização do parque fabril em níveis lógicos e sucessivos.

### Classificação de Identificação

A estruturação dos dados ocorre em dois níveis distintos de detalhamento:

* **Analítica:** Refere-se à máquina específica (nível final da hierarquia), onde são executadas as operações.

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Setor > Grupo > Máquina Específica<br>Seleção de uma fresadora específica em uma linha de produção.</p></div>
* **Sintética:** Refere-se a agrupamentos ou níveis superiores, como setores ou famílias de equipamentos, voltados para a organização e emissão de relatórios.

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Seleção de todo o setor de usinagem para visualização de indicadores.</p></div>

### Configurações e Tipos de Pesquisa

O comportamento do campo muda conforme as regras definidas para a tela onde ele está inserido.

#### **Tipos de Máscara Permitidos**

O sistema pode ser configurado para aceitar apenas um tipo ou ambos:

* **Analítica (A):** Exige a inserção de uma máquina específica.
* **Sintética (S):** Permite apenas a inserção de um nível de grupo.
* **Analítica/Sintética (A/S):** Aceitação de ambos os níveis de hierarquia (configuração padrão).

#### **Modos de Retorno do Código**

Dependendo da necessidade do processo, o leitor pode devolver o código de duas formas:

* **Normal:** Apresentação do código completo, incluindo o preenchimento de zeros à direita.

{% hint style="warning" %}
*Exemplo:*\
Retorno do dado como `21011000000`.
{% endhint %}

* **Reduzido:** Apresentação apenas da parte significativa do código identificador.

{% hint style="warning" %}
*Exemplo:*\
Retorno do dado como `210110`.
{% endhint %}

#### **Validação de Cadastro**

O leitor garante a integridade dos dados através de travas de segurança:

* **Validação de Item:** Se configurado como `True`, o sistema não aceitará um código que não esteja previamente cadastrado no banco de dados.
* **Seleção por Nível (**<kbd>**???**</kbd>**):** Utilização do caractere de interrogação para a realização de buscas em níveis específicos da hierarquia.<br>

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Digitação de <code>01.010.???</code> para listar todas as máquinas pertencentes ao grupo <code>01.010</code>.</p></div>

#### Funcionalidades de Interface e Visualização

A Pesquisa Avançada oferece recursos para facilitar a interação e a precisão da escolha:

* **Pesquisa Avançada (**<kbd>**F7**</kbd>**):** Ao acionar a busca no campo, o sistema abre uma interface de consulta hierárquica. Se uma "Tabela de Seleção" estiver configurada, o usuário só poderá visualizar e selecionar as máquinas que fazem parte daquela lista específica, facilitando o filtro em processos restritos.
* **Dimensionamento:** O campo suporta visualmente até 30 caracteres, mas seu tamanho real de digitação é ajustado automaticamente conforme as configurações globais de planejamento e controle de manutenção da empresa.
* **Máscara Visual:** O leitor aplica automaticamente pontos e separadores para facilitar a leitura humana, mas processa o dado de forma limpa para o banco de dados.

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>O sistema exibe <code>01.010.005</code> na tela, enquanto armazena <code>01010005</code> no banco de dados.</p></div>


---

# 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-mascaras-de-maquinas.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.