Procedimentos de Implantao

iReport x Protheus
ndice
1. INTRODUO ............................................................................................................. 2
2. CONFIGURAO ....................................................................................................... 2
1.1 Configurando o Protheus ................................................................................................................. 2
2.2 Configurando o iReports no Protheus............................................................................................ 2
2.3 Incluindo relatrios no Protheus ..................................................................................................... 4

3. CONFIGURANDO E UTILIZANDO O IREPORT DESIGNER ..................................... 6

2.1 Configurando o acesso ao Banco de Dados ................................................................................. 6
2.2 Criando seu primeiro relatrio ........................................................................................................ 7
2.2.1 Tela de criao do relatrio .................................................................................................... 13
2.2.2 Tela mostrando o resultado do relatrio ................................................................................ 13

4. EXECUTANDO UM RELATRIO NO PROTHEUS .................................................. 14

procedimento para implantao ireport no protheus.docx

Pgina 1 de 15

Procedimentos de Implantao
iReport x Protheus
1. Introduo
O iReport Designer um gerador de relatorios grfico que permite integrao ao
ERP Protheus. A sua utilizao bem simples, no qual permite conectar-se a qualquer
banco de dados e mostrar em tempo real o resultado final do relatrio criado.
Antes de iniciar um relatrio no iReport Designer, faz-se necessrio algumas
configuraes bsicas no ERP Protheus.

2. Configurao
1.1 Configurando o Protheus
1) Baixar
o
ltimo
pacote
do
iReport
no
portal
da
Totvs
(https://suporte.totvs.com/download).
2) Descompacte o pacote e atualize a pasta iReport localizada em
\protheus_data\ireport\
3) Baixe o driver JDBC no site da Microsoft e atualize a pasta
\protheus_data\ireport\jdbc\ com o arquivo baixado.
4) Aplique o patch que veio no pacote no ambiente que ser utiliziado (lembre-se
de fazer um backup do repositorio antes).
2.2 Configurando o iReports no Protheus
1) Abra o Configurador e selecione o menu Ambiente e escolha o item Ireports
Config., em seguida clique em Wizard Ireports para iniciar a configurao.

procedimento para implantao ireport no protheus.docx

Pgina 2 de 15

Procedimentos de Implantao
iReport x Protheus
2) Ao abrir o Configurador iReports, clique no boto Avanar
3) Na tela que se abre, configure o campo URL do Webservice do Protheus,
caso no exista, consulte o Procedimento de Criao de WebService.
4) Informe a URL do banco de dados
5) Informe a Porta de conexao com o banco de dados
6) Escolha o tipo de driver JDBC
7) Informe o nome do banco de dados
8) Digite o usuario e senha para conexo ao banco de dados

Aps efetuar as configuraes necessrias, clique no boto Avanar.

procedimento para implantao ireport no protheus.docx

Pgina 3 de 15

Procedimentos de Implantao
iReport x Protheus
2.3 Incluindo relatrios no Protheus
Na prxima tela, onde voc poder importar os relatrios que voc criou
localmente, pois para funcionar um relatrio iReport necessrio que este esteja na pasta
\protheus_data\iReport\Reports\.

Para adicionar um arquivo, basta clicar no boto ... e depois clique em Adicionar
ao Servidor, o seu arquivo ir aparecer na lista logo abaixo. Concluindo esta operao,
clique no boto Avanar e uma tela como a que mostra abaixo ir aparecer

procedimento para implantao ireport no protheus.docx

Pgina 4 de 15

Procedimentos de Implantao
iReport x Protheus
2.4 Incluindo o relatrio no menu do Protheus
Ainda no configurador, para fazer com que um relatrio iReport funcione, preciso
que na hora de incluir o relatrio no menu do usurio, seja escolhido o tipo Relatrio
iReport.

procedimento para implantao ireport no protheus.docx

Pgina 5 de 15

Procedimentos de Implantao
iReport x Protheus
3. Configurando e utilizando o iReport Designer
Neste procedimento estarei utilizando a verso Jaspersoft iReport Designer 5.1.0.
1) Atualize a verso do Java (http://www.java.com).
2) Acesse o site do desenvolvedor em:
http://community.jaspersoft.com/project/ireport-designer
3) Baixe o programa e faa a instalao normalmente.
2.1 Configurando o acesso ao Banco de Dados
1)

Incie o iReport Designer, ser apresentado uma tela como a figura abaixo:

2)
Clique na imagem dos discos Step 1 para configurar o banco de dados que
ser utilizado, se for utilizar MSSQL selecione a opo Database JDBC connection
(lembrando que preciso que o driver ja esteja instalado). Clique em Next.

procedimento para implantao ireport no protheus.docx

Pgina 6 de 15

Procedimentos de Implantao
iReport x Protheus
3)
Na tela seguinte, informe os dados para conexo ao banco de dados. Para
conexo
direta
ao
banco,
escolha
o
driver
MS
SQLServer
(2005)(com.microsoft.sqlserver.jdbc.SQLServerDriver).

4)

Informe o endereo, porta e o nome do banco de dados

5)

Informe usuario e senha para conexo ao banco, marque salvar senha.

6)

Para saber se esta ok, clique no boto Test , em seguida clique no boto

Salvar
2.2 Criando seu primeiro relatrio
O proximo passo iniciar um novo relatrio, para isso, v ao menu File e selecione
New.

procedimento para implantao ireport no protheus.docx

Pgina 7 de 15

Procedimentos de Implantao
iReport x Protheus

Selecione o modelo conforme sua necessidade.

procedimento para implantao ireport no protheus.docx

Pgina 8 de 15

Procedimentos de Implantao
iReport x Protheus
Informe os dados iniciais do relatrio, clique em Next, Finish

Nome do relatrio,
tamanho mximo de 10
caracteres (padro
Protheus)

Caminho no protheus
onde ser gravado o
relatorio.

Nome do arquivo
gerado.

O editor praticamente dividido em 3 partes,

a) Report Inspector
b) Designer
c) Paletas e Propriedades

procedimento para implantao ireport no protheus.docx

Pgina 9 de 15

Procedimentos de Implantao
iReport x Protheus

Figura 1: Report Inspector

Figura 2: Designer

procedimento para implantao ireport no protheus.docx

Pgina 10 de 15

Procedimentos de Implantao
iReport x Protheus

Figura 3: Paletas e Propriedades

Por ser um programa bem intuitivo, irei mostrar apenas como visualizar os dados do
banco de dados.
Para comerarmos, na tela de Designer localize o icone

(Report Query) que

fica na barra de ferramentas.

procedimento para implantao ireport no protheus.docx

Pgina 11 de 15

Procedimentos de Implantao
iReport x Protheus
Como poder ver na figura a seguir, informe a query que deseja ser utilizada, pois
os campos que forem definidos nesta tela, sero os campos que aparecero no n Field
localizado no Report Inspector.

Coloque aqui a query,

perceba que possue dois
parametros na query.

Neste espao,
informe os
parametros que
sero utilizados.
Perceba que o
nome dos
parametros o
nome do relatorio
seguido de um
sequencial,
conforme imagem.

Lista dos campos que

sero levados para o
Report Inspector

Resultado da Consulta

Ao clicar em Ok, v no Report Inspector e

veja que o n Field est com os campos que
voc informou na tela Report Query.

procedimento para implantao ireport no protheus.docx

Pgina 12 de 15

Procedimentos de Implantao
iReport x Protheus
2.2.1 Tela de criao do relatrio

2.2.2 Tela mostrando o resultado do relatrio

procedimento para implantao ireport no protheus.docx

Pgina 13 de 15

Procedimentos de Implantao
iReport x Protheus
No configurador, para fazer com que um relatrio iReport funcione, preciso que na
hora de incluir o relatrio no menu do usurio, seja escolhido o tipo Relatrio iReport.

Informe o nome do relatorio criado no

iRepor Designer
Posto o relatrio no menu execute-o.

4. Executando um relatrio no Protheus

Ao selecionar o relatrio no Protheus, a tela abaixo ser exibida:

procedimento para implantao ireport no protheus.docx

Pgina 14 de 15

Procedimentos de Implantao
iReport x Protheus
Clicando no boto Video ser exibido uma barra de progresso e em seguida uma
prvia do relatorio.

procedimento para implantao ireport no protheus.docx

Pgina 15 de 15