Objetivo
O objetivo desta documentação é mostrar ao usuário como emitir relatórios criados no VsRel, por meio do VsScripter.
Como será feito
Como tratado no documento Emitindo relatórios desenvolvidos no VsRel a emissão de relatórios criados no VsRel, por meio do VsScripter, é relativamente simples. Algumas facilidades, como envio de parâmetros para filtragem de dados, podem ser executadas , permitindo o a impressão ou geração de PDFs das informações pesquisadas, conforme desenhado no VsRel.
...
Desenvolvimento do relatório no VsRel, seguindo as instruções apresentadas mais adiante;
Criação do script necessário para a emissão do relatório, com a passagem de parâmetros necessários para a localização do registro específico que fornecerá os dados para geração do crachá;
Inclusão de uma pessoa fictícia, no Cadastro de Pessoas do Folha e, depois, inclusão de um Prestador de Serviços, usando esta essa pessoa fictícia.
Criando o relatório no VsRel
Como o VsRel não é o objetivo principal desta documentação, as informações passadas aqui para o desenvolvimento do relatório irão considerar que o usuário que as esteja seguindo possui um mínimo de conhecimento necessário para operação do mesmo.
Escolher O próximo passo é escolher onde o relatório será salvo e, clicando com o botão direito do mouse, escolha a opção “Novo Relatório” no menu flutuante mostrado. O módulo de desenho do novo relatório será mostrado, como se segue:
...
Este relatório será iniciado pela seleção da fonte de dados que será usada para fornecer as informações que serão impressas. Para tanto, escolha a primeira aba, chamada “Dados”. Em seguida, no menu “Arquivo”, escolha o submenu “Novo” ou use o atalho “CTRL+N”.
Escolha a opção “Construtor de Consultas”, conforme figura abaixo:
...
Na aba “Tabelas”, escolher as tabelas abaixo, as quais guardam os dados necessários para o exemplo:
...
Na aba “Campos” serão mostrados todos os campos existentes nas tabelas selecionadas acima. Será necessário escolher os campos abaixo, pois apenas estes serão usados no relatório:
Apelido do campo | Apelidos da tabela e do campo no SQL (tabela.campo) |
Código da Pesso | RHPRESERV_1.IDPRESS |
Função | RHFUNCAO_1.IDFUNCAO |
Descrição | RHFUNCAO_1.DESCRICAO |
Foto da Pessoa | RHPESSOAFOTO_1.FOTO |
Nome | RHPESSOA_1.NOME |
CPF | RHPESSOA_1.CPF |
RG | RHPESSOA_1.RG |
Finalizando Finalizada a escolha dos campos, clicar no botão “OK”. Por enquanto, estas serão as ações.
A aba “Dados” deve ficar ser mostrada como está mostrado na figura abaixo:
...
Neste exemplo, a aba “Cálculo” não será utilizada, podendo ser escolhida a aba “Desenho”. Nela, será feito o “design” do relatório, onde os campos previamente selecionados serão posicionados para a formatação necessária ao nosso “layout”.
Na área principal de desenho do relatório, existem três subáreas onde os serão colocados os elementos do relatóriomesmo, de acordo com a destinação de cada elemento. Abaixo, uma representação da área principal:
...
Acima Acima da subárea “Cabeçalho”, normalmente são colocados os elementos referentes a identificação da empresa emitente do relatório e, também, identificação de quaisquer outras informações necessárias ao entendimento do relatório em si. Por exemplo: Nome do usuário que emitiu o relatório, título do relatório, data e hora de emissão, unidade a que se referem os dados expostos no relatório etc.
Neste exemplo específico, esta área não será utilizada, pois foi julgado que , para este exemplo didático, não se aplica.
Acima da subárea “Detalhe” e abaixo da subárea “Cabeçalho” será a área destinada ao desenvolvimento do desenho do relatório, que neste caso será um crachá temporário. O desenho sugerido será apresentado mais abaixo.
Acima Acima da subárea “Rodapé” e abaixo da subárea “Detalhe”, normalmente são colocados, por exemplo, os elementos referentes ao controle do número de páginas e quaisquer outros elementos que possam ajudar no entendimento do relatório.
Neste exemplo específico, esta área não será utilizada, pois foi julgado que , para este exemplo didático, não se aplica.
Tanto a subárea “Cabeçalho” e “Rodapé” são as área que possuem a maior parte de informações estáticas do relatório, como logotipo da empresa, nome do estabelecimento, endereço, título do relatório e quaisquer outros elementos que ajudem no entendimento do relatório.
Fonte de dados (campos) a serem inseridos no desenho do relatório
A direita do formulário de desenho de relatórios, existe uma área chamada “Estrutura de Dados”, onde estão referenciadas as fontes de dados escolhidas (tabelas e campos), chamada de “Prestadores_de_Servico”. Logo abaixo desta primeira área, são apresentados os “Campos para Prestadores_de_Servico”, que são os os campos que fazem parte desta estrutura de dados, os quais fornecerão os dados para o relatório, conforme mostrado na figura abaixo:
...
Basicamente, os campos serão arrastados e largados soltos na área “Detalhe” na ordem e posição concomitantes com o “layout” proposto. Observar o modelo sugerido abaixo:
...
Tanto a etiqueta “Nome:” quanto o campo “Nome” possuem tamanho da fonte igual a 12. Ou seja, o atributo “Size” do componente “Text Font” tem o valor 12. Os demais elementos, tanto etiquetas quanto campos, possuem tamanho igual a 10;
A etiqueta (label) que fica ao lado da foto pode ser excluída para uma apresentação visual melhorada do relatório. Clicar com o “mouse” sobre a etiqueta e pressionar a tecla “DEL”;
O campo “Nome”, que fornecerá o nome do prestador de serviços, possui o atributo “WordWrap” Habilitado, para que o nome seja dividido em duas linhas, se necessário;
A data informada em “Emissão” vem diretamente do sistema e é colocada automaticamente por meio do componente “Variável do Sistema”, que é representado pelo ícone de um pequeno calendário, mostrando um relógio de ponteiros os números “1” e “2”;
O “layout” aqui proposto tem fim exclusivamente didático, não obedecendo a qualquer norma técnica para desenho deste tipo de artefato, se essas existirem;
Para formatar o CPF que será mostrado no crachá, altere a propriedade “DisplayFormat” do campo “CPF” para “000\.000\.000\-00;0;”, clicando nas reticencias que existem no campo e digitando/colando a máscara no campo “Formato de Apresentação” que será mostrado e confirmando com um clique no botão “OK”;
Todos os elementos colocados no relatório ficaram com o nome padrão que é criado pelo VsRel. Porém, para manter as boas práticas de desenvolvimento, num relatório real, é sugestão dar nomes ao elementos de acordo com a funcionalidade e/ou conteúdo de cada um.
O próximo passo será desenhar um quadrado com a ferramenta “Polígono” que é representada por um ícone que mostra três figuras geométricas (um círculo roxo, um triângulo vermelho e um retângulo verde). Para tanto, basta selecionar a ferramenta e clicar com o botão esquerdo do “mouse” sobre a área de desenho “Detalhe”. Em seguida, será necessário alterar o tamanho e posição do quadrado criado até que o mesmo cubra todos os dados (etiquetas, campos e foto) colocados no relatório no passo anterior, cobrindo tudo e deixando uma margem de sobra nos quatro lados da figura.
Depois do retângulo pronto conforme descrito acima, clicar com o botão direito sobre o mesmo e escolha escolher a opção “Enviar para trás”, conforme figura abaixo:
...
Selecionar o retângulo criado e escolher o atributo “Appearance.Shape” e escolha escolher o valor “stRoundRect”, conforme indicado na figura abaixo:
...
Em seguida, ainda com o retângulo selecionado, altere alterar o atributo “Appearance.Brush.Color”, selecionando o valor “clSilver”, confirme conforme figura abaixo:
...
O “layout” do crachá deverá estar parecido com o da figura abaixo:
...
Para criar a mensagem “Temporário”, colocar uma etiqueta no formulário (componente “Label”), que é representando por um ícone que contém a letra “A” maiúscula. Clique neste ícone e depois clique em qualquer lugar da área de “Destalhe”“Detalhe”, preferencialmente em uma que não contenha algum elemento. Será criado um novo elemento com o texto “LabelX”, onde o X é um número de ordem qualquer, baseado no número de “labels” já colocadas no formulário.
...
Alterar o tamanho da etiqueta, mudando o valor do atributo “Text.Font.Size” para 42. Em seguida, arrastar a etiqueta sobre o retângulo vazio, alinhando-a até aparentar estar bem posicionada, conforme abaixo:
...
Inserindo um parâmetro que será utilizado para localizar o registro correto, que fornecerá os dados para o relatório “Prestador de Serviços - Crachá Temporário”
Para que o registro correto seja identificado no momento de sua inclusão e o código de identificação da pessoa incluída, é necessário criar um parâmetro que seja recebido na solicitação enviada pelo VsScripter e usado como filtro no VsRel.
...
A esquerda da área de edição do relatório existe uma área chamada de “Estrutura do Relatório”. Nela, existe um componente chamado “Report” e a primeira propriedade dele é a “Parameters”. É nesta propriedade que são inseridos os parâmetros que serão utilizados como filtros para a localização de registros. Clicar com o botão direito do “mouse” sobre “Parameters” e escolher “Novo” no menu flutuante.
...
Será inserido um parâmetro com o nome “Parameter1”, o qual será renomeado para “idPessoa”. Para alterar o nome, o atributo “Identity.UserName” deverá ser mudado para “idPessoa”.
...
Para adicionar o parâmetro “idPessoa”, necessário identificar qual é o campo que será comparado e qual o operador. Assim, clicar duas vezes sobre o campo “Código da Pesso”. O operador será o sinal de igualdade “=” e, no campo “Parameter”, selecionar “idPessoa”. Em seguida, clicar no botão “OK”.
...
Para continuar, é necessário salvar o relatório. Por meio do menu “Arquivo”, submenu “Salvar” (ou por meio do atalho “CTRL+S”), será aberto a caixa de diálogo “Salvar Novo Relatório Como”. Usar o nome “Prestador de Serviços - Crachá Temporário” para salvar o relatório e clicar no botão “Salvar”.
...
Clicar no botão “OK” para confirmar.
Criando o “Script” no VsScripter
No Folha, abrir o “Cadastro de Pessoas” e criar uma pessoa fictícia para o teste.
...
Para a emissão do relatório alvo deste material, será utilizado o evento “Após Salvar” do VsScripter.
O comentário que vem na área de edição de “scripts” do VsScripter, por padrão, pode ser excluído ou não, a critério do usuário.
...
Nas documentações acima, é possível entender como é feita a leitura de um valor atribuído a um componente da tela, especificamente, no formulário onde os eventos do VsScripter serão executados, além do próprio nome do formulário onde os dados serão manipulados e o nome dos respectivos campos desse formulário.
Testando a emissão do relatório
Para testar a emissão do relatório, se faz necessário incluir uma pessoa fictícia no Cadastro de Pessoas e, em seguida, inserir um Prestador de Serviços usando esta pessoa fictícia. No momento de salvar o Prestador de Serviços, será mostrada uma mensagem informando da impressão do relatório e, em seguida, uma caixa de diálogo de impressão será mostrada. Nela, o usuário poderá escolher em qual impressora imprimir além das demais opções inerentes à impressão, com os dados desta pessoa fictícia cadastrada como Prestador de Serviços.
...