Importação de relatórios do Crystal Reports para FastReport .NET

Usualmente, os desenvolvedores de geradores de relatórios criam seus formatos para armazenar modelos. Por exemplo, FastReport usa o formato .frx para armazenar modelos e .fpx para armazenar relatórios a serem exportados e o Crystal Reports usa arquivos .rpt.

Este artigo explicará como importar um modelo de relatório do formato RPT criado no Crystal Reports para o formato FRX, que é usado no FastReport.

Para importar modelos, você precisará do designer de relatórios de desktop. A importação é possível quando o arquivo RPT correto é aberto. Você pode adicionar esse recurso ao designer se compilar um complemento especial (plug-in). Vamos dar uma olhada em todo o processo do início ao fim.

Primeiro, baixe o projeto do plugin. Está disponível neste link na seção Add-Ons.

O link necessário é assinado como “Conversor de Crystal Reports (* .rpt) para FastReport .NET (* .frx)”. Ao clicar nele, o arquivo será baixado, que você deve descompactar em qualquer local conveniente. Em seguida, você precisa abrir o arquivo FastReport.RPTImportPlugin.sln usando o Visual Studio.

Baixe o package necessário para o trabalho do plugin. É chamado “Crystal Reports, versão para Visual Studio” e pode ser baixado neste link (registro em sap.com é necessário).

Várias opções de download serão oferecidas por meio do link. Baixe e instale o seguinte pacote, disponível nas versões de 32 e 64 bits:

• Mecanismo de runtime SAP Crystal Reports para Visual Studio (SP30) para .NET framework MSI.

Os links a seguir serão configurados no projeto FastReport.RPTImportPlugin baixado:

Exclua todos os links que mencionam FastReport e CrystalDecisions e, em seguida, adicione links para os arquivos atuais:

1) CrystalDecisions.CrystalReports.Engine.dll e CrystalDecisions.Shared.dll. Depois de instalar o pacote baixado, esses arquivos DLL estarão localizados no seguinte caminho:

C:\Windows\Microsoft.NET\assembly\GAC_MSIL\CrystalDecisions.CrystalReports.Engine
C:\Windows\Microsoft.NET\assembly\GAC_MSIL\CrystalDecisions.Shared

2) FastReport.dll, FastReport.Compat.dll e FastReport.DataVisualization.dll. TEssas DLLs estão localizadas na pasta raiz do FastReport .NET instalado. Se você não alterou o destino de instalação padrão, você pode encontrá-los aqui:

C:\Program Files (x86)\FastReports\FastReport.Net

Certifique-se de estar usando as DLLs corretas! Se você tiver várias versões do FastReport .NET instaladas, pode selecionar por engano a versão errada da DLL. O designer não reconhecerá o plugin ou não iniciará.

Your list of links will look like this after these steps:

Compile o projeto. Depois disso, vá para a pasta FastReport.RPTImportPlugin\bin\Debug e localize o arquivo FastReport.RPTImportPlugin.dll.

Abra o report designer, e selecione a aba "Plugins" no menu "Settings ..". Click no botão “Add” e selecione o arquivo FastReport.RPTImportPlugin.dll. Depois disso, você o verá na lista de plug-ins instalados:

Após adicionar o plug-in, reinicie o designer e selecione "Open ...". Depois disso, o menu de seleção de arquivo será aberto e um novo item deverá aparecer no seletor de formato de arquivo:

Atenção! Se, durante a compilação, você selecionar DLLs que não correspondem às DLLs usadas pelo designer, então:

• O Designer pode não iniciar quando você executá-lo novamente.
• O item “Crystal Reports File” não será adicionado ao menu de exportação.

In these cases, reopen the FastReport.RPTImportPlugin project, remove FastReport.dll, FastReport.Compat.dll and FastReport.DataVisualization.dll from it, add the correct DLLs and recompile the plugin.

If the designer doesn't open after replacing DLLs, double-check all other steps. If this did not help, then remove the link to the plugin from the Config file and contact our support.

The Config file is located in the following path, and contains a number of FastReport .NET settings:

…AppData\Local\FastReport

Nesses casos, reabra o projeto FastReport.RPTImportPlugin, remova FastReport.dll, FastReport.Compat.dll e FastReport.DataVisualization.dll dele, adicione as DLLs corretas e recompile o plug-in.

Se o designer não abrir depois de substituir as DLLs, verifique novamente todas as outras etapas. Se isso não ajudar, remova o link para o plug-in do arquivo de configuração e entre em contato com nosso suporte.

O arquivo de configuração está localizado no seguinte caminho e contém várias configurações do FastReport .NET:

Para remover a conexão com o plug-in, localize e remova a linha que começa com <Plugin name> e salve o arquivo. Depois disso, o designer será aberto, mas sem o plugin.
Toda a linha ficará assim:

<Plugin Name="your path to the plugin\FastReport.RPTImportPlugin.dll"/>

Observe que existem algumas limitações técnicas durante a importação. Por exemplo, as conexões de fonte de dados configuradas não serão salvas e alguns objetos serão produzidos com pequenas imprecisões. Se você não estiver satisfeito com algum aspecto da importação de modelos, entre em contato com nosso suporte técnico. Sempre nos esforçamos para aprimorar nossos produtos, inclusive melhorando a qualidade dos relatórios de importação.

Para resumir, neste momento você deve ter um plugin compilado que você adicionou ao designer do FastReport. Após essas etapas, você pode abrir arquivos RPT criados no Crystal Reports no designer FastReport .NET e salvá-los como arquivos FRX, ou seja, modelos de relatório para FastReport .NET.