Geração de Relatórios no Servidor

Introdução:

A execução de relatórios Crystal Reports passa a ser possível, por meio da função CallCrys diretamente no servidor, dispensa 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.

Procedimentos para Configuração:

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>

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.

<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 em ambientes que tenham interface com o usuário.