GERADOR DE RELATÓRIOS WINREPORT VERSÃO 2.0 Este manual foi desenvolvido com o objetivo de documentar as principais funcionalidades do Gerador de Relatórios WinReport versão 2.0. Conteúdo 1. Tela Principal ................................................................................................................................ 3 2. Editor SQL .................................................................................................................................... 4 2.1 SQL ................................................................................................................................... 4 2.2 Resultado .......................................................................................................................... 5 2.3 Parâmetros........................................................................................................................ 6 3. Configurações do Relatório ......................................................................................................... 8 3.1 Geral ................................................................................................................................. 8 3.2 Campos do Relatório ........................................................................................................ 9 3.3 Quebras do Relatório........................................................................................................ 9 3.4 Totalizadores................................................................................................................... 10 4. LAYOUT DO RELATÓRIO ...................................................................................................... 11 4.1 Layout ............................................................................................................................. 11 4.2 Propriedades ................................................................................................................... 13 4.3 Configurações................................................................................................................. 15 5. VISUALIZAR RELATORIO ..................................................................................................... 16 5.1 Seleção de Parâmetros ................................................................................................... 16 5.2 Pré-Visualização do Relatório ....................................................................................... 18 5.3 Opções da Pré-Visualização ........................................................................................... 21 Windel Sistemas – WinReport - Gerador de Relatórios LISTA DE FIGURAS Figura 1.1: WinReport ...................................................................................................... 3 Figura 2.1: Editor de SQL ................................................................................................ 5 Figura 2.2: Resultado do SQL .......................................................................................... 5 Figura 2.3: Parâmetros...................................................................................................... 6 Figura 2.4: Parâmetros relacionados com tabelas ............................................................ 7 Figura 2.5: Parâmetros múltipla seleção .......................................................................... 7 Figura 3.1: Configuração do Relatório ............................................................................. 8 Figura 3.2: Campos do Relatório...................................................................................... 9 Figura 3.3: Quebras do Relatório ................................................................................... 10 Figura 3.4: Totalizadores ................................................................................................ 10 Figura 4.1: Layout do relatório....................................................................................... 11 Figura 4.2: Layout do Relatório com quebra e totais ..................................................... 12 Figura 4.3: Layout do Relatório com duas quebras e totais ........................................... 12 Figura 4.4: Layout do Relatório com logo ..................................................................... 13 Figura 4.5: Propriedades dos Campos ............................................................................ 14 Figura 4.6: Propriedades das Bandas.............................................................................. 14 Figura 4.6: Configurações do Layout do Relatório ........................................................ 15 Figura 5.1: Seleção dos Parâmetros................................................................................ 16 Figura 5.2: Visualização do Relatório ............................................................................ 18 Figura 5.3: Relatório Colorido ....................................................................................... 19 Figura 5.4: Relatório com Logo e Detalhe Zebrado ....................................................... 20 Figura 5.5: Relatório com Período de Datas................................................................... 20 Figura 5.6: Imprimir Relatório ....................................................................................... 22 Figura 5.7: Salvar Relatório............................................................................................ 22 Figura 5.8: Enviar E-mail ............................................................................................... 23 Pág. 2 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 1. Tela Principal O WindelReport permite montar um relatório a partir de comandos SQL e configurações. A figura 1.1 ilustra a tela principal do sistema WinReport na versão beta 1.3. A tela principal contém dois botões: Novo relatório Abrir relatório existente Figura 1.1: WinReport Pág. 3 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 2. Editor SQL O gerador de relatórios possui diversas abas para as configurações do relatório gerado: SQL, Resultado, Parâmetros e Configurações. 2.1 SQL SQL (Structured Query Language) é uma linguagem estruturada para manipulação de informações do banco de dados. O aba SQL é um Editor de SQL que permite digitar o SQL de consulta no Banco de Dados. As informações com a sintaxe dois pontos ( : ) antes de um nome, “ :parametro ” são os parâmetros do SQL. As listas Tabelas e Campos permitem a inclusão destas informações no editor de sql. Digitando-se nome da tabela, um ponto e CTRL+ Barra de Espaços mostra os campos da tabela no editor de textos. O editor de SQL possui diversos botões e suas funcionalidades: Salva as configurações do relatório. Executa o SQL. Insere o comando Select no editor de SQL. Insere o comando Left Join no editor de SQL. Insere o comando Where no editor de SQL. Insere o comando Between ... and no editor de SQL. Insere o comando Group By no editor de SQL. Insere o comando Order By no editor de SQL. Insere tabela ou campo da tabela no editor de SQL. A figura 2.1 ilustra o editor de SQL do gerador de relatórios. Pág. 4 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios Figura 2.1: Editor de SQL 2.2 Resultado A figura 2.2 ilustra a aba de resultado do SQL que mostra o resultados dos dados selecionados no SQL. Figura 2.2: Resultado do SQL Pág. 5 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 2.3 Parâmetros A aba de Parâmetros permite configurar os parâmetros do SQL. Para cadastrar um novo parâmetro clique com o botão direito ou pelas teclas de atalho CTRL + N, conforme figura 2.3. Figura 2.3: Parâmetros Os tipos de entrada dos parâmetros são: Opção de Valores, Valor, Dados e Múltipla Seleção. Podem-se relacionar parâmetros com outras tabelas utilizando o tipo de entrada Dados, conforme o exemplo da figura 2.4. Deve-se selecionar a tabela do parâmetro, a chave que será igualada ao parâmetro, o campo descrição do parâmetro e pode-se digitar uma condição para a seleção do parâmetro. Por exemplo para selecionar os clientes: A tabela é pessoas, campo chave é pessoas.idpessoa, o campo descrição é pessoas.nome e a condição é pessoas.idempresa = 1 and pessoas.idtipo_ps = 1. Pág. 6 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios Figura 2.4: Parâmetros dados relacionados com tabelas Na figura 2.5 para informar os parâmetros do tipo Múltipla Seleção deve-se informar os dados. Deve-se selecionar a tabela do parâmetro, campo chave, campo descrição e uma condição caso seja necessário. Figura 2.5: Parâmetros múltipla seleção Pág. 7 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 3. Configurações do Relatório A aba de Configurações do relatório permite visualizar os campos selecionados no SQL. O botão layout do relatório encaminha para o designer do layout do relatório. 3.1 Geral Na primeira aba, Geral, pode-se informar o título do relatório, a empresa que aparecerá no cabeçalho do relatório, duas linhas opcionais de cabeçalho, as observações, a orientação do papel, a opção de imprimir colorido, a opção mostrar período e o caminho do logotipo. O campo de Observações irá aparecer na tela de parâmetros da visualização do relatório. O campo Orientação do Papel permite selecionar a orientação do relatório retrato ou paisagem. O campo Imprimir Colorido permite imprimir com as quebras coloridas. O campo Caminho do Logo permite selecionar uma imagem para ser impressa no título do relatório. O campo Mostrar Período permite que na impressão do relatório sejam mostrados os períodos de datas informados nos parâmetros. A aba geral possui dois botões: Salva as configurações do relatório. Entrar na edição Layout do Relatório A figura 3.1 ilustra a configuração do relatório. Figura 3.1: Configuração do Relatório Pág. 8 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 3.2 Campos do Relatório A segunda aba, Campos do Relatório, permite selecionar os campos mostrados no layout do relatório. Para selecionar um campo arraste e solte os campos disponíveis na lista campos. Para alterar o rótulo do campo clique com o botão direito sobre ele ou use as teclas de atalho CTRL+R conforme pode ser visto na figura 3.2. Figura 3.2: Campos do Relatório 3.3 Quebras do Relatório A terceira aba, Quebras do Relatório, permite selecionar os campos que estarão na banda de quebra do relatório. Permite incluir duas bandas de quebra. A primeira pode quebrar de página, conforme a figura 3.3. Pág. 9 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios Figura 3.3: Quebras do Relatório 3.4 Totalizadores A quarta aba, Totalizadores, permite incluir uma banda de Total Geral no relatório e selecionar campos numéricos para totalizar conforme a figura 3.4. Quando houver quebra esses campos também serão totalizados na banda de total da quebra. Figura 3.4: Totalizadores Pág. 10 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 4. LAYOUT DO RELATÓRIO O layout do relatório permite entrar no modo designer do layout do relatório do software livre Fortes Report1. 4.1 Layout A figura 10 ilustra o designer do Fortes Report do relatório como pode ser visto pela figura 4.1. O layout do relatório possui três botões: Salva as configurações do designer do layout. Editar Fonte de Dados retorna para a tela de configuração do relatório. Visualizar permite a visualização do relatório. Figura 4.1: Layout do relatório Pág. 11 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios A figura 4.2 ilustra o designer do layout de um relatório com uma quebra e total. Figura 4.2: Layout do Relatório com quebra e totais A figura 4.3 ilustra o designer do layout de um relatório com duas quebras e totais. Figura 4.3: Layout do Relatório com duas quebras e totais Pág. 12 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios A figura 4.4 ilustra o designer do layout relatório com impressão colorida e o logotipo da empresa. Figura 4.4: Layout do Relatório com logo 4.2 Propriedades O designer possibilita que sejam alteradas as Propriedades (Object Inspector) dos campos da tela do relatório tais como: nome, altura, largura, esquerda, topo, casas decimais e alinhamento. Os valores permitidos nas casas decimais são “S” ou “N”. Caso seja digitado “S” será formatado o valor com duas casas decimais. E os valores permitidos no alinhamento são: “E” (esquerda), “D” (direita), “J” (justificado) e “C” (centralizado). Pág. 13 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios A figura 4.5 ilustra as opções do Object Inspector do Designer, ou seja, as propriedades dos campos do relatório: altura, largura, esquerda, topo, casas decimais, fonte, tamanho da fonte e alinhamento. Figura 4.5: Propriedades dos Campos A figura 4.6 ilustra quando as propriedades forem de uma banda terá as opções: altura e linha horizontal. Figura 4.6: Propriedades das Bandas Pág. 14 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 4.3 Configurações A aba Configurações permite selecionar a impressão de página, data e hora no cabeçalho, impressão matricial e dimensões do papel conforme a figura 4.6. Figura 4.6: Configurações do Layout do Relatório Pág. 15 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 5. VISUALIZAR RELATORIO Ao clicar no botão Visualizar pode-se gerar o relatório (preview). 5.1 Seleção de Parâmetros A seleção de parâmetros pode ser com campos de valores, data, dados relacionados com outras tabelas, opções de valores ou múltipla seleção. Na visualização, caso o relatório tenha parâmetros será gerada a tela de seleção dos parâmetros conforme a figura 5.1. Figura 5.1: Seleção dos Parâmetros Pág. 16 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios Na visualização, caso o relatório tenha parâmetros de opções de valores ou múltipla seleção será gerada a tela de seleção dos parâmetros conforme a figura 5.2. Figura 5.2: Seleção dos Parâmetros Avançados Pág. 17 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 5.2 Pré-Visualização do Relatório A figura 5.3 ilustra um Relatório de Notas Fiscais gerado pelo WindelReport com duas quebras, uma quebra por data de emissão e outra quebra por Número e Série da Nota Fiscal e o detalhe com os itens da nota. Figura 5.3: Visualização do Relatório Pág. 18 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios A figura 5.4 ilustra a visualização do relatório com a opção Imprimir Colorido marcado. Figura 5.4: Relatório Colorido Pág. 19 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios Para imprimir configurar o logo indique o caminho na configuração do relatório e para mostrar o detalhe zebrado marque a opção Imprimir Zebrada as linhas do relatório. A figura 5.5 ilustra a impressão com logo e impressão zebrada dos detalhes. Figura 5.5: Relatório com Logo e Detalhe Zebrado A figura 5.6 ilustra o relatório com período de datas dos parâmetros. Figura 5.6: Relatório com Período de Datas Pág. 20 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios 5.3 Opções da Pré-Visualização As opções da pré-visualização são: Imprimir, Salvar, Enviar e Fechar. imprimir o relatório. salvar ou Exportar o relatório vários formatos. enviar o relatório por e-mail como anexo no formato pdf. fechar o relatório. Windel Sistemas – WinReport - Gerador de Relatórios A figura 5.7 ilustra a tela de impressão do relatório gerado. Figura 5.7: Imprimir Relatório Pág. 21 Setor de Analise Windel Sistemas Ltda Windel Sistemas – WinReport - Gerador de Relatórios A figura 5.8 ilustra a tela para salvar o relatório gerado nos formatos: formato rich text, pagina da web, documento pdf e planilha do Excel. Figura 5.8: Salvar Relatório A figura 5.9 ilustra o envio do relatório em formato pdf por e-mail ao clicar no botão Enviar da visualização. Figura 5.9: Enviar E-mail Pág.22 Setor de Analise Windel Sistemas Ltda