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