Instalação de FastReport Business Graphics em FastReport .NET

FastReport Business Graphics é uma biblioteca contendo várias formas de visualização avançada de dados. Atualmente, contém diagramas: mapa de Treemap, Sunburst, Icicle e Gantt.

Hoje vamos analisar como conectar FastReport Business Graphics .NET ao FastReport .NET. Isto lhe permitirá utilizar diagramas de FastReport Business Graphics em seus relatórios.

A primeira coisa que você precisa fazer é instalar FastReport Business Graphics e FastReport .NET em seu computador. Pode leer como instalar estes produtos em nossos outros artigos.

No diretório no qual você instalou o FastReport .NET, você verá a pasta Extras\Objects\FastReportBGObjects. Nesta pasta, abra o projeto FastReportBGObjects.csproj. Este é o projeto para construir a .dll que precisamos.

Abra a lista de links do projeto. Vai ficar assim:

Apague FastReport, FastReport.BG e FastReport.Compat desta lista. Como nosso objetivo é adicionar FastReport Business Graphics ao FastReport .NET, você deve adicionar exatamente os arquivos .dll que usará no trabalho. Substitua os arquivos apagados por FastReport.dll e FastReport.Compat.dll do diretório de instalação FastReport .NET e o arquivo FastReport.BG.dll na pasta raiz de instalação FastReport Business Graphics.

Uma vez que você tenha substituído os links por links atualizados, monte o projeto.

Se a construção for bem sucedida, você está pronto para prosseguir para o próximo passo da instrução: conexão de plug-in ao FastReport .NET. O arquivo dll do plug-in montado é chamado FastReportBGObjects.dll e está localizado na subpasta do projeto:
Extras\Objects\FastReportBGObjects\bin\Debug

Você pode mover o arquivo para outra pasta, mas terá que fazer isso toda vez que o construir novamente. Para a demonstração, vou movê-la para a pasta C:\DLL.

Vejamos dois casos separados.
1) Você está usando FastReport Designer. Neste caso, você precisa conectar a biblioteca dll no próprio designer e reiniciá-la, ou especificar sua localização no arquivo de configuração. Você pode conectar o plug-in no menu Configurações - Plug-ins:

Para adicionar um link ao plug-in, abra o arquivo de configuração com qualquer editor de texto e modifique-o da seguinte forma:

 <?xml version="1.0" encoding="utf-8"?>
<Config>
...
<Plugins>
<Plugin Name="c:\.....\FastReportBGObjects.dll"/>
</Plugins>
</Config>

A área em negrito é o caminho para o plug-in.

2) Você está usando FastReport como parte de algum projeto. Neste caso, adicione FastReportBGObjects.dll à lista de links do seu projeto e adicione o seguinte código ao código do projeto:

RegisteredObjects.Add(typeof(SunburstObject), "ReportPage", 125);

Este código deve ser executado uma vez.

Atenção! As bibliotecas FastReportBGObjects.dll e FastReportBG.dll devem estar adicionalmente localizadas ao lado da aplicação que as utiliza. Se você usa FastReport Designer, copie estas bibliotecas para a pasta raiz do aplicativo, e se você usa FastReport Buriness Graphics em seu projeto, localize-as na mesma pasta do arquivo executável.

Assim, após todas estas etapas, você poderá usar os gráficos avançados do FastReport Business Graphics dentro dos relatórios gerados com FastReport .NET. Se você tiver alguma dúvida sobre a construção do plug-in FastReportBGObjects ou sobre sua conexão ao FastReport .NET, por favor entre em contato com nossa equipe de suporte.