Como Configurar um Crystal Report em App Builder¶

Quase qualquer página em App Builder pode ser convertido em um Crystal Report. Sempre que você quiser gerar um documento PDF que contenha dados em uma página em an App Builder aplicativo, você pode usar Crystal Reports.

Passos para Vincular App Builder página para Crystal Reports¶

Crie o App Builder página do aplicativo com todos os Objetos de Negócios que você deseja usar no relatório, siga as mesmas etapas que você seguiria para criar um padrão App Builder página dinâmica
Na página do aplicativo, vá para Gaveta de ações > Criar esta página
Clique na aba Edge Case no painel Página
Selecione Relatório como o Tipo de Página
Selecione Crystal Report como o Tipo
Clique em Salvar
Clique no arquivo localizado próximo ao Esquema XML para baixá-lo
Abra o Crystal Reports, crie um novo documento em branco
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
No Database Expert, clique em Criar nova conexão > ADO.NET (XML)
Carregue o arquivo XML baixado do seu App Builder vá para o campo do caminho do arquivo e clique em Concluir
Clique no botão >> na janela Database Expert para trazer suas tabelas para a janela Tabelas selecionadas
Clique em OK
Se você tiver vários painéis em seu App Builder página que requer vinculação, a aba Links aparecerá no Database Expert e você deve vincular as tabelas da mesma forma que você vincula seus painéis em seu App Builder página
Seus campos agora devem aparecer na área Campos do banco de dados do Field Explorer no seu Crystal Report
Agora você está pronto para adicionar campos ao Crystal Report
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 começo do relatório (ex.: logotipo da empresa)
- Cabeçalho da página - O conteúdo aparece no começo 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)
Quando o relatório estiver pronto para ser testado, salve-o. É recomendado salvar uma nova versão do relatório sempre que uma alteração for feita, para que você possa voltar se não gostar das alterações feitas
Depois que o relatório for salvo, volte para o seu App Builder página. Nas configurações da página Edge Case, carregue seu arquivo no campo XML Upload da seção Report Options
Clique em Save
Execute a página. A saída esperada é que o Crystal Report seja retornado.

Notas e Dicas Importantes¶

Se você fizer alguma alteração no App Builder design de página, você deve salvar um novo Esquema XML e atualizar a fonte de dados que está conectada ao Crystal Report na seção Definir Localização da Fonte de Dados na aba Banco de Dados. Carregue o XML da mesma forma que você fez quando criou seu relatório inicialmente e remapeie todas as tabelas clicando na nova versão da tabela (embaixo) e clicando na tabela antiga (em cima), depois clique no botão Atualizar. Então salve quando todas as tabelas forem remapeadas.
Se um Controle sobre o App Builder page é 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, em seguida, 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 coisa mais fácil a fazer é converter todas as imagens para o tipo de arquivo .BMP antes de colocá-las em um relatório. Qualquer outro formato de imagem, não importa o tamanho da imagem, aumentará significativamente o tamanho do seu arquivo 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. App Builder.
Os dados do Crystal Reports estão usando o valor real exibido nos controles em App Builder, então se 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 obter um erro no Crystal Reports dizendo que há vários pontos de partida se os objetos de dados de cada Painel não estiverem vinculados no Crystal Reports, e que isso geralmente não é suportado. Isso não é um problema no App Builder, e é totalmente suportado em App Builder.