Objetivo
O objetivo desta documentação é mostrar ao usuário como utilizar os eventos AddErro e AddWarning, ajudando-o a gerenciar melhor as situações de erro e avisos por meio do VsScripter.
Como será feito
Por meio dos métodos AddErro e AddWarning, são criadas mensagens que alertam sobre operações não permitidas e que devem ser revistas (AddErro), fazendo com que o usuário volte um passo nas suas ações para corrigir os itens problemáticos, ou mensagens de alertas para operações que não atendem totalmente à regra verificada, mas que não gera uma necessidade imediata de correção, permitindo que o usuário passe para a próxima etapa ou corrija o evento que gerou o aviso.
...
Nesta área de edição serão digitados os códigos implementados pelo usuário. Os componentes visuais a direita do formulário serão explicados nas documentações apropriadas.
...
Para descobrir o nome do formulário
...
Para manipular os elementos do formulário de Cadastro de Tomadores, ou qualquer outro formulário dos sistemas, é imprescindível saber o nome que identifica tal formulário. Para tanto, é necessário acessar o menu View e, em seguida, o submenu “Library Browser”. Este menu mostrará um formulário que listará todas as Classes, Funções e Constantes do formulário. Assim, é possível entender quais elementos estarão disponíveis para serem manipulados. Para o exemplo aqui, será focado na lista de constantes, clicando em “Constants”, conforme imagem abaixo:
...
Na lista de constantes, é possível identificar o nome do formulário padrão dado ao Cadastro de Tomadores. Neste exemplo, o nome do formulário que facilitará a manipulação dos componentes do formulário é “FFormPadraoRHTOMADOR”.que terá seus dados manipulados, siga as instruções da documentação Descobrindo o nome do formulário a ser manipulado e
Descobrindo informações sobre os campos dos formulários
...
Para facilitar o desenvolvimento dos “scripts” do VsScripter, foi desenvolvida uma funcionalidade que dá acesso ao dicionário de dados das tabelas envolvidas no formulário, bem como ao nome dado ao componente na tela.
Para acessar esses dados, deixar o campo desejado em foco, clicando com o mouse nele. Em seguida, executar o atalho CTRL+SHIT+F9, o qual abrirá outro formulário contendo os dados, conforme abaixo, que foi executado com o campo BAIRRO em foco:
...
Na área chamada Principal do formulário, na aba Propriedades, é mostrado o nome do componente no formulário, neste caso, o componente foi nomeado como “EB_BAIRRO” e o mesmo é do tipo TVsEdit.
O nome da coluna na tabela é informado na área Dados, juntamente com o nome da tabela, neste caso, a tabela é a RHTOMADOR.
Na aba Dados Tabela, é apresentado o dicionário de dados da tabela usada no formulário, neste caso, a tabela RHTOMADOR, conforme figura abaixo:
...
No grid Colunas são mostradas as colunas da tabela, com suas definições de tipo e tamanho, além de suas descrições. Ao lado, no grid Tabelas relacionadas, são mostrados os relacionamentos da tabela. Essas informações são importantes no momento da criação dos “scripts”, pois mostram exatamente quais são, como são e como utilizar os dados e elementos dos formulários.
O campo “BAIRRO” será tratado como um campo não obrigatório, porém, o usuário será alertado sobre a importância do mesmo no envio de correspondências, mas dando ao usuário a opção de continuar gravando os dados ou retornar ao formulário para indicar o valor do campo e, assim, salvar os dados.
...
Os dois exemplos de código podem ser colocados no mesmo evento, visto que ambos foram criados para serem executados pelo evento “AntesSalvar”.
Para informações mais detalhadas sobre as funções e procedures relacionadas a manipulação de dados nos formulários, acessar esta documentação.
Testando a implementação dos “scripts”
Quando os “scripts” forem digitados/colados na área de edição de código, os mesmos devem parecer como na imagem abaixo:
...
...
A A indentação foi feita da forma mostrada para ficar mais fácil a visualização e leitura do código.
...
No segundo “if”, é verificado se o campo “Código do município na RAIS” está vazio ou não. Se estiver, será gerado um evento de erro, por meio do método AddErro, que mostra a mensagem “Código do município na RAIS não pode ser vazio”. A partir deste ponto, o usuário não pode continuar e os dados não serão salvos a menos que seja feita a correção. Para tanto, o usuário deve clicar no botão “Corrigir” e preencher o campo referido. Observe que neste exemplo, o evento AddErro gera uma mensagem em vermelho para enfatizar o alerta.
...
Observação Observação importante: Os exemplos aqui mostrados não criticam os dados informados nos campos de exemplo. Apenas verificam se estão preenchidos ou não. Porém, é possível sim fazer uma validação personalizada dos dados informados pelos usuário, o que será mostrado na documentação adequada.
Para facilitar ainda mais o entendimento, foi produzido um vídeo sobre este conteúdo. Para acessá-lo, utilize o link abaixo: