Edição de 16h09min de 7 de outubro de 2016

Voltar a Página Inicial - Menu Sistemas

Introdução

Este documento descreve como usar o Gerador de Relatórios web juntamente com o iReport

Gerador de Relatórios Web

• Os relatórios e sub-relatórios deverão ser carregados individualmente
• No relatório principal carregar o arquivo com extensão .jrxml, pois algumas informações são extraídas do XML, como a consulta SQL; Já para os sub-relatórios, carregar os arquivos compilados (.jasper)

Tipos

• Quando houver o tipo TEXT (Classe Clob) utilizar o seguinte em FieldExpression:
  • $F{CAMPO}.getSubString( 1, 9999) //para truncar em 9999 OU
  • $F{CAMPO}.getSubString( 1, $F{CAMPO}.length().intValue()) //para não truncar OU
  • CAST para varchar/nvarchar na própria SQL //para truncar que o tipo convertido tem

iReport com sub-relatórios

• Criar um arquivo (.jrxml) para cada relatório
• No elemento sub-relatório do relatório principal, em Subreport Properties configurar
  • Subreport Expression, ligando o relatório principal e o sub-relatório, tomando o cuidado para não deixar o caminho do diretório fixo, ou seja, usar o parâmetro $P{prmCaminho}. Ex: $P{prmCaminho} + "GR200-sub1.jasper"
  • Connection Type: selecionar a opção use a connection expression
  • Connection Expression: configurar selecionando o parâmetro Report_Connection
  • Parameters: configurar os parâmetros e as respectivas colunas da consulta SQL
• No sub-relatório deverão ser criados no item Parameters os campos de ligação entre as consultas SQL do relatório principal e do sub-relatório, bem como deverão ser colocados no SQL do sub-relatório
• O sub-relatório não deverá ter margens, pois serão usadas as definidas no relatório principal

iReport: criação de conexão com BD

• Clicar em Report DataSources
• DataSource type: Database JDBC Connection
• JDBC Driver: MS SQLServer (net.sourceforge.jtds.jdbc.Driver)(o arquivo deve estar em C:\Program Files (x86)\Jaspersoft\iReport-4.1.1\ireport\modules\ext\jtds-1.2.5 e ser adicionado o caminho no CLASSPATH)
• JDBC URL: jdbc:jtds:sqlserver://200.201.88.206/bdAcademicoProducao

Fontes e Styles em campos

• Usar o Style padrão em vários campos pode reduzir o tempo para aplicar um mesmo estilo a todos os campos do relatório.

• Para alterar as FONTES/STYLES DINAMICAMENTE de um relatório realizar os seguintes passos:
  

1° - adicionar um style padrão (aplicar este em todos os campos que deverão ser alterados)
2° - botão direito sobre o style criado e "Adicionar Style Condicional"
3° - definir as propriedades do style condicional, quando a condição definida for satisfeita as propriedades do condicional serão aplicadas sobrescrevendo o style padrão.

- Pode-se definir diversos estilos diferentes que são trocados conforme o valor de um parâmetro enviado, assim podemos ir setando a fonte, cores e outros conforme a necessidade.
- A aplicação de apenas parte das propriedades no style não irá afetar propriedades definidas nos campos, por ex. Desejo alterar a fonte de todos os campos, mas alguns são em negrito e outros em itálicos, então é só definir a fonte dos campos como padrão (Restore valor padrão na fonte) e aplicar o negrito e itálico conforme precisar. **só é sobrescrito o que for definido no style e for padrão no campo.

• Observação: Caso o estilo criado não for aplicado visualmente quando executado o relatório, os campos que possuem o Style (especificamente as propriedades do campo) devem ser setadas com os valores padrões, para isso: botão direito sobre a propriedade do campo e "Restaurar Valor Padrão". Caso não seja feito isso as propriedades do campo sobrescrevem a propriedade do style.

Trace no relatório

• Abrir o SQL Profiler
• Aba General > Use the template: TSQL
• Aba Events Selection > Column Filters > filtro LoginName: domínio\usuário (ex: unioestenet\liege.ciupak)

Log de erros na execução do relatório

Editar o arquivo \\200.201.88.170\d\glassfish3\glassfish\domains\domain1\logs\server.log

Local de armazenamento dos relatórios

\\200.201.88.170\d\sistemas\relatorios

Validação de Documentos

A rotina para validar documentos foi criada com a finalidade de emitir documentos para a comunidade da UNIOESTE através dos sistemas WEB. A emissão de documentos que podem ter sua validade comprovada através da internet é útil para a emissão de declarações de matrículas, certificados e outros.

Os documentos são emitidos como um relatório normal do iReport, chamando a rotina de geração e devolvendo o relatório, porém parâmetros adicionais devem ser enviados na requisição para que o sistema entenda que esta solicitação deve ser gravada na tabela de documentos emitidos para que posteriormente seja efetuada uma consulta à validade do documento e/ou o documento seja recuperado na íntegra.

UTILIZAÇÃO

• Os documentos emitidos podem ser manipulados através da classe DctEmtWebUtil, essa classe possui alguns métodos para criação e manipulação dos documentos.

• Quando for solicitada a geração de um relatório que deve ser salvo, o parâmetro "salvarParaValidar" deve ser informado com 'T' (true), ou enviado através das opções (mesma opção com parâmetro 0 - salvarParaValidar)

• Caso o documento já exista e o resultado do relatório deva ser gravado nele, o parâmetro "dctEmtWebSequencia" deve ser enviado juntamente com o parâmetro para salvar. Estes parâmetros só precisam ser enviados manualmente quando o relatório é emitido sem o auxílio da classe DctEmtWebUtil.java, pois está já faz os devidos tratamentos em seus métodos.

• A banda PageFooter do iReport deve estar disponível, pois serão gravados nela os elementos da validação.

Existe uma rotina que realiza periodicamente a limpeza da tabela de documentos, removendo assim os arquivos PDF da tabela para que não utilizem espaço de armazenamento após tornar-se inválido, vencido ou substituído.

Bandas automáticas nos Relatórios

Cabeçalho Padrão