GladiusSimpleReport. Este manual, visa mostrar, como utilizar o GladiusSimpleReport atravéz de exemplos.

Transcrição

1 Introdução O GladiusSimpleReport é um gerador de relatório simples que permite gerar listagens baseadas em uma única tabela ou em um conjunto de tabelas relacionadas. Vantagens O GladiusSimpleReport permite que relatórios sejam criados sem a necessidade de intervenção da Daxis e sem que o projeto do sistema precise ser internamente alterado. Requisitos Para criar relatórios no GladiusSimpleReport é necessário que o operador tenha experiência em linguagem SQL. Quanto maior a experiência, mais complexos podem ser os relatórios desenvolvidos. Método do Manual Este manual, visa mostrar, como utilizar o GladiusSimpleReport atravéz de exemplos. Apoio Utilize o Manual de Tabelas Gladius para entender o relacionamento entre as tabelas do sistema Gladius e os campos disponíveis. Como um relatório é criado/descrito O relatório mostrado no GladiusSimpleReport é criado a partir de um arquivo texto, com extenção.crp que contém comandos que descrevem o relatório. Este arquivo, pode ser feito em qualquer editor de texto simples, como por exemplo o NotePad do Windows. Importante É obrigatório manter nomes de tabelas e campos em maiúsculo no processo de desenvolvimento do relatório, pois o sistema diferencia entre maiusculas e minusculas. Daxis Sistemas Página 1

2 Exemplo I Listagem Simples de Visitantes Este manual, visa mostrar, como utilizar o GladiusSimpleReport atravéz de exemplos. Exemplo do Relatório Pronto Estrutura do Relatório Daxis Sistemas Página 2

3 Arquivo Fonte do Relatório BANDAPRINCIPAL, TABELA_VISITANTES CONEXAOGLADIUS, C:\GLADIUSACESSO\GLADIUS.INI 90 8 BANDAPRINCIPAL, TABELA_VISITANTES, CONEXAOGLADIUS, SELECT * FROM ZRMC_VISITANTES WHERE (NOME<>'') AND (FONES <> '') ORDER BY NOME [@CABECALHO] 0, TEXTO, CHAPA 12, TEXTO, NOME 60, TEXTO, TELEFONE 0, NOVALINHA 0, TRACO 0, NOVALINHA [@DETALHE] 00, CAMPO, TABELA_VISITANTES, CHAPA, 10 12, CAMPO, TABELA_VISITANTES, NOME, 50 60, CAMPO, TABELA_VISITANTES, FONES, 30 00, NOVALINHA [@RODAPE] 00, TRACO 00, NOVALINHA 00, TEXTO, PESSOAS LISTADAS: TABELA_VISITANTES->COUNT 00, NOVALINHA 00, TRACO 00, NOVALINHA [@FIM_BANDA], BANDAPRINCIPAL Daxis Sistemas Página 3

4 Descrição passo-a-passo 1. Um relatório GladiusSimpleReport é composto de bandas que são as sessões de divisão de um relatório. Cada banda no relatório precisa ter um nome, e todos os relatórios necessáriamente precisam conter uma banda chamada BandaPrincipal, a qual será a seção principal do relatório. Em Nosso exemplo, a banda principal é descrita da seguinte forma: 2. Dentro da banda principal, precisamos definir, quais conexões com banco de dados iremos usar, neste caso, estamos definindo uma conexão chamada ConexaoGladius que é definida a partir do arquivo de configuração básico do gladius c:\gladiusacesso\gladius.ini. [@CONEXAO], CONEXAOGLADIUS, C:\GLADIUSACESSO\GLADIUS.INI Podemos definir mais de uma conexão ser for necessário, para isso, basta acrescentar mais uma linha de [@Conexao], usando o padrão [@Conexao], Nome, Nome_Do_Arquivo_Ini 3. As próximas 2 declarações definem a largura (em caracteres) da página e também o tamanho do Font de letra usado. O fonte padrão para o GladiusSimpleReport é sempre o Lucida Console, que é um fonte onde todas as letras ocupam o mesmo espaço horizontal na página. [@LARGURA],90 [@TAMANHO_FONT], 8 Daxis Sistemas Página 4

5 4. O próximo passo é definir quais tabelas serão abertas para obtenção dos dados do relatório, fazemos isso através do comando [@SQL] do GladiusSimpleReport. Você pode definir quantos [@SQL] quiser.. [@SQL], BANDAPRINCIPAL, TABELA_VISITANTES, CONEXAOGLADIUS, SELECT * FROM ZRMC_VISITANTES WHERE (FONES <> '') ORDER BY NOME O comando é descrito da seguinte forma: [@SQL], Nome_Da_Banda_Onde_Ela_Esta, Nome_Referencia_Tabela, Nome_Referencia_Conexao, Comando SQL. Neste caso a tabela esta na BandaPrincipal, seu nome de referência para o GladiusSimpleReport será TABELA_VISITANTES Importante: É obrigatório manter nomes de tabelas e campos em maiúsculo pois o sistema diferencia entre maiusculas e minusculas. 5. Agora, é necessário difinir três divisões dentro da Banda: [@CABECALHO], [@DETALHE] e [@RODAPE]. As divisões [@CABECALHO] e [@RODAPE] serão executadas apenas uma única vez dentro da banda. A banda [@DETALHE] será executada para cada registro presente na tabela consultada. Dentro de cada banda, podemos usar comandos que irão imprimir aquilo que desejamos, os comandos básicos são: Texto, Campo, Traco e NovaLinha. Os comandos funcionam da seguinte forma: Comando Texto Exibe um texto na posição indicada. Deve ser usado no modelo: Numero-da-Coluna, Texto, Texto-a-Exibir Por exemplo, se eu quiser exibir Gladius, na Coluna 70 da linha que está sendo Impressa, utilizarei da seguinte forma: 70, TEXTO, GLADIUS Comando Campo Exibe o conteúdo de um campo da tabela na posição indicada. Deve ser usado no modelo: Numero-da-Coluna, Nome-Referencia-Tabela, Campo-a-exibir, Tamanho-a-Formatar. Por exemplo, se eu quiser exibir o campo Nome, da tabela de visitantes, na coluna 20 da linha atual: 20, CAMPO, TABELA_VISITANTES, NOME, 50 Daxis Sistemas Página 5

6 Comando Traco Exibe um traço de separação na linha a partir da coluna inidicada. Por exemplo, para exibir um traço a partir da coluna até o fim da linha: 30, TRACO Comando Nova Linha Salta para a proxima linha a fim de exibir mais informações 6. Avaliando o cabelho, podemos notar que o sistema irá: [@CABECALHO] 00, Texto, Chapa (Exibir Chapa na coluna zero) 12, Texto, Nome (Exibir Nome na mesma linha, coluna 12) 60, Texto, Telefone (Exibir Telefone na mesma linha, col. 60) 0 (Saltar para proxima linha) 00, Traco (Fazer um traco) 0 (Saltar para proxima novamente) 7. Depois o sistema irá então, imprimir, para cada-registro-da-tabela, o detalhamento: [@DETALHE] 00, Campo, TABELA_VISITANTES, CHAPA, 10 ( Chapa) 12, Campo, TABELA_VISITANTES, NOME, 50 (Nome na Coluna 12) 60, Campo, TABELA_VISITANTES, FONES, 30 (Fone na coluna 60) 0 (Salta a linha) 8. Por fim, imprimos o rodapé seguindo as mesmas convenções acima [@RODAPE] 00, Traco 0 00, Texto, Pessoas listadas: TABELA_VISITANTES->COUNT 0 00, Traco 0 Note que no caso do comando Texto, podemos utilizar macros que representam algo que desejamos calcular sobre a tabela. Neste caso foi a quantidade de registros na tabela. Veja mais no item Macros 9. No final, terminamos a declaração que fecha a seção do relatório, neste caso, a seção principal: [@FIM_BANDA], BandaPrincipal Daxis Sistemas Página 6

7 Exemplo II Listagem de Empresas/Visitantes No segundo exemplo, iremos caminhar para algo um pouco mais complexo. O plano é fazer um relatório que liste todas as empresas cadastradas no sistema. Para cada empresa listada, o GladiusSimpleReport deverá listar também, todos os visitantes cadastrados para aquela dada empresa. Exemplo do Relatório Pronto Estrutura do Relatório Daxis Sistemas Página 7

8 Arquivo Fonte do Relatório BANDA PRINCIPAL, LISTA TABELA DE EMPRESAS BandaPrincipal, TABELA_EMPRESAS ConexaoGladius, c:\gladiusacesso\gladius.ini BandaPrincipal, TABELA_EMPRESAS, ConexaoGladius, SELECT * FROM ZRMC_EMPRESAS [@CABECALHO] 0,0 Texto, Relatorio de Empresas & Visitantes 0 00, Traco 0 [@DETALHE] 05, Texto, Codigo: 14, Campo, TABELA_EMPRESAS, CODIGO, 5 18, Texto, Nome: 26, Campo, TABELA_EMPRESAS, RAZAO, SUB-BANDA, TODOS OS VISITANTES DAQUELA EMPRESA [@BANDA], BandaVisitantes, TABELA_VISITANTES [@SQL], BandaVisitantes, TABELA_VISITANTES, ConexaoGladius, SELECT * FROM ZRMC_VISITANTES WHERE EMPRESA = TABELA_EMPRESAS->CODIGO [@CABECALHO] 15, Texto, Codigo: 26, Texto, Nome: 0 10, Traco 0 [@DETALHE] 15, Campo, TABELA_VISITANTES, CHAPA, 10 26, Campo, TABELA_VISITANTES, NOME, 40 Daxis Sistemas Página 8

9 10, Traco 1 10, Texto, Visitantes listados: TABELA_VISITANTES->COUNT 1 05, Traco 1 [@FIM_BANDA], BandaVisitantes FIM DA SUB-BANDA [@RODAPE] 0, Traco 0, Texto, Fim de Empresas [@FIM_BANDA], BandaPrincipal Como o Relatório é processado Neste segundo exemplo, existe uma Banda de Relatório que fica dentro da Banda principal. Isso significa que para CADA-REGISTRO na tabela principal, será desenhada a banda-detalheprincipal e em seguida também será executada toda uma outra BANDA (neste caso, listando os visitantes). Dentro do código, resumidamente, vemos: 1. Relatório, Baseado-na-relação de empresas 1.1 Cabeçalho (mostrando empresa) 1.2 Para cada empresa uma nova banda (Banda Visitantes) Pega todos os visitantes da empresa Mostra um Cabeçalho Lista um visitante Continua no item até acabar a relação dos visitantes Termina com um rodapé 1.3 Volta para o item 1.1 até terminar a relação de Empresas 1.4 Mostra o Rodapé das empresas Daxis Sistemas Página 9

10 Relacionando os visitantes de cada empresa O GladiusSimpleReport sabe quais visitantes listar devido a ligação que existe no comando SQL colocado na banda. [@SQL], BandaVisitantes, TABELA_VISITANTES, ConexaoGladius, SELECT * FROM ZRMC_VISITANTES WHERE EMPRESA = TABELA_EMPRESAS->CODIGO Neste caso, sempre que executar a banda Visitantes (ele executa uma vez para cada empresa), ele irá pegar a relação de visitantes referenciada pelo campo Código. Sempre que desejar referenciar outra tabela de nível superior, você pode utilizar o formato: NOME_DE_REFERENCIA_TABELA->CAMPO. Macros do Sistema O GladiusSimpleReport fornece algumas macros comandos que são substituídos por uma informação durante a apresentação do relatório. Neste caso, usamos uma para CONTAR quantos visitantes havia na tabela (veja na seção de rodapé): 10, Texto, Visitantes listados: TABELA_VISITANTES->COUNT Neste caso, a macro é TABELA_VISITANTES->COUNT, podemos usar as seguintes macros: REFERENCIA_TABELA->COUNT REFERENCIA_TABELA-> SOMA-CAMPO REFERENCIA_TABELA-> TOTALIZA-CAMPO SISTEMA->DATA SISTEMA->HORA -> Conta quantos registros tem -> Soma do campo (número inteiro) -> Totaliza campo (como valor) -> Data atual -> Hora atual Daxis Sistemas Página 10

11 Exemplo III Relatórios com Parâmetros No próximo exemplo, o sistema irá listar os acessos ocorridos entre duas datas escolhidas pelo usuário final. Neste caso, o GladiusSimpleReport irá precisar perguntar a data inicial e final em que a pessoa quer o relatório. GladiusSimpleReport Pedindo Parâmetros Exemplo do Relatório Pronto Daxis Sistemas Página 11

12 Arquivo Fonte do Relatório GladiusSimpleReport BandaPrincipal, TABELA_HISTORICO ConexaoGladius, c:\gladiusacesso\gladius.ini 90 8 DATA_INICIAL, DATE, 01/09/2013 DATA_FINAL, DATE, 09/09/2099 BandaPrincipal, TABELA_HISTORICO, ConexaoGladius, SELECT * FROM ZRMC_HISTORICO WHERE DATA AND DATA [@CABECALHO] 0, Texto, Data 12, Texto, Hora 22, Texto, Coletor 31, Texto, Tipo 44, Texto, Pessoa 0, Traco [@DETALHE] 0, Campo, TABELA_HISTORICO, DATA, 10 12, Campo, TABELA_HISTORICO, HORA, 10 22, Campo, TABELA_HISTORICO, COLETOR, 10 31, Campo, TABELA_HISTORICO, TIPO, 10 44, Campo, TABELA_HISTORICO, NOME, 40 [@RODAPE] 0, Traco 0, Texto, Pessoas listadas: TABELA_HISTORICO->COUNT 0, Traco [@RODAPE] 0, Traco 0, Texto, Fim de historico [@FIM_BANDA], BandaPrincipal Daxis Sistemas Página 12

13 Usando Parâmetros GladiusSimpleReport Os parâmetros a serem pedidos ao usuário final podem ser declarados na BandaPrincipal utilizando-se da declaração [@PARAMETRO]. Como no exemplo abaixo: Daxis Sistemas Página 13