Relatórios de Cristal e App Builder¶

Visão Geral¶

App Builder suporta a capacidade de adicionar relatórios criados pelo SAP Crystal Reports a páginas em aplicativos. Para aproveitar esses Crystal Reports, este artigo descreve o que você precisará, dependendo se você está procurando simplesmente visualizar os relatórios ou se está procurando criá-los e modificá-los.

Pré-requisitos¶

• App Builder requer o tempo de execução do Crystal Reports instalado no servidor de aplicativos
• Crystal Reports SP21 é o mínimo para App Builder, e SP21-SP32 são suportados

Habilitar Crystal Reports¶

Em sistemas Windows, App Builder suporta Crystal Reports. O Crystal Reports é hospedado fora do processo em um servidor COM. Siga estas etapas para registrar o servidor COM do Crystal Reports.

1. Inicie o * Windows PowerShell* como administrador.
2. Mude para o diretório * Scripts* abaixo do App Builder diretório de instalação.
3. Execute o RegisterCrystalReports.ps1 script.

> cd C:\inetpub\wwwroot\App Builder\Scripts
> .\RegisterCrystalReports.ps1

Configurar o Crystal Reports para Edição e Criação de Relatórios¶

Se você está procurando editar e/ou criar um Crystal Report para ser usado por App Builder, você precisará de uma versão licenciada do SAP Crystal Reports ou acesso a uma versão de teste gratuita. O Crystal Reports é um aplicativo de business intelligence e é usado para criar relatórios dinâmicos, poderosos, formatados e com precisão de pixel a partir de quase qualquer fonte de dados.

Informações sobre requisitos, instalação, solução de problemas e uso do Crystal Reports estão disponíveis em SAP Crystal Reports site.

Para saber mais sobre o Crystal Reports ou obter uma versão licenciada, consulte https://www.sap.com/products/technology-platform/crystal-reports.html

Configurar o Driver de Tempo de Execução do Crystal Reports para Visualizar Relatórios¶

Para aproveitar a visualização das páginas do Crystal Report em App Builder você precisará certificar-se de que o mecanismo de tempo de execução do Crystal Report esteja instalado no seu servidor de aplicativo. Atualmente App Builder requer que você tenha o Crystal Reports versão 13.0.21 tempo de execução instalado.

Link para download do driver:

Download do driver de 64 bits

Depois de baixá-lo, execute o instalador clicando no executável CRRuntime_xx_13_0_21.msi.

Siga as instruções dentro do instalador até chegar à página de instalação concluída:

1. Assim que o instalador for concluído, clique em Concluir.
2. Em seguida, navegue até IIS e expanda seu servidor. Assim que o servidor for expandido, navegue até os pools de aplicativos
3. Selecione o pool de aplicativos que está em execução App Builder e na gaveta de ações no lado direito da tela, pressione Parar.
4. Assim que o pool de aplicativos parar completamente, pressione Iniciar e aguarde até que o pool de aplicativos reinicie completamente.
5. Assim que App Builder estiver acessível novamente, tente navegar para uma de suas páginas configuradas como uma página do Crystal Report e, se o modelo e o tempo de execução estiverem configurados corretamente, você deverá ver um Crystal Report incorporado:

Problemas de Solução de Problemas¶

• Um usuário pode receber uma mensagem de erro "Uma exceção não tratada foi capturada no final do pipeline" ao tentar executar um Crystal Report em an App Builder app. Como solução alternativa, tente reiniciar o IIS para ver se isso corrige o problema. Em alguns casos, pode ser necessário instalar o driver de tempo de execução do Crystal Reports mais recente, antes de reiniciar o IIS.
• Se você vir o erro "CrystalDecisions.CrystalReports.Engine.LogOnException: Falha no logon do banco de dados. ---> System.Runtime.InteropServices.COMException: Falha no logon do banco de dados", revise o caminho do arquivo em Verificar banco de dados na instalação do Crystal Reports para verificar a precisão.
• Se você vir um espaço em branco no seu Crystal Report em comparação a uma imagem que você espera ver, verifique se você comprimiu a imagem o máximo possível (enquanto garante que a qualidade seja mantida). Veja tinypng.com para obter ajuda na compactação de imagens.