Função

O componente renderiza os relatórios criados no Cronapp em uma página web. O visualizador de relatório também permite fazer download em alguns formatos, imprimir, mudar o modo de visualização, dentre outras funcionalidades.

Figura 1.1 - Exemplo do componente rodando no browser

Funcionalidades

Dependendo da configuração, o componente Visualizador de relatório pode ou não exibir a barra de funcionalidades superior e a barra de rolagem lateral para o usuário.

Figura 1.2 - Barra de ferramenta do relatório

1. Imprimir: O botão permite três opções:

   • Imprimindo para PDF: abre a janela de impressão para salvar como PDF;

   • Imprimir com Pré-visualização: abre nova aba do navegador para exibir o relatório em página inteira;

   • Imprimir sem Pré-visualização: abre a janela de impressão;

2. Salvar: Permite download do relatório em 6 formatos distintos;

3. Exibe/oculta os marcadores de página do relatório. Ficará desabilitado se não houver marcador no relatório;

4. Abre a caixa de diálogo para mudar os parâmetros básicos do relatório;

5. Oculta ou exibe os thumbnails do relatório;

6. Habilita o painel de pesquisa do relatório;

7. Vai para a primeira página do relatório;

8. Vai para a página anterior do relatório;

9. Informa a página atual e o total de páginas;

10. Vai para a próxima página do relatório;

11. Vai para a última página do relatório;

12. Expande o relatório no modo tela cheia. Para sair desse modo, basta clicar novamente no ícone;

13. Aplica o zoom no relatório, além de ser percentual ele pode ser aplicado como:

    • Altura de página: altera o zoom do relatório para ver a página inteira no visualizador de relatório. É possível mostrar mais de uma página (ficando lado a lado).

    • Largura de página: altera o zoom do relatório para expandir a página até as bordas do componente;

14. Define o modo de visualização da página do relatório:

    • Única página: mostra somente a página atual do relatório;

    • Contínuo: todas as páginas são exibidas em sequência;

    • Múltiplas páginas: mostra mais de uma página, lado a lado, dependendo do zoom selecionado.

Exportação

Ao escolher o formato que deseja salvar, a janela de Configuração de Exportação será aberta. O conteúdo da janela muda conforme o tipo de arquivo selecionado para o download.

Figura 1.3 - Tooltip explicativo da opção

Propriedades

Na tabela abaixo estão descritas as principais propriedades do componente visual.

Configurações

A propriedade configurações abre a janela de configurações do visualizador de relatório (Figura 2.1), onde é feita a seleção do relatório que será visualizado, habilita a caixa de ferramentas para o usuário, exibe a barra de rolagem e configura os filtros do relatório.

Figura 2.1 - Janela de configuração do visualizador de relatório

1. Abre a janela para selecionar o relatório a ser visualizado;

2. Atualiza o campo relatório;

3. Remove o relatório do campo;

4. Mostra os filtros que foram criados no relatório:

   1. Nome: nome do campo que receberá o conteúdo para o filtro;

   2. Valor do campo: tipo do dado a ser filtrado, podendo ser do tipo texto, numérico, data e hora, hora, lógico e expressão.

5. Altura: define a altura máxima do relatório - em pixels;

6. Campos que por padrão não vem previamente selecionados:

   1. Exibir barra de ferramenta: exibe uma barra de ferramentas no topo do visualizador de relatório;

   2. Exibir barra de rolagem: exibe a barra de rolagem na lateral do relatório.

Adicionar relatório ao visualizador

Para adicionar um relatório, clique no ícone (1) para abrir a janela de busca - na qual todos os relatórios criados no projeto serão mostrados (2); assim, escolha o relatório e clique em selecionar (Figura 2.2).

Figura 2.2 - Adicionando um relatório ao visualizador

Filtro

O relatório permite receber parâmetros para realizar filtros no conteúdo exibido.

Quando um relatório que contenha filtros é selecionado, seus parâmetros são exibidos na janela de configuração do Visualizador, permitindo que seja selecionado de onde virá os parâmetros. Por exemplo: texto estático, um campo de entrada de texto na tela ou uma querystring passada pela URL,

Figura 2.3 - Filtro recebendo o dado vindo de um campo de entrada de texto