Ir para o conteúdo

Como configurar um Relatório Crystal no Jitterbit App Builder

Introdução

A maioria das páginas do App Builder pode ser convertida em um SAP Crystal Reports e, a partir daí, em um documento PDF.

Para configurar os Relatórios Crystal, siga as seções desta página na ordem.

1. Baixar e importar para o Crystal Reports o arquivo .xsd da página do App Builder

  1. Crie uma página dinâmica padrão do aplicativo App Builder com os objetos de negócios necessários para o relatório.

  2. Na página do aplicativo, selecione Painel de Ação > Design: {page}.

  3. No painel Propriedades da Página, selecione Mais > Caso Excepcional.

  4. Na janela pop-up Definição da Página, expanda a seção Opções Avançadas.

  5. Para a opção Tipo de Página, selecione Relatório.

  6. Na seção Opções do Relatório, defina a opção Tipo como Relatório Crystal.

  7. Clique no ícone Esquema XML > Baixar. Você será solicitado a baixar um arquivo .xsd. Salve-o em algum lugar.

2. Criar uma conexão entre o Crystal Reports e a página do seu aplicativo

  1. Abra o Crystal Reports e, em seguida, crie um novo relatório em branco.

  2. O Crystal Reports deve abrir a janela pop-up Especialista em Banco de Dados. Nela, expanda a seção Criar Nova Conexão, em seguida, clique em ADO.NET (XML) > Fazer nova conexão. A caixa de diálogo ADO.NET (XML) é aberta.

  3. No campo Caminho do Arquivo, insira o caminho para o arquivo .xsd baixado ou clique no ícone para navegar e selecioná-lo.

  4. Clique no botão Concluir. A caixa de diálogo ADO.NET (XML) se fecha, revelando a janela pop-up Especialista em Banco de Dados.

  5. Na janela pop-up, selecione a conexão recém-adicionada à esquerda e, em seguida, clique no botão >> para trazer suas tabelas para o painel Tabelas Selecionadas à direita.

  6. Clique no botão OK. A janela pop-up Especialista em Banco de Dados se fecha.

  1. Se houver vários painéis de página que precisam de vinculação, a aba Links será aberta. Use-a para vincular tabelas da mesma forma que vincula painéis.

  2. Seus campos agora devem aparecer na área Campos do Banco de Dados do Explorador de Campos no Crystal Reports.

  3. Um Relatório Crystal possui diferentes seções para diferentes propósitos:

    • Cabeçalho do Relatório: O conteúdo aparece apenas no início do relatório (por exemplo, um logotipo da empresa).

    • Cabeçalho da Página: O conteúdo aparece no início de cada página.

    • Detalhes: O corpo principal 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 (por exemplo, o número da página).

    Arraste e solte os campos nas seções para criar o layout desejado.

  4. Quando o relatório estiver pronto para ser testado, salve-o e anote o nome do arquivo.

    Dica

    Salve uma nova versão do relatório toda vez que fizer uma alteração. Isso facilita reverter alterações indesejadas.

4. Executar o relatório

  1. Quando o relatório estiver salvo, retorne à sua página do App Builder.

  2. No painel Propriedades da Página, selecione Mais > Caso de Bordas.

  3. Na janela pop-up Definição da Página, expanda a seção Opções Avançadas.

  4. Clique no botão Upload de Modelo . A caixa de diálogo Upload de Modelo de Relatório será aberta.

  5. Clique no botão Procurar, encontre e selecione o arquivo .rpt do Crystal Reports salvo, e depois clique no botão Salvar. A janela pop-up Upload de Modelo de Relatório se fecha, revelando a janela pop-up Definição da Página.

  6. Feche a janela pop-up Definição da Página, e depois clique no botão Visualizar Página. A saída esperada (o Relatório Crystal) é retornada.

Dicas e solução de problemas

  • Se você fizer alterações no design da página do App Builder, deve salvar um novo Esquema XML e atualizar a fonte de dados que está conectada ao Relatório Crystal na seção Definir Localização da Fonte de Dados na aba Banco de Dados. Faça o upload do arquivo .xsd novamente, remapeie todas as tabelas clicando na nova versão da tabela (inferior) e clicando na tabela antiga (superior), e depois clique no botão Atualizar. Salve assim que todas as tabelas forem remapeadas.

  • Se um controle de 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 no campo no Crystal Reports, clique em Formatar Campo, e então, na aba Parágrafo, mude a interpretação do texto para HTML.

  • O Crystal Reports não suporta muitos formatos de imagem. Se você estiver adicionando uma imagem a um Crystal Report, é mais fácil 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, aumenta significativamente o tamanho do seu arquivo Crystal Report. Isso, por sua vez, torna o pacote de liberação da sua aplicação maior do que o necessário.

  • Se você estiver usando dois painéis em uma página, e eles estiverem vinculados um ao outro, não precisam da opção Vinculação para bancos de dados no Crystal Reports, pois já estão vinculados dentro do App Builder.

  • O Crystal Reports usa o valor exibido dos controles no App Builder. Se o seu controle for um objeto de lista, os dados são recebidos da lista, e não do UUID que foi usado para indexar a lista.

  • Você pode receber um erro no Crystal Reports dizendo que há múltiplos 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 pode ser ignorado.