ReportMaker - Histórico de revisão

Rodrigogml: Rodrigogml moveu a página BISReports para ReportMaker sem deixar um redirecionamento

2015-09-07T18:53:48Z

Rodrigogml moveu a página BISReports para ReportMaker sem deixar um redirecionamento

← Edição anterior	Edição das 18h53min de 7 de setembro de 2015
(Sem diferença)

Rodrigogml: /* Referências */

2015-06-06T19:37:04Z

Referências

@@ Linha 137: / Linha 137: @@
 Obviamente que há passos anteriores aos 3 citados acima, como por exemplo captar e definir eventuais configurações do relatório.
 == Referências ==
 <references/>

Rodrigogml: /* Cabeçalhos e Rodapés */

2015-06-06T18:53:39Z

Cabeçalhos e Rodapés

← Edição anterior		Edição das 18h53min de 6 de junho de 2015
Linha 29:		Linha 29:
	Abaixo estão listados os modelos existentes atualmente:		Abaixo estão listados os modelos existentes atualmente:

			==== Cabeçalho de Relatório: Modelo 1 ====

			Dados exibidos:
			* '''Nome da Empresa'''
			* '''Título do Relatório'''
			* '''Data de Geração'''

			[[Image:ReportHeaderModel1.png\|link=\|center\|framed\|Exemplo de Cabeçalho de Relatório: Modelo 1]]

			==== Rodapé de Página: Modelo 1 ====

			Dados exibidos:
			* '''Número da Página'''

			[[Image:PageFooterModel1.png\|link=\|center\|framed\|Exemplo de Rodapé de Página: Modelo 1]]

	=== Métodos Utilitários ===		=== Métodos Utilitários ===

Rodrigogml: /* getCoord* */

2015-06-06T13:32:28Z

getCoord*

← Edição anterior		Edição das 13h32min de 6 de junho de 2015
Linha 65:		Linha 65:

	Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.		Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.

			==== setPageSize* ====

			Os métodos setPageSize já contém alguns tamanhos "padrões" de folhas, e permitem que o tamanho da folha a ser usada no relatório seja definido de forma mais ágil. Inclusive rotacionar o tamanho para trocar do formato '''Retrato''' para '''Paisagem'''.

			==== setMargins() ====

			Permite que as margens do relatório sejam redefinidas. As margens padrão já são definidas para garantir que de forma geral nenhuma impressora do mercado "corte" informações nas bordas do papel. No entanto ainda é possível tentar ampliar ou reduzir essas margens conforme necessidade.

			Os valores definidos como padrão é de 36px.

	== BISReportBean ==		== BISReportBean ==

Rodrigogml em 02h43min de 6 de junho de 2015

2015-06-06T02:43:58Z

← Edição anterior		Edição das 02h43min de 6 de junho de 2015
Linha 66:		Linha 66:
	Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.		Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.

	==~~= Implementando um BISReport =~~==		== BISReportBean ==

	~~Implementar uma classe de~~ relatório ~~precisa apenas~~ de ~~poucos passos:~~		O BISReportBean é um objeto que "carrega" todas as configurações necessárias para a geração do relatório. Ao invés de um construtor complexo com inúmeros atributos, optamos por receber este único objeto com todas as configurações necessárias internamente.
	~~# Crie uma classe que estenda BISReport;~~
	~~# Crie uma classe de Bean que estenda BISReportBean~~, ~~preferencialmente~~ com ~~o mesmo nome (exceto pelos sufixos diferentes: Report e ReportBean);~~
	~~# Implemente o método writeReportContent(), que é abstrato em BISReport;~~

	~~Esses três passos~~ são ~~o suficiente para criar a estrutura para começar a implementar~~ o relatório~~. A partir deste ponto começa~~ a ~~implementação específica de cada relatório em duas etapas: '''obtenção/preparação dos dados'~~'' e ~~'''escrita no documento'''~~.		O BISReportBean tem alguns atributos usados no relatório, e todos os atributos já são instanciados com valores que definem o relatório, como por exemplo, que a folha é A4 no formato 'Retrato', e algumas margens padrões para impressão.

	A '''obtenção/preparação dos dados''' significa obter os dados que serão escritos no relatório. Para alguns relatórios esses dados podem ser obtidos pela própria classe do Report, quando já virem dentro do ReportBean da classe.

			{{stop\|Locale\|Embora o relatório seja classe do Core, muitos dados precisam ser tratados de acordo com o Locale do usuário, afinal, relatório é como uma "interface que exibe dados para o usuário", e precisa ser legível à maneira que ele é acostumado a ver a informação: decimais com "," ou ".", datas com "dd/mm/aaaa" ou "mmm dd,aaa", etc..

	~~{{nota\|Código~~ de ~~Obtenção dos Dados\|As classes~~ "~~Report~~" ~~fazem parte do CRUD~~, ~~isto quer dizer~~ que ~~as classes Report podem chamar diretamente os métodos do CRUD do mesmo módulo/plugin~~.		Ao iniciar o Bean procure sempre passar o Locale do usuário, provavelmente enviando-o junto durante a requisição da interface. Caso o relatório esteja sendo executado de outro "ator", como uma integração de outro sistema, ou uma tarefa agendada é preciso tomar o cuidado de definir o locale que será usado. O locale pode vir de diversos lugares, é preciso analisar cado a caso.

	~~Também é recomendável que esses dados sejam obtidos diretamente no construtor do relatório. Fazendo com que~~ o ~~construtor lance as exceções necessárias diretamente~~.}}		Por fim, se nenhum Locale for especificado o BISReportBean usará como valor padrão o Locale retornado como padrão na JVM.}}


	Já a ~~'''escrita no documento''' deve ser feita toda dentro do método abstrato herdado de BISReport - writeReportContent(). Chamado da~~ classe ~~pai quando for a hora de gerar~~ o relatório, ~~este método~~ é ~~quem deverá conter toda~~ a ~~lógica~~ de ~~"desenho e escrita no papel"~~. ~~Para saber como "escrever no papel" veja o guia~~		É sugerido que os relatório sigam o mesmo padrão. Que recebam em seu construtor a mesma classe BISReportBean ou outro Bean específico para o relatório. Neste caso, também é sugerido que o Bean específico para o relatório estenda o BISReportBean. Desta forma um único objeto carregará todas as informações necessárias, tanto para o BISReport quando para a classe de Relatório.

	~~== BISReportBean ==~~		Entre os atributos específicos de cada relatório podem estar o "MO" que o relatório usará para obter os dados no CRUD, ou mesmo a coleção de dados/objeto que ele deverá usar para montar o relatório. Sendo obviamente livre e de definição de cada relatório definir seus atributos e informações necessárias.

	~~O BISReportBean é~~ um objeto que "carrega" todas as configurações necessárias para a geração do relatório. Ao invés de um construtor complexo com inúmeros atributos, optamos por receber este único objeto com todas as configurações necessárias internamente.		== Implementando um BISReport ==

	O BISReportBean ~~tem alguns atributos usados no relatório~~, e ~~todos os atributos já são instanciados com valores que definem~~ o ~~relatório, como por exemplo~~, que ~~a folha~~ é ~~A4 no formato 'Retrato', e algumas margens padrões para impressão.~~		Implementar uma classe de relatório precisa apenas de poucos passos:
			# Crie uma classe que estenda BISReport;
			# Crie uma classe de Bean que estenda BISReportBean, preferencialmente com o mesmo nome (exceto pelos sufixos diferentes: Report e ReportBean);
			# Implemente o método writeReportContent(), que é abstrato em BISReport;

			Esses três passos são o suficiente para criar a estrutura para começar a implementar o relatório. A partir deste ponto começa a implementação específica de cada relatório em duas etapas: '''obtenção/preparação dos dados''' e '''escrita no documento'''.

	~~{{stop\|Locale\|Embora o~~ relatório ~~seja~~ classe do ~~Core~~, ~~muitos dados precisam ser tratados de acordo com o Locale~~ do usuário, afinal, relatório é como uma "interface que exibe dados para o usuário", e precisa ser legível à maneira que ele é acostumado a ver a informação: decimais com "," ou ".", datas com "dd/mm/aaaa" ou "mmm dd,aaa", etc..		A '''obtenção/preparação dos dados''' significa obter os dados que serão escritos no relatório. Para alguns relatórios esses dados podem ser obtidos pela própria classe do Report, quando já virem dentro do ReportBean da classe.

	Ao iniciar o Bean procure sempre passar o Locale do usuário, provavelmente enviando-o junto durante a requisição da interface. Caso o relatório esteja sendo executado de outro "ator", como uma integração de outro sistema, ou uma tarefa agendada é preciso tomar o cuidado de definir o locale que será usado. O locale pode vir de diversos lugares, é preciso analisar cado a caso.

	~~Por fim~~, ~~se nenhum Locale for especificado o BISReportBean usará como valor padrão o Locale retornado como padrão na JVM~~.}}		{{nota\|Código de Obtenção dos Dados\|As classes "Report" fazem parte do CRUD, isto quer dizer que as classes Report podem chamar diretamente os métodos do CRUD do mesmo módulo/plugin.

			Também é recomendável que esses dados sejam obtidos diretamente no construtor do relatório. Fazendo com que o construtor lance as exceções necessárias diretamente.}}

	É sugerido que os relatório sigam o mesmo padrão. Que recebam em seu construtor a mesma classe BISReportBean ou outro Bean específico para o relatório. Neste caso, também é sugerido que o Bean específico para o relatório estenda o BISReportBean. Desta forma um único objeto carregará todas as informações necessárias, tanto para o BISReport quando para a classe de Relatório.

	~~Entre os atributos específicos~~ de ~~cada relatório podem estar o "MO" que~~ o relatório ~~usará para obter os dados no CRUD~~, ~~ou mesmo~~ a ~~coleção~~ de ~~dados/objeto que ele deverá usar para montar~~ o ~~relatório. Sendo obviamente livre e de definição de cada relatório definir seus atributos e informações necessárias~~.		Já a '''escrita no documento''' deve ser feita toda dentro do método abstrato herdado de BISReport - writeReportContent(). Chamado da classe pai quando for a hora de gerar o relatório, este método é quem deverá conter toda a lógica de "desenho e escrita no papel". Para saber como "escrever no papel" veja o [[Guia Rápido do iText]].

	== Executando um Relatório ==		== Executando um Relatório ==

Rodrigogml: /* getCoord* */

2015-06-06T02:42:29Z

getCoord*

← Edição anterior		Edição das 02h42min de 6 de junho de 2015
Linha 65:		Linha 65:

	Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.		Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.

			=== Implementando um BISReport ===

			Implementar uma classe de relatório precisa apenas de poucos passos:
			# Crie uma classe que estenda BISReport;
			# Crie uma classe de Bean que estenda BISReportBean, preferencialmente com o mesmo nome (exceto pelos sufixos diferentes: Report e ReportBean);
			# Implemente o método writeReportContent(), que é abstrato em BISReport;

			Esses três passos são o suficiente para criar a estrutura para começar a implementar o relatório. A partir deste ponto começa a implementação específica de cada relatório em duas etapas: '''obtenção/preparação dos dados''' e '''escrita no documento'''.

			A '''obtenção/preparação dos dados''' significa obter os dados que serão escritos no relatório. Para alguns relatórios esses dados podem ser obtidos pela própria classe do Report, quando já virem dentro do ReportBean da classe.


			{{nota\|Código de Obtenção dos Dados\|As classes "Report" fazem parte do CRUD, isto quer dizer que as classes Report podem chamar diretamente os métodos do CRUD do mesmo módulo/plugin.

			Também é recomendável que esses dados sejam obtidos diretamente no construtor do relatório. Fazendo com que o construtor lance as exceções necessárias diretamente.}}


			Já a '''escrita no documento''' deve ser feita toda dentro do método abstrato herdado de BISReport - writeReportContent(). Chamado da classe pai quando for a hora de gerar o relatório, este método é quem deverá conter toda a lógica de "desenho e escrita no papel". Para saber como "escrever no papel" veja o guia

	== BISReportBean ==		== BISReportBean ==

Rodrigogml em 02h25min de 6 de junho de 2015

2015-06-06T02:25:03Z

@@ Linha 65: / Linha 65: @@
 Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.
 == BISReportBean ==
@@ Linha 93: / Linha 83: @@
 Entre os atributos específicos de cada relatório podem estar o "MO" que o relatório usará para obter os dados no CRUD, ou mesmo a coleção de dados/objeto que ele deverá usar para montar o relatório. Sendo obviamente livre e de definição de cada relatório definir seus atributos e informações necessárias.
 == Referências ==
 <references/>

Rodrigogml: /* BISReport */

2015-06-06T02:24:06Z

BISReport

@@ Linha 28: / Linha 28: @@
 Abaixo estão listados os modelos existentes atualmente:
@@ Linha 94: / Linha 65: @@
 Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.
 == Referências ==
 <references/>

Rodrigogml: /* Métodos Utilitários */

2015-06-06T02:23:00Z

Métodos Utilitários

← Edição anterior		Edição das 02h23min de 6 de junho de 2015
Linha 28:		Linha 28:

	Abaixo estão listados os modelos existentes atualmente:		Abaixo estão listados os modelos existentes atualmente:


			=== Executando um Relatório ===

			Uma vez que o relatório foi implementado, gera-lo pode ser descrito em três passos básicos:
			# instancie a classe do relatório (que estende e implementa os métodos abstratos da BISReport);
			# chame o método writeReport();
			# por fim, obtenha o arquivo do PDF através do método getOut();


			Obviamente que há passos anteriores aos 3 citados acima, como por exemplo captar e definir eventuais configurações do relatório.

			=== BISReportBean ===

			O BISReportBean é um objeto que "carrega" todas as configurações necessárias para a geração do relatório. Ao invés de um construtor complexo com inúmeros atributos, optamos por receber este único objeto com todas as configurações necessárias internamente.

			O BISReportBean tem alguns atributos usados no relatório, e todos os atributos já são instanciados com valores que definem o relatório, como por exemplo, que a folha é A4 no formato 'Retrato', e algumas margens padrões para impressão.


			{{stop\|Locale\|Embora o relatório seja classe do Core, muitos dados precisam ser tratados de acordo com o Locale do usuário, afinal, relatório é como uma "interface que exibe dados para o usuário", e precisa ser legível à maneira que ele é acostumado a ver a informação: decimais com "," ou ".", datas com "dd/mm/aaaa" ou "mmm dd,aaa", etc..

			Ao iniciar o Bean procure sempre passar o Locale do usuário, provavelmente enviando-o junto durante a requisição da interface. Caso o relatório esteja sendo executado de outro "ator", como uma integração de outro sistema, ou uma tarefa agendada é preciso tomar o cuidado de definir o locale que será usado. O locale pode vir de diversos lugares, é preciso analisar cado a caso.

			Por fim, se nenhum Locale for especificado o BISReportBean usará como valor padrão o Locale retornado como padrão na JVM.}}


			É sugerido que os relatório sigam o mesmo padrão. Que recebam em seu construtor a mesma classe BISReportBean ou outro Bean específico para o relatório. Neste caso, também é sugerido que o Bean específico para o relatório estenda o BISReportBean. Desta forma um único objeto carregará todas as informações necessárias, tanto para o BISReport quando para a classe de Relatório.

			Entre os atributos específicos de cada relatório podem estar o "MO" que o relatório usará para obter os dados no CRUD, ou mesmo a coleção de dados/objeto que ele deverá usar para montar o relatório. Sendo obviamente livre e de definição de cada relatório definir seus atributos e informações necessárias.

Rodrigogml: Criou página com 'O BISReports é o sistema do BIS para a geração de relatórios do sistema. A função deste serviço é oferecer funções e suporte para que a aplicação possa desenvolver...'

2015-06-06T01:25:31Z

Criou página com 'O BISReports é o sistema do BIS para a geração de relatórios do sistema. A função deste serviço é oferecer funções e suporte para que a aplicação possa desenvolver...'

Página nova

O BISReports é o sistema do BIS para a geração de relatórios do sistema. A função deste serviço é oferecer funções e suporte para que a aplicação possa desenvolver relatórios em PDF de forma rápida e centralizada. Outra função bem clara do BISReports é centralizar a aparência dos relatórios em todo o sistema, oferecendo ''templates'' de cabeçalhos, rodapés, e blocos de conteúdos para serem usados pelas relatórios dos plugins/módulos.

{{nota|iText|O BISReports funciona em cima da biblioteca [[http://itextpdf.com/ iText]]. Verifique o [[Guia Rápido do iText]] para uma visão rápida do seu funcionamento e exemplos sucintos de como escrever no diretamente no documento.}}

== BISReport ==

BISReport é a classe principal do serviço. Esta classe é abstrata e deve ser estendida diretamente pela classe do relatório, ou por alguma classe "intermediária" usada para criar um template específico de relatório.

Os serviços oferecidos por esta classe são:

=== Conjunto de Fontes ===

Entre as características que devem ser uniformes em todos os relatórios do sistema estão as "Fontes" usadas para escrever as informações. Por isso a classe pai oferece um conjunto de fontes para ser utilizado nos relatórios. Os conjuntos definem o tipo de letra (fonte), e sua aparência (bold, italic, etc.). Essas fontes são obtidas pelos métodos:
* '''getBaseFontPlain()''' - Retorna a fonte padrão para relatório do sistema.
* '''getBaseFontItalic()''' - Retorna a fonte padrão com o formato itálico ativado.
* '''getBaseFontBold()''' - Retorna a fonte padrão com formato negrito ativado.
* '''getBaseFontBoldItalic()''' - Retorna a fonte padrão com o formato negrito e itálico ativado.

{{nota|Fontes Alternativas|Embora nada impeça a criação de novas fontes nos relatórios, ou mesmo fontes específicas para relatórios específicos, deve-se analisar com cuidado a troca da fonte padrão do relatório por alguma personalizada, justamente para não remover o padrão ou dificultar a leitura do relatório.}}

=== Cabeçalhos e Rodapés ===

Outra característica do BISReport é a centralização dos cabeçalhos e rodapés disponíveis para serem utilizados nos relatórios. Há alguns modelos distintos de acordo com as informações que precisam ser exibidas, como títulos e subtítulos, datas de períodos, etc.

Abaixo estão listados os modelos existentes atualmente:

=== Métodos Utilitários ===

A classe oferece alguns métodos que facilitam a escrita dos relatórios. São funções e blocos de códigos que costumam se repetir em vários momentos/relatórios.

==== createClippedTextField ====

Este método cria um template<ref name=template>Template no iText é um "pedaço" do documento que é escrito separado e depois posicionado onde desejado. Similar à ideia de escrever em um Post-It e depois cola-lo no seu documento, com a vantagem que não ficará visível onde esse template começa ou termina, ele não gera bordas ou fundos. Pelo menos não automáticamente.</ref> para escrita de um texto e aplica um clip no tamanho desejado.

É usado (ou deve ser usado) durante a escrita de campos de texto que podem ter tamanho variável, e algumas vezes até maior do que o espaço destinado à ele. Utilizando esta técnica o campo será "cortado" no seu limite, evitando que a informação atropele outro conteúdo, ou mesmo desobedeça as margens do papel.

Mais detalhes sobre o funcionamento no javadoc do método.

==== getWritableWidth & getWritableHeight ====

Ambos os métodos servem para retornar o espaço livre da folha, retornando respectivamente a largura (eixo X) e a altura (eixo Y). Este método leva em consideração apenas 2 coisas: O tamanho da folha em uso e as margens definidas. Este método não considera cabeçalhos, rodapés ou qualquer outro conteúdo já "impresso" no relatório.

==== getCoord* ====

Os métodos getCoord são responsáveis por calcular as coordenadas a partir dos limites "writable" do documento, sendo a origem (0,0) no canto superior esquerdo. Por exemplo, ao solicitar a posição 100 a partir da esquerda, o sistema calculará 100 + a borda da esquerda para achar o valor de x correto para ser usado no PDF. Dessa maneira facilita o posicionamento dos campos no espaço "writable".

Os métodos disponíveis são:
* '''getCoordFromTop(c)''' - Obtém a coordenada Y que representa a distância "c" em relação à borda superior do espaço "writable" do documento.
* '''getCoordFromBottom(c)''' - Obtém a coordenada Y que representa a distância "c" em relação à borda inferior do espaço "writable" do documento.
* '''getCoordFromRight(c)''' - Obtém a coordenada X que representa a distância "c" em relação à borda direita do espaço "writable" do documento.
* '''getCoordFromLeft(c)''' - Obtém a coordenada X que representa a distância "c" em relação à borda esquerda do espaço "writable" do documento.
* '''getCoordFromMiddleX(c)''' - Obtém a coordenada X que representa a distância "c" em relação ao centro da largura "writable" do documento.

{{nota|Distância Negativas|Embora não faça muito sentido para a maioria dos métodos citados, os valores "c" podem ser passados negativos. O que fará com que o valor retornado seja no "sentido contrário". Isto é, valores positivos em geral retornam uma posição '''dentro''' do espaço "writable" da folha.

O valor negativo faz mais sentido se pensar no método getCoordFromMiddleX(). Se o valor for positivo ele retornará a coordenada que fica à distância "c" do centro da página para a direita. Caso o valor seja negativo, a coordenada ficará a mesma distância "c", só que a esquerda do centro da página.}}

Além disso, os métodos automaticamente invertem as origens do documento conforme solicitado.

== Referências ==
<references/>