Ferramentas para relat�rios no ASP.NET

Este artigo mostra algumas das ferramentas que s�o usadas na construç�o de relat�rios em ASP.NET, os quais s�o utilizados com bastante frequ�ncia pelos desenvolvedores.

Nada melhor que mostrar exemplos das funcionalidades b�sicas e vantagens que cada uma pode oferecer na hora da escolha, como aux�lio na visualizaç�o de informaç�es que est�o armazenadas em fonte de dados diversas, relat�rios integrados nas p�ginas web ou aplicativos Windows forms, que possibilitam exibir informaç�es de maneira em que os dados fiquem bem organizados e formatados.

No dia a dia dos desenvolvedores, analistas, gerente de projetos, arquitetos dentre outros precisam tomar decis�es sobre qual ferramenta vai melhor atender as necessidades do projeto. Por isso, � interessante saber se o que estamos utilizando vai atender de maneira bem �gil para mostrar as informaç�es ao usu�rio do sistema, que sempre est�o em busca de relat�rios para as tomadas de decis�es na empresa.

As ferramentas que ser�o abordadas s�o: o Microsoft Report Viewer e o Crystal Report Viewer que j� vem no Visual Studio. Ser�o feitos exemplos das principais funcionalidades dessas ferramentas, nos dando uma vis�o de qual ferramenta se ad�qua ao nosso projeto.

O banco de dados que nos dar� suporte ser� o Northwind, que pode ser baixado . Ap�s fazer o download do banco, restaure no SQL Server Management Studio Express. Utilizaremos o IDE Visual Studio 2008 para o desenvolvimento dos exemplos.

Microsoft Report Viewer

� um Package que mostra relat�rios em sua aplicaç�o, apresentado em duas vers�es, tanto para Web para projetos ASP.NET, quanto para Windows Forms em aplicaç�es Windows, e s�o voltados para a visualizaç�o de relat�rios. O Report View n�o apresenta qualquer restriç�o quanto a distribuiç�o de um projeto .NET.

Vamos criar um relat�rio atrav�s desse controle: primeiro abra o Visual Studio em Iniciar /Programas /Microsoft Visual Studio 2008 e depois crie um novo WebSite em File /New /WebSite, conforme a Figura 1 .

Figura 1. Novo Web Site

Perceba que o Item 1 representa o template do projeto que vai ser do tipo ASP.NET Web Site e o Item 2 � o Location que pode ser selecionado como File System, possibilitando ao sistema ser salvo em um diret�rio da escolha do desenvolvedor. No nosso caso foi salvo em C:\Report, conforme o Item 3. Por fim o Item 4 vemos em qual linguagem vai ser desenvolvido o WebSite, que � o Visual C#.

Vamos organizar o nosso projeto criando a seguinte estrutura de pastas:

A pasta chamada Forms, que vai guardar p�ginas Web;
A pasta Reports vai guardar os relat�rios;
A pasta Images vai guardar as imagens.

Na aba Solution Explorer, com o bot�o direito, clique no projeto e selecione New Folder para criar as pastas.

Em cima da pasta Forms, com o bot�o direito e selecione Add New Item (Figura 2). Ser� mostrada uma tela igual a da Figura 3, onde ser� selecionado o Templates do tipo WebForm, que � uma p�gina web, com o nome Exemplo01.aspx.

Figura 2. Adicionando uma nova p�gina

Figura 3. Escolhendo o template Web Form

A p�gina ser� criada e nesse momento ser� adicionado o controle MicrosoftReportViewer, mas antes, para mostrar o Design da p�gina, clique em Design, como vemos na Figura 4.

Figura 4. Mostra o Design na p�gina

Pronto, agora vamos arrastar e soltar o controle na p�gina, que est� na janela ToolBox, como mostra a Figura 5.

Figura 5. Janela ToolBox

� necess�rio criado um Typed DataSet, que � um arquivo .xsd e representa um Schema XML. Este � um documento XML que define as propriedades e m�todos que t�m o mesmo schema (colunas, tipos de dados) da tabela do database Northwind. No entanto, n�o entraremos em detalhes quanto aos m�todos Insert, Update e Delete do DataTable.

Para adicionar no Solution Explorer o dataset clique no projeto com o bot�o direito e selecione Add New Item, conforme a Figura 6. Selecionaremos o template DataSet (Item 1) e o nome do arquivo NorthwindProducts.xsd� (Item 2).

Figura 6. Escolhendo o template DataSet

Uma forma de manipular o DataSet � utilizando o Editor para criar e modificar graficamente um arquivo XSD. Para isso, clique nele com o bot�o direito e depois em Open With, conforme mostram as Figuras 7 e 8.

Figura 7. Escolhendo o template DataSet

Figura 8. Escolhendo o programa o qual ser� aberto o arquivo

�

Uma das formas bem r�pida de criar o dataset � pela janela do Server Explorer, que possibilita criar a conex�o com o banco Northwind. Depois de criada, clique na tabela Products e arraste para o DataSet Desinger, como mostra a Figura 9.

Figura 9. DataSet Designer

�

Na aplicaç�o web falta adicionar e formatar o relat�rio: com o bot�o direito na pasta Report add new item (Figura 10 - Item1 ), que � o template Report. Crie o relat�rio com o nome ReportProducts.rdlc, conforme o Item 2. Dessa forma o processamento ser� local, no computador que hospeda aplicaç�o e � quem se encarregar� de processar.

Figura 10. Template Report Wizard

Primeiramente vamos habilitar o Page Header no menu Report / Page Header do relat�rio, que vai conter uma imagem e o t�tulo, mas antes � necess�rio informar as imagens que v�o ser vinculadas ao relat�rio, atrav�s do menu Report / Embedded Images, como mostra a Figura 11.

Figura 11. Importando as imagens para o relat�rio

Como voc� pode ver na Figura 12, atrav�s do Item 1, adicionamos o objeto Image clicando e arrastando para o Page Header do relat�rio. No Item 2 o source ser� selecionado para a opç�o Embedded, que � forma feita anteriormente, onde vincula as imagens. Em value adicione as imagens que foram vinculadas para aparecer. Arraste tamb�m um textbox onde ser� colocado o t�tulo do relat�rio - �Products�.

Figura 12. Adicionando o objeto imagem e configurando

A janela toolbox permitir� definir um layout para o relat�rio, que vai conter duas Data Regions: a Table e o Chart, que s�o vinculadas a fonte de dados, como voc� pode ver na Figura 13.

Figura 13. Formatando o relat�rio

� A Figura 14 mostra a janela WebSite Data Sources com o dataset que foi disponibilizado. Nesse momento clique e arraste no campo ProductName e UnitPrice para a Table, conforme mostram os Itens 1 e 2. Acabamos de definir duas colunas no relat�rio: nome do produto e o preço. Para fazer o somat�rio do preço dos produtos utilizaremos a f�rmula =Sum(Fields!UnitPrice.Value) que faz a somat�ria do campo UnitPrice (Item 3)

Figura 14. Colocando os campos que ser�o visualizados no relat�rio

Quanto ao gr�fico, ser� mostrada a comparaç�o do preço com os produtos: com o bot�o direito do mouse no chart selecione Properties e na aba Data da janela tem um dropdownlist com a legenda DataSet Name. L� ser� selecionado o dataset NorthwindProducts_Products, de acordo com o Item1 da Figura 15. J� no Item 2 ser�o mostrados os valores dos preços que v�o ficar disponibilizados no eixo Y. Ent�o clique em editar e coloque na aba Values as informaç�es como mostra a Figura� 16. No Item 3 temos os nomes dos produtos que v�o ficar disponibilizados no eixo X, que v�o se relacionar com os preços. Preencha de acordo com a Figura 17. � E para finalizar, na aba legend desmarque a opç�o Show Legend para n�o mostrar a legenda no gr�fico.

Figura 15. Propriedade do Gr�fico

Figura 16. Editar Valores do Gr�fico

Figura 17. Valor que se relaciona com o preço

Voltando para a p�gina web criada do Exemplo01.aspx, no code-behind coloque o c�digo da Listagem 1, que faz a conex�o com o banco. Veja que tem um select para retornar os seis �ltimos produtos e associar o dataset com o ReportViewer datasource.


using System;
using System.Data;

using System.Data.SqlClient;

using Microsoft.Reporting.WebForms;

 

public partial class Exemplo01 : System.Web.UI.Page

{

 

  #region Events Handles

 

  protected void Page_Load(object sender, EventArgs e)

  {

    if (!IsPostBack)

    {

      CarregaRelatorio();

    }

  }

 
  #endregion

  
  #region Private Methods

  private void CarregaRelatorio()

  {

    //T�tulo da p�gina

    Page.Title = "Relat�rio";

 

    //Conex�o com o banco de dados

    SqlConnection Con = null;

    Con = new SqlConnection(@"Password=suasenha;Persist Security Info=True;
    User ID=seusuario;Initial Catalog=Northwind;Data Source=DESENV\SQLEXPRESS");

    Con.Open();

    SqlCommand Cmd = Con.CreateCommand();

    //Select que retorna 06 produtos

    Cmd.CommandText = "Select top 6 * from Products ";

    SqlDataAdapter Da = new SqlDataAdapter(Cmd);

    DataTable dt = new DataTable();

    Da.Fill(dt);

    Con.Close();

 

    //Associa o dataset com o ReportViewer datasource

    ReportDataSource rpda = new ReportDataSource();

    rpda.Name = "NorthwindProducts_Products";

    rpda.Value = dt;

 

    ReportViewer1.LocalReport.DataSources.Clear();

    //Adiciona o objeto rpda ao controle ReportViewer

    ReportViewer1.LocalReport.DataSources.Add(rpda);

 

    //Local que est� o relat�rio

    ReportViewer1.LocalReport.ReportPath = "Reports/ReportProducts.rdlc";

 

    ReportViewer1.LocalReport.Refresh();

  }

 

  #endregion

}

Listagem 1. Conex�o com o banco de dados

Uma das vantagens do Report View � que o relat�rio pode ser exportado para PDF ou Excel. O resultado do relat�rio pode ser visto na Figura 18.

Figura 18. Mostra o relat�rio gerado pelo controle ReportView

Crystal Report Viewer

Permite mostrar relat�rios em sua aplicaç�o, tanto para�projetos Web quanto Windows Forms. Para explorar alguns dos recursos do Crystal Report Viewer, neste t�pico teremos o exemplo utilizando com o Microsoft ReportView. Para isso crie uma p�gina com o nome Exemplo02.aspx e adicione o controle Crystal Report Viewer, como mostra a Figura 19. Uma das vantagens do Crystal Report Viewer � que o relat�rio pode ser exportado para Crystal Reports (RPT), Acrobat Format (PDF), MS Word, MS Excel 97-2000, MS Excel 97-2000 (Data Only) e Rich Text Format.

Figura 19. Crystal Report Viewer

Para configurar o layout do relat�rio � necess�rio adicionar um template no projeto, como pode ser visto na Figura 20.

Figura 20. Template Crystal Report

Começando pelo Section Report Header, onde ser� adicionado uma imagem atrav�s do menu Crystal Reports / Insert / Picture, selecione a imagem desejada e depois na janela Toobox selecione Text Object e ent�o arraste para o relat�rio. O t�tulo ser� �Products�, conforme a Figura 21.

Figura 21. Report Header com imagem e t�tulo

Para formatar o relat�rio o dataset tem que ser adicionado, ent�o na janela Filder Explorer, com o bot�o direito, clique em Database Filds / DataBase Expert, como pode ser visto na Figura 22. Perceba que ser� aberta a janela Database Expert, de acordo com a Figura 23, para localizar o dataset. Clique em � Project Data / ADO.NET DataSets e o localize. Depois selecione a tabela Products e clique na seta �>� para adicionar.

Figura 22. Adicionando o Typed DataSet

Figura 23. Localizando Typed DataSet e Adicionar no relat�rio

A Figura 24 � mostra como adicionar os campos no relat�rio: clique em ProductName e depois em�UnitPrice e arraste para a Section Details. Depois clique com o bot�o direito na parte branca do relat�rio e selecione Insert / Summary, onde ser� aberta uma janela Insert Summary, conforme exibido na Figura 25 - Item 1 . Escolha o campo e no Item 2 escolha a opç�o sum, que vai fazer o somat�rio do campo escolhido.

Figura 24. Colocando os campos que ser�o visualizados no relat�rio

Figura 25. Inserindo a somat�ria no relat�rio

� E por fim, a Figura 26 mostra como inserir no relat�rio o gr�fico atrav�s do menu Crystal Reports / Insert / Chart. Ser� aberta uma janela, de acordo com a Figura 27, onde� na aba Type pode ser escolhido um dos v�rios tipos de gr�fico. Para o nosso exemplo escolhemos o Bar, que � o tradicional gr�fico de barras. Na aba Data faremos a montagem do gr�fico, ou seja, relacionaremos os produtos com os seus respectivos valores (Figura 28). Repare que a aba Text permite personalizar a legenda que o gr�fico vai mostrar.

Figura 26. Inserindo o gr�fico

Figura 27. Escolhendo o tipo de gr�fico

Figura 28. Selecionando os dados do gr�fico

A Listagem 2 mostra o code-behind da p�gina Exemplo02.aspx, onde � criada a conex�o com o banco. Ap�s isso s�o retornadas as informaç�es para serem carregadas no relat�rio, e por fim o objeto relatorio adiciona ao controle CrystalReportViewer1.


using System;

using System.Data;

using System.Data.SqlClient;

 

public partial class Exemplo02 : System.Web.UI.Page

{

  #region Object

  //Cria uma inst�ncia do ReportClass

  CrystalDecisions.CrystalReports.Engine.ReportClass relatorio = 
   new CrystalDecisions.CrystalReports.Engine.ReportClass();

 
  #endregion

 

  #region Events Handles

 

  protected void Page_Load(object sender, EventArgs e)

  {

    if (!IsPostBack)

    {

      CarregaRelatorio();

    }

  }

 

  #endregion

 

  #region Private Methods

 

  private void CarregaRelatorio()

  {

    //T�tulo da p�gina

    Page.Title = "Relat�rio";

 

    //Conex�o com o banco de dados

    SqlConnection Con = null;

    Con = new SqlConnection(@"Password=suasenha;Persist Security Info=True;
    User ID=seuusuario;Initial Catalog=Northwind;Data Source=DESENV\SQLEXPRESS");

    Con.Open();

    SqlCommand Cmd = Con.CreateCommand();

    //Select que retorna 06 produtos

    Cmd.CommandText = "Select top 6 * from Products ";

    SqlDataAdapter Da = new SqlDataAdapter(Cmd);

    DataTable dt = new DataTable();

    Da.Fill(dt);

    Con.Close();

 

    //Local que est� o relat�rio

    relatorio.FileName = Server.MapPath("~/Reports/CrystalReportProducts.rpt");

    //Define o DataDource do Relat�rio

    relatorio.SetDataSource(dt);

    //Visualiza o relat�rio

    CrystalReportViewer1.ReportSource = relatorio;

    CrystalReportViewer1.DataBind();

  }

 

  #endregion

}

Listagem 2. Conex�o com o banco

Figura 29. Mostra o relat�rio gerado pelo controle Crystal Reports

As ferramentas discutidas neste artigo s�o as principais utilizadas no Visual Studio, e por esse motivo despertou o interesse em mostrar o que � poss�vel fazer em cada uma delas. O desafio era fazer um relat�rio que apresentasse as mesmas informaç�es em ambos as ferramentas.

Neste artigo foi poss�vel ver algumas vantagens e como implementar o relat�rio, dando um norte de qual ferramenta melhor se adequ� no projeto em execuç�o.

Ferramentas para relat�rios no ASP.NET

Microsoft Report Viewer

Crystal Report Viewer

Artigos relacionados