O objetivo deste tutorial é mostrar a criação de um relatório simples com o Crystal Reports.NET, uma ferramenta integrada ao Visual Studio.NET. Atualmente quase todas as aplicações acessam um banco de dados e na maioria delas é necessário uma grande variedade de relatórios: o Crystal Reports.NET nos dá a oportunidade de criar muitos tipos de relatórios, com modelos que acompanham o produto e também possibilitando a criação de modelos personalizados.
Nesse tutorial presumirei que você conheça a arquitetura do ADO.NET e seus objetos, assim como o Visual Basic.NET, por isso não me aterei a explicar detalhes da criação dos objetos de acesso a dados (para saber mais sobre o ADO.NET e como utilizá-lo consulte os tutoriais "Mudanças do ADO para o ADO.NET" e "Acesso a Dados com VB.NET", disponíveis aqui no site do BABOO).
Software utilizado:
- Microsoft Visual Studio.NET 2003 Enterprise Architect (também conhecido como "Everett" ou versão 7.1) - Beta Final
- Microsoft SQL Server 2000 Personal Edition
Requisitos do sistema (Para instalação completa, que contém todas as linguagens e recursos):
- Processador Intel Pentium II /AMD K6-2 a partir de 450 Mhz (Pentium III/AMD Duron a partir de 600 Mhz recomendados)
- Memória RAM: 96 MB para Windows 2000 Pro (Recomendado 128 MB)
192 MB para Windows 2000 Server (Recomendado 256 MB)
96 MB para Windows XP Home (Recomendado 160 MB)
192 MB para Windows XP Pro (Recomendado 256 MB)
192 MB para Windows Server 2003 (Recomendado 256 MB)
- 4.1 GB no drive da instalação e 900 MB no drive do sistema
- Sistema Operacional: Windows 2000*, Windows XP ou Windows Server 2003
Obs: É possível executar aplicações desenvolvidas com o VS.NET no Windows 98/Me/NT 4 mas não é possível desenvolver as aplicações nesses sistemas.
* o Windows 2000 Datacenter Server não é suportado.
- Drive de CD-ROM ou DVD-ROM
- Placa de vídeo e monitor que suporte resolução de 800x600 e 256 cores (Recomendado High Color 16-Bit)
- Mouse
Iniciando:
Abra o Visual Studio.NET e crie uma aplicação "Windows Forms" do Visual Basic.NET e dê a ela o nome de "Crystal":
New Project
Clique em OK. Agora iniciaremos a criação dos objetos de acesso a dados. Como dito no início, explicar a criação desses objetos não é o objetivo deste tutorial, portanto será um processo explicado de forma rápida.
Adicionaremos ao form um objeto "SQLConnection", um objeto "SQLDataAdapter" e um objeto "DataSet". O objeto SQLConnection deve se chamar "Conexao" e acessar o banco de dados Northwind do SQL Server 2000. O objeto SQLDataAdapter deverá se chamar "Adapter" e seu conteúdo será selecionado com a seguinte query: "SELECT * FROM Customers ORDER BY CustomerID".
O objeto DataSet deverá ser do tipo Typed DataSet e seu nome DSRelatorio, ele irá conter a tabela Customers que foi selecionada no DataAdapter (se você quer saber mais sobre Typed Datasets leia o tutorial Usando Typed Datasets no Visual Basic.NET).
Procure na ToolBox pelo componente "CrystalReportViewer", que fica ao final da lista de componentes da aba "Windows Forms" :
Controle CrystalReportViewer
Atenção: se este controle não estiver presente, faça o seguinte: clique com o botão direito do mouse em uma área vazia da Toolbox e selecione "Add/Remove Items...", será apresentada uma janela para seleção dos controles, procure na lista por "CrystalReportViewer" pois deverão aparecer duas ocorrências na lista. Selecione as duas.
Coloque um controle "CrystalReportViewer" no form e configure sua propriedade "Dock" para "Fill" e também a propriedade "WindowState" do form para "Maximixed", assim a janela será mostrada maximizada e o relatório ocupará todo o form. Veja como fica o layout do form:
Layout do form
Não se preocupe com as dimensões do form agora pois mesmo estando com um tamanho reduzido durante o design, se você definir a opção WindowState para Maximized o form será maximizado quando executado. Selecione o CrystalReportViewer e dê a ele o nome de "Viewer".
Agora vamos criar nosso relatório: pressione as teclas "Ctrl+Shift+A" para abrir a janela "Add New Item...".
Veja abaixo:
Adicionando novo item
Selecione o grupo "Utility" em Categories e "Crystal Reports" em Templates. Em Name digite Relatorio.rpt. Após isso clique em "Open". Começaremos então a criar o nosso relatório.
A primeira janela apresentada será a seguinte:
Crystal Report Gallery
Para nosso relatório nós deixaremos as opções como estão: a opção "Using the Report Expert" define que usaremos o assistente do Crystal Reports para fazer o relatório e logo abaixo escolheremos o modelo de relatório - no nosso caso "Standard". Clique em OK.
Agora iremos escolher a tabela que usaremos nesse relatório :
Selecionando a tabela do relatório
Aqui você deve escolher a fonte de dados: é possível até mesmo criar uma conexão neste ponto. Como já criamos os objetos anteriormente, basta expandir o item "Project Data" e o item "ADO.NET DataSets". Teremos o DataSet que criamos e ao expandi-lo veremos a tabela "Customers". Selecione a tabela e clique me "Insert Table". Após isso clique em Next.
