11 05 2016

Ao contrário do Report Viewer (que não possui um viewer específico para WPF), a SAP disponibiliza um controle visualizador para os relatórios do Crystal Reports no WPF. Entretanto, o viewer não é adicionado automaticamente na caixa de ferramentas do Visual Studio e nem temos muitos exemplos em português abordando esse tema. E é justamente devido a esses motivos que eu vou explicar para você no artigo de hoje como trabalhar com o Crystal Reports no WPF.

Criando o projeto e relatório de exemplo

Primeiramente, vamos começar criando um projeto do tipo “WPF Application“. Nesse projeto, vamos adicionar um DataSet de exemplo, chamado “DataSetExemplo“. Dentro do DataSet, adicione uma DataTable chamada “DataTableExemplo“, com as colunas “ColunaExemplo1” e “ColunaExemplo2“:

Feito isso, vamos adicionar no projeto um novo item do tipo “Crystal Reports“, dando o nome de “SeuCrystalReport“:

Nota: se você não estiver encontrando o item “Crystal Reports”, provavelmente você não instalou a biblioteca correta. Caso você esteja com essa dificuldade, confira o meu artigo sobre a instalação do Crystal Reports no Visual Studio para maiores detalhes.

Vamos criar um relatório bem simples, uma vez que o foco do artigo não é a criação do relatório, mas sim, a sua utilização no WPF. Se você quiser conferir um exemplo de relatório mais elaborado, confira o artigo onde eu mostrei como criar relatórios mestre/detalhe com o Crystal Reports e Entity Framework.

Dito isso, no relatório em branco, vamos executar o “Database Expert” para adicionarmos a fonte de dados para o nosso relatório:

Dentro do “Database Expert“, encontre o DataSet que criamos anteriormente e mova-o para o lado direito:

Feito isso, ajuste o layout do relatório, adicionando um título e arrastando as duas colunas para a área de detalhes do relatório, de forma que ele fique parecido com a imagem abaixo:

Pronto! Agora que temos o nosso relatório de exemplo preparado, vamos conferir como podemos exibi-lo na nossa Window.

Adicionando o viewer do WPF na ToolBox

Em primeiro lugar, temos que adicionar o controle visualizador do Crystal Reports na caixa de ferramentas do Visual Studio. O viewer do Windows Forms é adicionado automaticamente na Toolbox durante a instalação, mas, o viewer do WPF não é adicionado automaticamente (vai entender).

Para isso, temos que clicar com o botão direito na caixa de ferramentas e escolher a opção “Choose Items“:

Dentro da tela “Choose Toolbox Items“, encontre o item CrystalReportsViewer dentro da categoria “WPF Components” e marque a caixa de opções para que ele seja mostrado na ToolBox:

Clique em “OK” e você verá que o item do Crystal Reports será adicionado à categoria “General” da caixa de ferramentas:

Configurando o viewer no WPF

Com o controle visualizador adicionado à caixa de ferramentas, vamos arrastá-lo para dentro da nossa Window, mais especificamente, para dentro do Grid. Note que, ao arrastarmos o controle para dentro da Window, uma nova declaração de namespace é adicionada (xmlns:Viewer). Para conseguirmos manipular o viewer do code-behind, temos que definir um nome para o controle (x:Name). Dessa forma, dê o nome de “CrystalReportsViewer” para o controle:

<Window xmlns:Viewer="clr-namespace:SAPBusinessObjects.WPF.Viewer;assembly=SAPBusinessObjects.WPF.Viewer"  
        x:Class="CrystalReportsWPF.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <Viewer:CrystalReportsViewer x:Name="CrystalReportsViewer"/>
    </Grid>
</Window>

Note que, como no Windows Forms ou Web Forms, podemos definir diversas outras propriedades do controle do Crystal Reports diretamente na janela de propriedades:

Uma vez definido um nome para o controle, vamos para o code-behind da nossa Window para fazermos o carregamento do relatório. No construtor da janela, logo depois da chamada de “InitializeComponents” (ou no evento “Loaded” da Window, caso você esteja trabalhando com o VB.NET), vamos adicionar o código para fazer o carregamento:

        // C#
        public MainWindow()
        {
            InitializeComponent();

            var dataSet = new DataSetExemplo();
            dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 1.1", "Linha 1.2");
            dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 2.1", "Linha 2.2");
            dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 3.1", "Linha 3.2");
            dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 4.1", "Linha 4.2");
            dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 5.1", "Linha 5.2");

            var reportDocument = new SeuCrystalReport();
            reportDocument.SetDataSource(dataSet);

            CrystalReportsViewer.ViewerCore.ReportSource = reportDocument;
        }

    ' VB.NET
    Private Sub Window_Loaded(sender As Object, e As RoutedEventArgs)
        Dim dataSet As New DataSetExemplo()
        dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 1.1", "Linha 1.2")
        dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 2.1", "Linha 2.2")
        dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 3.1", "Linha 3.2")
        dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 4.1", "Linha 4.2")
        dataSet.DataTableExemplo.AddDataTableExemploRow("Linha 5.1", "Linha 5.2")

        Dim reportDocument As New SeuCrystalReport()
        reportDocument.SetDataSource(dataSet)

        CrystalReportsViewer.ViewerCore.ReportSource = reportDocument
    End Sub

Pronto! Execute o aplicativo e veja o belo erro que vamos receber:

An unhandled exception of type ‘System.IO.FileNotFoundException’ occurred in mscorlib.dll. Additional information: Could not load file or assembly ‘file:///C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Common\SAP BusinessObjects Enterprise XI 4.0\win32_x86\dotnet1\crdb_adoplus.dll’ or one of its dependencies. The system cannot find the file specified.

Esse é um erro clássico do Crystal Reports em aplicações que utilizam o .NET Framework 4 ou superior. Corrigi-lo é muito fácil. Basta adicionarmos o elemento “useLegacyV2RuntimeActivationPolicy” com o valor “true” na tag “startup” do nosso arquivo app.config:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup useLegacyV2RuntimeActivationPolicy="true"> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
</configuration>

Agora sim, ao executarmos o aplicativo, veremos o relatório sendo exibido corretamente:

Uma coisa que poderíamos ter feito diferente é fazer o carregamento do relatório a partir de um arquivo em disco (e não a partir de um relatório atachado ao próprio projeto, como fizemos anteriormente). Para isso, ao invés de criarmos o “reportDocument” como uma instância de “SeuCrystalReports“, temos que criar uma instância genérica de “ReportDocument” e, logo em seguida, chamamos o método “Load” passando o caminho do arquivo rpt em disco:

            // C#
            var reportDocument = new CrystalDecisions.CrystalReports.Engine.ReportDocument();
            reportDocument.Load("caminhoDoSeuRelatorio.rpt");
            reportDocument.SetDataSource(dataSet);

        ' VB.NET
        Dim reportDocument As New CrystalDecisions.CrystalReports.Engine.ReportDocument()
        reportDocument.Load("caminhoDoSeuRelatorio.rpt")
        reportDocument.SetDataSource(dataSet)

Concluindo

Não é difícil exibirmos relatórios do Crystal Reports no WPF, uma vez que a biblioteca disponibilizada pela SAP (atual mantenedora do Crystal Reports) possui um controle visualizador do Crystal Reports para o WPF. Nesse artigo você conferiu como adicionar esse controle na caixa de ferramentas do Visual Studio e como utilizá-lo para exibir o seu primeiro relatório.

E você? Já tinha utilizado esse controle no WPF? Tem alguma observação importante? Nos conte mais detalhes logo ali embaixo na caixa de comentários!

Por fim, convido você a inscrever-se na minha newsletter. Ao fazer isso, você receberá um e-mail toda semana sobre o artigo publicado e ficará sabendo também em primeira mão sobre o artigo da próxima semana, além de receber dicas “bônus” que eu só compartilho por e-mail. Inscreva-se utilizando o formulário logo abaixo.

Até a próxima!

André Lima

Como podemos exportar relatórios do Report Viewer? Como podemos obfuscar aplicações .NET?