Guia completo para integrao do Protheus com o

iReport
Para quem no conhece o iReport uma tima alternativa para criao de relatrios. O
Protheus possui uma integrao nativa com esta poderosa ferramenta. Porm,
pesquisando em alguns fruns e documentaes, percebi que h pouco material
explicando o funcionamento desta integrao, ento foi desenvolvido este tutorial
completo a respeito da integrao do Protheus com o iReport.
Preparativos iniciais.
Este tutorial foi feito levando em base as seguintes configuraes:
Protheus 10 (atualizado em abril/2012)
Java 6 update 31
iReport 4.5.1
Windows server 2003
Banco de dados MSSQL 2005
1. Inicialmente necessrio baixar os arquivos atualizados do iReport no site do
suporte da TOTVS, como na imagem:
2.
3. Descompacte e substitua a pasta iReport do diretrio base do Protheus pela pasta
com o mesmo nome baixado na atualizao.
4. Baixe o driver JDBC relativo ao seu banco de dados, no meu caso o da
Microsoft, que pode ser encontrado neste site: http://msdn.microsoft.com/en-
us/sqlserver/aa937724
5. Coloque o driver baixado na pasta JDBC do iReport
6. Compile a atualizao baixada na atualizao (ptm) utilizando a ferramenta
TotvsDevStudio
7. Abra o configurador (SIGACFG) e edite o menu do configurador, adicionando
uma nova opo, conforme imagem abaixo. Descrio: iReport Wizard, mdulo:
configurador, programa: CFGIREPORT, tipo: funo protheus.
8.
9. Baixe e instale o java 6 (http://www.java.com/pt_BR/download/), tanto no
servidor quanto na estao de trabalho
10. Baixe e instale o iReport
(http://jasperforge.org/website/ireportwebsite/IR%20Website/ir_download.html?
header=project&target=ireport)
11. necessrio habilitar o webservice do Protheus, caso o seu no esteja
habilitado, siga estas instrues:
1. Execute o Wizard de configurao do .INI no servidor do Protheus
2. Habilite o protocolo HTTP como na imagem abaixo. Verifique se a porta
utilizada no est ocupada por algum outro servio do sistema
operacional.
3.
4.
5. Agora com o protocolo habilitado, no menu "Mdulos web", inclua um
mdulo, seguindo as orientaes das imagens.
6.
7. Escolha o mdulo WS, um nome para instancia (no caso ws) e habilite a
inicializao do processo com o sistema.
8.
9. Aps clicar em avanar, o sistema ir perguntar se deve descompactar os
arquivos do portal na pasta. Escolha sim.
10. Relacione as empresas com o endereo de acesso.
11.
12. importante que a porta utilizada pelo mdulo seja a mesma
configurada para o protocolo http. Neste caso foi utilizada a porta 85
com o ip 192.168.0.18 (ip do servidor)
13. Escolha um diretrio virtual para o servio, neste caso foi utilizado o /ws
14. Preencha a quantidade mnima e mxima de usurios
15.
16. Finalize o processo e reinicie o servio do sistema.
17. Teste o webservice no ip, porta e diretrio escolhido atravs do
navegador web. Deve ser apresentada uma tela com o descritivo dos
servios web ativos, caso no aparea esta tela, tente configurar
novamente o webservice.
18.
12. Com o web service funcionando, pode-se partir para a criao de um relatrio
simples no iReport para testes iniciais. Se voc ainda no tem muita experincia
em desenvolvimento com o iReport, baixe no final deste artigo um exemplo de
relatrio.
13. Com o relatrio em mos, acesse o menu criado no configurador (iReport
Wizard), e siga os passos das imagens
14.
15.
16.
17. IMPORTANTE: no passo 16 necessrio colocar o relatrio *.jrxml em um
drive local, ex. c:\, caso contrrio o sistema apresenta um erro.
18. Adicione o relatrio criado em algum menu, lembrando de preencher o nome
fsico do relatrio (sem a extenso) no campo Programa e no tipo com Relatrio
iReport.
19.
20. Testar o menu criado, se tudo ocorreu bem, ir aparecer uma tela como esta:
21.
22. Clique em vdeo
23. Est pronto.