Como configurar um Crystal Report no Jitterbit App Builder

Quase qualquer página do App Builder pode ser convertida em um Crystal Report. Sempre que desejar gerar um documento PDF contendo dados de uma página em um aplicativo do App Builder, você pode usar o Crystal Reports.

Etapas para vincular a página do App Builder ao Crystal Reports

1. Crie a página do aplicativo App Builder com todos os Business Objects que deseja usar no relatório, siga as mesmas etapas que você seguiria para criar uma página dinâmica padrão do App Builder
2. Na página do aplicativo, vá para Gaveta de ações > Projetar esta página
3. Clique na aba Edge Case no aba Página
4. Selecione Relatório como o Tipo de Página
5. Selecione Crystal Report como o Tipo
6. Clique em Salvar
7. Clique no arquivo localizado ao lado de Esquema XML para baixá-lo
8. Abra o Crystal Reports, crie um novo documento em branco

9. Se você não for solicitado a criar uma conexão de fonte de dados, vá para a aba Banco de Dados e clique em Especialista em Banco de Dados

   

10. No Database Expert, clique em Criar nova conexão > ADO.NET (XML)

11. Carregue o arquivo XML baixado da sua página do App Builder no campo do caminho do arquivo e clique em Concluir
12. Clique no botão >> na janela Database Expert para trazer suas tabelas para a janela Tabelas Selecionadas

13. Clique em OK

    

14. Se você tiver vários painéis na sua página do App Builder que exigem vinculação, a aba Links aparecerá no Database Expert e você deverá vincular as tabelas da mesma forma que vincula seus painéis na sua página do App Builder.

    

15. Seus campos agora devem aparecer na área Campos do Banco de Dados do Field Explorer no seu Crystal Report

16. Agora você está pronto para adicionar campos ao Crystal Report

17. Há diferentes seções em um Crystal Report, e todas elas têm usos diferentes:

    • Cabeçalho do relatório - O conteúdo aparece logo no início do relatório (ex.: logotipo da empresa)
    • Cabeçalho da página - O conteúdo aparece no início de cada página
    • Detalhes - O conteúdo do seu relatório
    • Rodapé do relatório - O conteúdo aparece no final do relatório
    • Rodapé da página - O conteúdo aparece no final de cada página (ex.: número da página)

18. Assim que o relatório estiver pronto para ser testado, salve-o. Recomenda-se salvar uma nova versão do relatório sempre que uma alteração for feita, para que você possa voltar atrás caso não goste das alterações feitas.

19. Após salvar o relatório, volte para a página do App Builder. Nas configurações da página Edge Case, carregue o arquivo no campo XML Upload da seção Report Options.
20. Clique em Salvar

21. Execute a página. A saída esperada é o Crystal Report retornado.

    

Notas e dicas importantes

• Se você fizer alguma alteração no design da página do App Builder, salve um novo Esquema XML e atualize a fonte de dados conectada ao Crystal Report na seção Definir Local da Fonte de Dados, na aba de Dados. Carregue o XML da mesma forma que fez ao criar o relatório e remapeie todas as tabelas clicando na nova versão da tabela (embaixo) e na tabela antiga (em cima) e, em seguida, clicando no botão Atualizar. Em seguida, salve quando todas as tabelas forem remapeadas.
• Se um Controle na página do App Builder for um Controle HTML, o Crystal Reports não o lerá como HTML por padrão. Para corrigir isso, clique com o botão direito do mouse no campo no Crystal Reports, clique em Formatar Campo e, na aba Parágrafo, altere a interpretação do texto para HTML.
• O Crystal Reports não suporta a maioria dos formatos de imagem. Se você estiver adicionando uma imagem a um Crystal Report, a maneira mais fácil é converter todas as imagens para o formato .BMP antes de inseri-las em um relatório. Qualquer outro formato de imagem, independentemente do tamanho, aumentará significativamente o tamanho do arquivo do Crystal Report e, por sua vez, tornará o pacote de lançamento do seu aplicativo maior do que o necessário.
• Se você estiver usando dois painéis em uma página e qualquer um deles estiver vinculado ao outro, eles não precisarão da opção Vinculação para bancos de dados no Crystal Reports, pois eles já estão vinculados no App Builder.
• Os dados do Crystal Reports estão usando o valor real exibido nos Controles no App Builder, portanto, se o seu Controle for um Objeto de Lista, você receberá os dados da lista e não o UUID usado para indexar a lista.
• Você pode receber um erro no Crystal Reports informando que há vários pontos de partida se os objetos de dados de cada Painel não estiverem vinculados no Crystal Reports, e isso geralmente não é suportado. Isso não é um problema no App Builder e é totalmente suportado no App Builder.