...
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.
...
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.
...
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”.
...
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.
...