# Pesquisa Avançada de Placas

A Pesquisa Avançada de Placas é o componente utilizado no módulo de Portaria destinado à identificação, validação e padronização da entrada de veículos. O recurso assegura que os registros sigam os padrões nacionais e do Mercosul, realizando o tratamento automático de caracteres e a uniformização visual dos dados inseridos.

### Regras de Validação e Formatação

Para manter a integridade dos registros de entrada e saída, o componente aplica as seguintes transformações e verificações:

1. Normalização de Dados\
   Ao digitar a placa, o sistema realiza a limpeza e padronização imediata dos caracteres inseridos:\
   **Caixa Alta:** Todas as letras são convertidas para maiúsculas.\
   **Limpeza de Pontuação:** Espaços, hifens ou pontos digitados são removidos internamente para o processamento.\
   **Extensão Obrigatória:** O sistema exige que a placa tenha exatamente 7 caracteres. Qualquer valor diferente disso resultará em um aviso de "Placa Inválida".

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Entrada: <code>abc 1234</code> → Processamento: <code>ABC1234</code></p></div>
2. Validação de Formato\
   Reconhecimento dos padrões vigentes para circulação veicular.\
   **Padrão Nacional Antigo:** Composto por 3 letras e 4 números. Formato <kbd>AAA-9999</kbd>.\
   **Padrão Mercosul:** Composto por 3 letras, 1 número, 1 letra e 2 números. Formato <kbd>AAA9A99</kbd>.

   <div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Regra de Segurança</strong></p><p>O último caractere da placa deve ser obrigatoriamente um número. Caso o usuário tente inserir uma letra no final, o sistema bloqueará o avanço.</p></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Entrada: <code>BRA3R52</code> (<strong>Padrão</strong> Mercosul aceito). <br>Entrada: <code>BRA3R5A</code> (<strong>Bloqueio</strong> por sufixo não numérico).</p></div>
3. Formatação Visual (Display)\
   Para placas que seguem o padrão nacional anterior (3 letras e 4 números), ocorre a inclusão automática de hífen exclusivamente para a exibição em tela. O campo de interface da Pesquisa Avançada é dimensionado com 8 caracteres para comportar essa formatação visual.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Digitação: <code>ABC1234</code> → Visualização em tela: <code>ABC-1234</code></p></div>

#### Comportamento por Contexto de Uso

<table><thead><tr><th width="220">Contexto</th><th>Regra de Aplicação</th></tr></thead><tbody><tr><td>Controle (Entrada/Saída)</td><td>O sistema exige que a placa já esteja cadastrada na base de dados de veículos. Se não encontrar, emitirá um alerta de "Veículo não cadastrado".</td></tr><tr><td>Cadastro de Veículo</td><td>O sistema valida apenas o formato e a extensão de 7 caracteres para a inclusão de novas placas na base de dados.</td></tr></tbody></table>

{% hint style="success" %}
**Dicas de Preenchimento**

A Pesquisa Avançada dispensa o uso da tecla <kbd>Caps Lock</kbd> ou a inserção manual de hifens e pontuações durante a digitação. A inserção de dados deve ser feita de forma contínua, apenas com letras e números, para que o sistema execute a padronização automática e a formatação visual adequada.

{% hint style="warning" %}
*Exemplo:*\
Digitação de `bra3r52` → Conversão automática para `BRA3R52`
{% endhint %}
{% endhint %}
