Boletim Técnico

Geração de Relatório Crystal Reports no servidor

Produto : Microsiga Protheus - Integração Crystal - versão 11

Chamado : THWBNY Data da publicação : 02/10/13

País(es) : Todos Banco(s) de Dados : Todos

A execução de relatórios Crystal Reports passa a ser possível por meio da função CallCrys diretamente no servidor,
dispensando a necessidade de conexão ODBC com o Banco de Dados do Protheus ou qualquer outra configuração
específica nas estações que fazem uso de relatórios disponibilizados pela integração, uma vez que somente o
arquivo resultante da execução do relatório será exibido ao usuário, o que permite a utilização da integração em
ambiente de Cloud Computing.

Procedimento para Implementação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) desta FNC.

Procedimentos para Configuração

ig
1. Instale o Protheus Crystal Integration.msi no servidor. Este arquivo está no pacote de atualizações disponível
para download na categoria Crystal Reports da sessão de Downloads do Portal do Cliente.

2. Copie os arquivos apconn.dll e apapi.dll do diretório do SmartClient para o diretório AppServer.

3. Copie o arquivo SGCRYS32.exe para o diretório AppServer. Este arquivo está no pacote de atualizações
disponível para download na categoria Crystal Reports da sessão de Downloads do Portal do Cliente.

4. Crie o arquivo CRYSINI.INI no diretório do AppServer, com o seguinte conteúdo:

 [PATH]

 SXS=<Caminho do diretório StartPath do Protheus>

 DATA=<Diretório RootPath do Protheus>

 LOG=<0 para não gerar log ou 1 para gerar >

 PATHLOG=<Caminho do subdiretório Log do diretório Crystal abaixo do

RootPath do Protheus>

Integração Crystal - Geração de Relatórios Crystal Reports

1
no servidor
 Boletim Técnico

5. Crie o arquivo CRWINI.INI no diretório do AppServer, com o seguinte conteúdo:

 [SXS]

 SX1=<0 para não consultar o SX1 ou 1 para consultar>

 SX2=<0 para não consultar o SX2 ou 1 para consultar >

6. Configure a chave CRWINSTALLPATH no ambiente que será utilizado para geração dos relatórios. O conteúdo
da chave deve ser o caminho completo para o diretório AppServer, como por exemplo:
CRWINSTALLPATH=C:\MP11\BIN\APPSERVER.

7. No Servidor crie uma conexão ODBC para o Banco de Dados utilizado pelo Protheus com o mesmo nome,
usuário e senha utilizados pela conexão ODBC configurada para o TOTVS | DbAccess.

8. Quando é realizada a geração do relatório no servidor, o relatório final é exibido ao usuário em formato de
arquivo podendo ter as seguintes extensões: .PDF, .DOC, .XLS ou .DOC. Para que o relatório possa ser
visualizado pelo usuário final é necessário que possua um aplicativo que permita abrir o formato de arquivo
escolhido.

Procedimentos para Utilização

9. Crie uma rotina AdvPL que utilize a função CallCrys para gerar um relatório Crystal Reports, informando o
valor .T. para o sexto parâmetro da função.

A assinatura da função CallCrys é a seguinte:

CallCrys (<cRpt>,<cParams>,<cOptions>, [lWaitRun], [lShowGauge], [lRunOnServer], [lExportFromServer])

Sendo:

 <cRpt> = Nome do relatório.

 <cParams> = Parâmetros do relatório, separados por vírgula (,) ou ponto e vírgula (;). Caso este
parâmetro seja marcado, serão desconsiderados os parâmetros marcados no SX1.

 <cOptions> = Opções para não se mostrar a tela de configuração de impressão no formato

<x>;<y>;<z>;<w>. Sendo:

 x = Impressão em Vídeo(1), Impressora(2), Impressora(3), Excel(4), Excel Tabular(5), PDF(6),

Texto(7) e Word(8) .

 y = Atualiza Dados(0) ou não(1)

 z = Número de cópias. Para exportação este valor sempre deverá ser 1.

 w = Título do Report. Para exportação este será o nome do arquivo sem extensão.

Integração Crystal - Geração de Relatórios Crystal Reports

2
no servidor
 Boletim Técnico

 [lWaitRun] = Indica se deve interromper a execução da função CallCrys até o fechamento do

relatório.

 [lShowGauge] = Indica se a barra de progressão da geração do relatório deve ser exibida.

 [lRunOnServer] = Indica se a execução do relatório deve ser feita no servidor.

 [lExportFromServer] = Indica que será feita exportação do arquivo do relatório no servidor, neste
modo o relatório não é exibido para o usuário final.

10. As rotinas que fazem uso da função CallCrys devem ser executas somente em ambientes que tenham
interface com o usuário.

Informações Técnicas

Rotinas Envolvidas CRYSTAL.PRW – Integração Crystal

Sistemas Operacionais Windows

Integração Crystal - Geração de Relatórios Crystal Reports

3
no servidor