Ir para o conteúdo

Gerador de relatórios de construção automática no Jitterbit App Builder

O gerador de relatórios Auto Build cria relatórios incorporados a partir de páginas de aplicativos. O Auto build suporta estilo para títulos e alguns elementos do relatório.

Os relatórios de Auto Build são uma alternativa ao uso do Crystal Reports. Eles são destinados ao uso com relatórios não perfeitos em pixels ou relatórios que não são considerados fidelidade de design perfeita, pois podemos melhorar ou fazer ajustes em como eles são renderizados em versões futuras. Se os relatórios perfeitos em pixels forem um requisito comercial, você deve usar o Crystal Reports. O Auto Build usa o Telerik biblioteca de relatórios.

Nota

Todos os relatórios internos foram convertidos para usar relatórios de AutoBuild.

Exemplo de AutoBuild

Como criar um relatório de construção automática

  1. Na página onde você deseja criar um relatório, vá para Gaveta de ações > Live Designer.
  2. Selecione a aba Edge Case na página selecionada.
  3. Selecione Relatório como o Tipo de página.
  4. Selecione Construção Automática como Tipo.
  5. Clique no botão Salvar.
  6. App Builder agora exibirá o relatório incorporado na página.

Como editar um relatório de construção automática

Se você precisar fazer edições em elementos (como Controles ou Nome da Página) em um relatório de Criação Automática, você pode fazer isso de uma das seguintes maneiras:

Modifique o relatório de construção automática usando o designer de páginas

Neste método, você editará o relatório usando o Page Designer clássico (em vez do Live Designer).

  1. Na página com o relatório Auto Build incorporado, vá para Action Drawer > Design This Page.
  2. Faça qualquer edição necessária.
  3. Salve e retorne à visualização do aplicativo, atualize o navegador da web e confirme a atualização.

Converter um relatório de criação automática em uma página dinâmica

Neste método, você converterá o relatório novamente em uma página dinâmica, fará as edições necessárias e, em seguida, alterará a página novamente para um relatório de criação automática.

  1. Na página com o relatório de Criação Automática incorporado, vá para Gaveta de Ações > Live Designer.
  2. Selecione a aba Edge Case na página selecionada.
  3. Selecione Página dinâmica como o Tipo de página.
  4. Clique no botão Salvar.
  5. App Builder agora exibirá a página dinâmica e você poderá fazer as edições necessárias.
  6. Após fazer as edições, repita o processo descrito em Como criar um relatório de construção automática.

Como tematizar um relatório de construção automática

Para ajustar o tema (cores, fontes, etc.) de um relatório de Criação Automática, siga estas etapas:

  1. Na página com o relatório de Criação Automática incorporado, vá para Gaveta de Ações > Live Designer.
  2. Selecione a aba Edge Case na página selecionada.
  3. Clique no campo Tema alternativo e selecione o tema padrão criado chamado "relatório v1".
  4. Clique no botão do ícone de divisa para ir para o Editor de temas.
  5. Clique no botão Copiar e salve o tema copiado em uma Coleção à qual seu aplicativo tenha acesso.
  6. Faça as modificações necessárias no tema e Salve.
  7. Retorne à página do aplicativo com o relatório e atualize o Tema alternativo para usar a versão copiada que você modificou.
  8. Clique em Salvar e saia do Live Designer.

Como adicionar uma imagem a um relatório

Se você quiser adicionar uma imagem a um relatório de Criação Automática, como um logotipo da empresa, siga estas diretrizes:

  • A imagem deve residir no Objeto de Negócios do painel que cria o relatório.
  • Para carregar a imagem corretamente, você deve incluir uma coluna de imagem no Objeto de Negócios originada de uma tabela:
    • Por exemplo, você pode adicionar uma coluna chamada Logotipo com o tipo Lógico de Foto à tabela Parâmetro. Supondo que o Objeto de Negócios do relatório seja projetado em uma tabela diferente de Parâmetro, você adicionaria a tabela Parâmetro ao Objeto de Negócios e exporia a coluna Logotipo.
  • Armazene a imagem na coluna de imagem definida. Aqui você pode expor a coluna de imagem à IU em uma página de Configuração e definir o Tipo de Controle como Arquivo para que você possa carregar a imagem.
  • Depois que a imagem for armazenada na coluna e no Objeto de Negócios, você pode adicionar o controle de imagem ao seu painel de relatório. Certifique-se de definir a coluna como a nova coluna criada para armazenar a imagem e defina a finalidade da imagem como Foto.

Configuração

Personalização adicional é possível com as opções de configuração do mecanismo de relatório Telerik, mas o sugerido appsettings.json a configuração precisa de alguns ajustes, como mostrado no exemplo a seguir.

  • Onde a configuração Telerik sugere o seguinte:

    ...
    "telerikReporting": {
      "extensions": [
        {
          "name": "PDF",
          "description":  "PDF Description",
          "parameters":
            [
              {
                "Name": "DocumentAuthor",
                "Value": "John Doe"
              }
            ]
          }
        ]
      }
    ...
    
  • Use o seguinte em App Builder:

    {
      "Reports": {
        "Telerik": {
          "extensions": [
            {
              "name": "PDF",
              "description": "PDF Description",
              "parameters": [
                {
                  "Name": "DocumentAuthor",
                  "Value": "Company Name"
                }
              ]
            }
          ]
        }
      }
    }
    

    Alternativamente, você pode usar variáveis de ambiente:

    Reports__Telerik__Extensions__0__Name=PDF
    Reports__Telerik__Extensions__0__Parameres__0__Name=DocumentAuthor
    Reports__Telerik__Extensions__0__Parameres__0__Value=Company Name
    

Nota

App Builder não suporta o uso de um web.config arquivo para configuração Telerik.

Limitações

Existem as seguintes limitações nas capacidades de renderização de HTML do Reporting Engine:

  • Respeita apenas estilos inline.

  • Funciona apenas com as opções de formatação de texto.

  • Ele é renderizado como texto simples, sem formatação no Excel.

  • Não suporta renderização RTL (da direita para a esquerda).

  • Ele suporta apenas XHTML

  • Ele suporta apenas as seguintes tags: FONT, STRONG, B, EM, I, U, A, OL, UL, SUB, SUP, LI, DIV, SPAN, P, BR, CENTER.