Integração com Crystal Reports

Esta AAtrTempo aproximado para leitura: 00 min

ÍNDICE

1. Instalação e configuração via servidor

2. Checklist para geração dos relatórios

3. Lentidão na geração dos relatórios (Performance)

01. INSTALAÇÃO E CONFIGURAÇÃO VIA SERVIDOR

Para possibilitar a instalação do Protheus Crystal Integration, primeiramente é necessário realizar o download do instalador no Portal da TOTVS (Área de Download, pacote do Crystal Integration - "protheus_crystal_integration.msi" - com data igual ou superior à Out/2013).

A instalação deve ser feita no servidor onde será executada a aplicação do Protheus.

O parâmetro MV_JCRYSER deve ser configurado com conteúdo .T..

O parâmetro MV_CRYSTAL deve ser configurado com o nome de uma  pasta dentro do RootPath, por default  o conteúdo é "\CRYSTAL\". Importante verificar se a pasta existe, caso não houver criar.

Os arquivos de relatório devem estar no diretório mencionado acima.

Em seguida, copie os arquivos citados abaixo, normalmente existentes no diretório \SMARTCLIENT\ para o \APPSERVER\:

• APAPI.DLL
• APCONN.DLL
• CRYSINI.INI - Este arquivo é criado através de um Wizard, caso não exista. Também é possível criá-lo manualmente, conforme modelo abaixo, respeitando os diretórios da sua instalação. Procure utilizar o caminho através do DRIVE (C:\...) e não de REDE (\\SERVIDOR\...):

[PATH]
SXS=C:\TOTVS\P11\Protheus_Data\system
DATA=C:\TOTVS\P11\Protheus_Data
EXPORT=C:\TOTVS\P11\Protheus_Data\spool

PATHLOG=C:\TOTVS\P12Local\Protheus_data\crystal
LOG=1
AUTO=0

• CRWINI.INI - É possível criar este arquivo manualmente, conforme modelo abaixo, respeitando os diretórios da sua instalação.

[SXS]
SX1=1
SX2=0

• SGCRYS32.EXE

Após as configurações acima, incluir em cada ambiente (environment) do APPSERVER.INI a linha abaixo:
CRWINSTALLPATH=<caminho do appserver, exemplo C:\TOTVS\P11\Protheus\AppServer\>

No servidor de aplicação, deverá ser criada uma conexão ODBC para o banco de dados. O Crystal Reports utiliza uma conexão criada no ODBC32.
Caso o Windows seja 32 bits, o ODBC32 estará na pasta ...\SYSTEM32\, se for 64 bits, pasta ...\SYSWOW64\;

Após criar a conexão ODBC, na aba "Workarounds" desabilite a opção "Disable RULE hint";

Verifique se os arquivos de relatórios (.rpt) estão apontados para a conexão existente no ODBC. A conexão pode ser a mesma da aplicação, desde que essa esteja criada no ODBC32.

Após todas as configurações acima efetivadas, abrir o SmartClient e executar a função "CRYSCONFIG". Na próxima tela informa o usuário senha do Protheus e após o usuário se senha do banco de dados.

OBSERVAÇÕES:

1. Nas estações de trabalho, nenhuma configuração é necessária quando utilizada a impressão via servidor. Isto é, a criação de ODBC, instalação do Crystal Integration e compartilhamento para a pasta CRYSTAL são dispensáveis.
2. O relatório será gerado no servidor, convertido para PDF e transferido para a estação, portanto é importante existir o Adobe Acrobat Reader instalado no servidor.
3. Observe que se a chamada da rotina (padrão ou customizada) não estiver preparada para ser executada via servidor, as configurações acima não surtirão efeito e, como consequência, os arquivos serão buscados no \SMARTCLIENT\.
4. Caso seja ativado o log no arquivo CRYSINI.INI (LOG=1), o arquivo CRLOG será criado no C:\ (caso não seja definido um path diferente) e pode ser bem útil durante o processo de configuração.
5. Caso existam outros APPSERVER (Balance), verifique se não é necessária a cópia dos arquivos para os demais.
6. Caso seja percebido que os arquivos utilizados são do SMARTCLIENT, provavelmente o parâmetro MV_JCRYSER não foi criado, ou está como .F. (falso).

02. CHECKLIST PARA GERAÇÃO DO RELATÓRIO

Caso o relatório em Crystal não esteja sendo gerado, abaixo temos alguns pontos que devem ser verificados:

• Para o relatório de pré-fatura (JU201), no cadastro Tipo de Relatório de Pré-fatura (JURA196) verificar se o campo Nome Arq. está preenchido. Caso esteja preenchido, verificar se existe o arquivo com esse mesmo nome no diretório Crystal do servidor. Exemplo: JU201.RPT
• Para o relatório de pré-fatura (JU201), caso o campo Nome Arq esteja vazio, a rotina irá considerar o nome JU201 para chamada do processamento do relatório. Todavia, é necessário que não exista o arquivo ".RPT" (sem nome) no diretório Crystal.
• Gerar o relatório direto pelo Crystal Reports com base nos parâmetros passados no arquivo CRLOG (Parâmetro 17) para garantir que o relatório está correto.
• Analisar o arquivo de log (CRLOG.LOG) para checar qual mensagem de erro está sendo gerada, sendo que para o caminho deste arquivo fica na chave PATHLOG do arquivo CRYSINI.INI.
• Verificar se a quantidade de parâmetros que está sendo passada via Protheus é a mesma que está sendo recebida no relatório.
• A pasta criada com os arquivos  do "smartclient.exe" não pode ter espaçamento no endereço completo do caminho, por exemplo: "C:\SmartCliente TOTVS". Obrigatoriamente o caminho deve ser sem espaços, exemplo: "C:\SmartClient_TOTVS" (Utilizado o underline no lugar do espaço).

03. LENTIDÃO NA GERAÇÃO DOS RELATÓRIOS (PERFORMANCE)

Para aumento no ganho de performance na geração dos relatórios foram identificados os pontos abaixo:

• Ajustes nos relatórios utilizando a ferramenta Crystal Reports:

1. Acessar o menu Arquivo e em seguida a opção Opções de Relatório:

2. Desabilitar as opções:

-Verificar na primeira atualização

-Exibir alertas na atualização

Observação: Essas configurações devem ser feitas para cada arquivo do relatório Crystal.

3. Ao abrir o relatório via Crystal Reports, caso seja exibido a mensagem "Este relatório utiliza uma impressora inválida. A impressora padrão será utilizada no lugar."

-Mensagem de alerta ao abrir o relatório:

-Acessar o menu arquivo → Configuração da Página → Marcar a opção 'Sem Impressora (otimizar para exibição na tela)".

• Ajustes ODBC:

1. Selecionar a conexão ODBC da fonte de dados e clicar na opção configurar:

2. Em seguida, na aba Workarounds desabilitar a opção 'Disable RULE Hint':