Melhoria de Usabilidade no Cadastro de Cidades

Melhoria de Usabilidade no Cadastro de Cidades | 144334 | Resulth ERP


1. CONTEXTO


Ao incluir uma nova cidade, o sistema passava o foco do cursor pelo botão “Busca” mesmo quando o usuário já havia informado o código do município manualmente. Esse comportamento exigia um pressionamento extra de TAB ou ENTER para avançar ao próximo campo, interrompendo o fluxo de digitação.


Com esta melhoria, o sistema passou a reconhecer quando o campo Cod. Mun. está preenchido e, nesse caso, salta automaticamente o botão “Busca”, mantendo o fluxo contínuo de inclusão. Além disso, foi adicionada uma validação que alerta o usuário caso o código informado não exista na base de dados.


2. O QUE MUDOU


  • Novo comportamento de Tab Order: quando o campo Cod. Mun. está preenchido, o foco salta o botão “Busca” e vai direto para o próximo campo.

  • Comportamento preservado: quando o campo Cod. Mun. está vazio, o foco continua passando pelo botão “Busca” normalmente, como antes.

  • Nova validação de código: ao confirmar um código de município inexistente com ENTER ou TAB, o sistema exibe uma mensagem de alerta sem interromper a inclusão.


3. COMO ACESSAR


Esta melhoria está disponível diretamente na tela de Cadastro de Cidades. Nenhuma configuração de parâmetro é necessária.


Caminho: Resulth BusinessCadastrosClientesCidades


4. COMO USAR


4.1 Inclusão com código de município informado


  1. Acesse o caminho indicado acima e clique em Inclusão.

  2. Preencha os campos Código, Cidade e Estado.

  3. No campo Cod. Mun., informe o código do município e pressione TAB ou ENTER.

  4. O cursor avança diretamente para o próximo campo, sem parar no botão “Busca”.

  5. Conclua o preenchimento e clique em Ok para salvar.


img

Tela de Cadastro de Cidades — o campo Cod. Mun. com código preenchido salta o botão Busca ao pressionar TAB ou ENTER


4.2 Inclusão sem código de município


  1. Acesse a tela e clique em Inclusão.

  2. Preencha os campos necessários, mas deixe o campo Cod. Mun. vazio.

  3. Ao pressionar TAB ou ENTER no campo Cod. Mun., o foco passará pelo botão Busca normalmente, como no comportamento anterior.


Sem o código do município preenchido, o botão Busca continua acessível via teclado, permitindo que o usuário o utilize para pesquisar o município desejado.


5. COMPORTAMENTO POR CENÁRIO


A tabela abaixo resume o comportamento do Tab Order conforme o estado do campo Cod. Mun.:


Cenário

Comportamento do Tab

Mensagem exibida

Cod. Mun. preenchido

O foco ✔ salta o botão “Busca” e vai direto para o próximo campo

— nenhuma mensagem

Cod. Mun. não preenchido

O foco passa pelo botão “Busca” normalmente (comportamento anterior)

— nenhuma mensagem

Cod. Mun. preenchido com código inexistente

O foco salta o botão “Busca” e o processo de inclusão segue normalmente

⚠ Alerta: “O código do município informado não existe na base de dados” + botão OK


6. REGRAS DE NEGÓCIO


  • A validação do código de município é somente informativa: ao receber o alerta, o usuário clica em OK e a inclusão prossegue normalmente. Não há bloqueio.

  • A mensagem de alerta é: “O código do município informado não existe na base de dados”.

  • O comportamento se aplica única e exclusivamente ao fluxo de inclusão de uma nova cidade.

  • O botão Busca continua funcional: o usuário pode clicá-lo com o mouse a qualquer momento para pesquisar o município.


7. BOAS PRÁTICAS E OBSERVAÇÕES


💡

Dica: sempre que possível, informe o Cod. Mun. correto antes de avançar. Além de agilizar a inclusão, isso garante que o município será vinculado ao código oficial do IBGE.


Atenção: ao receber a mensagem de código inexistente, verifique se digitou corretamente o código do município antes de confirmar com OK. A inclusão será concluída mesmo com um código inválido.



Código CEST e Descrição CEST na Pesquisa de Produtos
Melhoria de Usabilidade: Emissão de Etiquetas de Produtos