Índice

Páginas Relacionadas

Objetivo

       O objetivo deste documento é trazer uma visão de como funcionam as telas de cadastro, listagem e design e compartilhamentode Relatórios. 

Introdução

       Com a nova listagem O TReports permite a criação de relatórios temos dois tipos de exibição: Card ou Tabela, sendo possível selecionar qual melhor visualização em sua lateral.

       Os dois tipos de listagem possuem as mesmas funções básicas:

       Image Removed

• Edição
• Exclusão
• Compartilhamento
• Geração

Informações Gerais

       Na primeira etapa da montagem do relatório, apenas o Nome e Descrição(opcional) devem ser informados, a partir do avanço dessa etapa o relatório já será cadastrado.

Objeto de Negócio

       O Objeto de Negócio corresponde aos dados que serão exibidos no relatório. A informação de um Objeto de Negócio se dá através dos Conectores cadastrados, é de lá que a aplicação irá buscar os Objetos de Negócio, de suas respectivas Áreas.

       Um Objeto de Negócio pode ser buscado pela pesquisa, ou diretamente selecionado através das áreas exibidas.

       Após a seleção, a tela irá exibir uma Pré-Visualização dos dados daquele Objeto de Negócio, sendo possível também manipular as colunas exibidas na pré-visualização e verificar todas as informações sobre o Objeto selecionado.

Filtros

   Ainda na tela de seleção de Objeto de Negócio é possível a criação de filtros que permitem uma maior manipulação dos dados a serem disponibilizados no relatório. Os filtros permitem fazer combinações lógicas entre as condições dos valores das propriedades dos Objetos de Negócio.    

A tela de Filtros conta com 3 opções para a montagem: os operadores E e OU e a Condição.

• Operadores E/OU: Operadores lógicos que conduzem a criação do filtro por meio de agrupadores das condições;
• Condição: Definição da condição aplicada a uma propriedade do Objeto de Negócio para a realização do filtro.

Na configuração da condição, primeiro se escolhe a propriedade do Objeto de Negócio que será avaliada (serão listadas na tela as propriedades filtráveis do Objeto de Negócio). Com base no tipo da propriedade, que pode ser um texto, um número, uma data ou um valor booleano, são disponibilizadas as condições possíveis de serem aplicadas nessa propriedade, como por exemplo "Igual a", "Diferente de", "Maior que", "Menor que", dentre outras.

Em seguida, deve-se definir os valores ou os parâmetros para esse filtro. A diferença entre essas opções é:

• Valores -  São aplicados no filtro antes da geração do relatório;
• Parâmetros - São aplicados no filtro durante a pré-exibição/geração do relatório.

Quando selecionado Valores, o usuário deverá informar o valor ou os valores (caso a condição aceite mais de um) a ser aplicado no filtro.

Quando selecionado Parâmetros, o usuário deverá informar um nome para esse parâmetro, o qual será exibido nas telas de pré-exibição/geração com um campo para preenchimento do valor a ser aplicado no filtro.

Dessa forma, se o usuário que está criando relatório desejar que uma condição de um filtro seja sempre aplicada com um mesmo valor, deve configurar utilizando Valores. Caso deseje que o valor da condição do filtro possa ser informado posteriormente, ou seja, que possam ser aplicados valores diferentes, conforme sua necessidade, deve utilizar a opção de Parâmetros.

 Na configuração do Filtro, os nodos E/OU permitem criar nodos filhos a partir deles, enquanto as Condições se aplicam como irmãos.

Exemplo

Para exemplificar a utilização de Filtros, será usado um Objeto de Negócios chamado "Instalações Ativas", que traz informações sobre as instalações das aplicações do TReports.

Abaixo uma pré-visualização dos dados desse Objeto de Negócios:

Image Removed

Um filtro para disponibilizar os dados que respeitem as condições: Aplicação igual a 'TReports' e Data de Instalação maior que 01/01/2021 e Plataforma igual ao valor informado pelo usuário durante pré-visualização/geração do relatório é mostrado abaixo:

Image Removed

Nesse exemplo, as condições das propriedades Aplicação e Data de Instalação foram configuradas utilizando Valores e a condição da propriedade Plataforma foi configurada utilizando Parâmetros.

Design

de forma simples e rápida, disponibilizando diversos recursos para auxiliar no seu design e na apresentação dos dados.

      Os Relatórios podem ser acessados através da tela de Listagem. onde também é possível iniciar o fluxo de criação. Para maiores detalhes do fluxo de criação, ver Iniciando o Fluxo de Criação de Recursos.

Listagem

       A tela de listagem pode ser acessado através do item "Relatórios (Novo)" do menu do TReports. Na tela de listagem de relatórios temos dois tipos de exibição: Card ou Tabela, sendo possível selecionar qual melhor visualização em sua lateral.

       Os dois tipos de listagem possuem as mesmas funções básicas:

       Image Added

• Editar
• Excluir
• Compartilhar
• Gerar
• Exportar

Design

       Na etapa de Design        Após a definição do Objeto de Negócio do Relatório, na etapa de Desenho será possível manipular a forma com que os dados serão exibidos no Relatório, contando com contando com diversos componentes para a personalização do relatório.

       A aplicação conta com o Design de Relatórios da DevEx, para documentação sobre o uso de seus componentes, acesse: https://docs.devexpress.com/XtraReports/2162/reporting

       Na lateral esquerda, estão disponíveis vários controles que podem ser adicionados ao relatório e que possuem funções únicas, possibilitando criar relatórios com Imagens, Tabelas, Gráficos , etc.

       Na lateral direita, o Desenho conta com algumas funções como a barra de Propriedades, a criação de Expressões, a Lista de Campos para o relatório e o Explorador do Relatório.

Compartilhamento