# 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>