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 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 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.
...
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 |
Finalizada a escolha dos campos, clicar no botão “OK”. Por enquanto, estas serão as ações.
...
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 campos que fazem parte desta estrutura de dados, os quais fornecerão os dados para o relatório, conforme mostrado na figura abaixo:
...
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.
...
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.
...
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.
...