Ir para o conteúdo

Relatórios Crystal e Jitterbit App Builder

Visão Geral

O App Builder suporta a adição de relatórios criados pelo SAP Crystal Reports às páginas em aplicações. Para aproveitar esses Relatórios Crystal, este artigo descreve o que você precisará, dependendo se deseja apenas visualizar os relatórios ou se está buscando criá-los e modificá-los.

Nota

Os Relatórios Crystal são suportados apenas em ambientes Windows.

Pré-requisitos

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

Habilitar Relatórios Crystal

O App Builder vem com o Crystal Reports pré-instalado em sistemas Windows. 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 diretório de instalação do App Builder.
  3. Execute o script RegisterCrystalReports.ps1.

Exemplo

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

Nota

Para executar scripts do PowerShell não assinados, os administradores precisam alterar a política de execução padrão do PowerShell.

> Set-ExecutionPolicy RemoteSigned

Configurar Relatórios Crystal para edição e criação de relatórios

Se você deseja editar e/ou criar um Relatório Crystal a ser usado pelo App Builder, precisará de uma versão licenciada do SAP Crystal Reports ou acesso a uma versão de teste gratuita. O Crystal Reports é uma aplicação de inteligência de negócios e é usado para criar relatórios dinâmicos, formatados e poderosos, 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 no site SAP Crystal Reports.

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 visualização de relatórios

Para aproveitar a visualização das páginas do Crystal Report no App Builder, é necessário garantir que o mecanismo de tempo de execução do Crystal Report esteja instalado no seu servidor de aplicativos. Atualmente, o App Builder requer que você tenha o Crystal Reports Version 13.0.21 runtime 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:

Captura de tela 2018 05 09

  1. Após a conclusão do instalador, clique em Finalizar.
  2. Em seguida, navegue até IIS e expanda seu servidor. Depois que o servidor for expandido, navegue até os pools de aplicativos.
  3. Selecione o pool de aplicativos que está executando o App Builder e, no Painel de Ações do lado direito da tela, pressione Parar.
  4. Depois que o pool de aplicativos estiver completamente parado, pressione Iniciar e aguarde o pool de aplicativos reiniciar completamente.
  5. Assim que o App Builder estiver acessível novamente, tente navegar até uma das 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:

Captura de tela 2018 05 09

Importante

Se você estiver usando um ambiente AWS, esses passos não são necessários, desde que seu servidor esteja usando o perfil AMI atual.

Solucionando 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 um aplicativo do App Builder. Como solução alternativa, tente reiniciar o IIS para ver se isso resolve o problema. Em algumas instâncias, 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 na Verificação do Banco de Dados na instalação do Crystal Reports para precisão.
  • Se você ver um espaço em branco no seu Crystal Report em vez de uma imagem que 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 compressão de imagens.