C#でSAP Crystal ReportsからIronPDFに移行する方法

SAPクリスタルレポートを理解する

SAP Crystal Reports は、ダイナミックで"ピクセルパーフェクト"なレポートを作成するツールとして、エンタープライズ分野で際立っています。SAP Crystal Reportsは、さまざまなデータソースに接続できることが評価され、包括的なレポート機能を求める多くの企業で採用されてきました。 Crystal Reports Designer は、複雑なレポートレイアウトの作成を簡素化するツールです。

しかし、テクノロジーの進化に伴い、SAP Crystal Reports の SAP フレームワークへの依存度が高く、インストールやデプロイの要件が厳しいことも見逃せなくなっています。 重量級であるため、企業がシステムを完全に実装し、維持するには、多くのリソースと時間が必要になります。

移行する主な理由

1.大規模なインストール: Crystal Reports ランタイムは 500MB 以上あり、複雑なインストールが必要です。

2. SAPエコシステムのロックイン： SAPの価格、サポートサイクル、製品ロードマップに縛られる 3.複雑なライセンス： SAPのエンタープライズ販売プロセスによるプロセッサごと/ユーザーごとのライセンス 4.レガシーアーキテクチャ:現代の64ビット展開を複雑にする32ビットCOMの依存関係
3. .NET Coreのサポート終了:最新の.NETプラットフォームに対する限定的なサポート 6.レポートデザイナーの依存関係: Visual Studio 拡張機能またはスタンドアロンデザイナーが必要 7.パフォーマンスの低下:実行時の初期化とメモリ使用量の増加

SAP Crystal Reportsの隠れたコスト

SAP Crystal ReportsとIronPDFの比較

2025年、2026年まで.NET 10とC# 14の導入を計画しているチームにとって、IronPDFはSAP Crystal Reportsでは提供できないネイティブのクロスプラットフォームサポートを提供します。

前提条件

1. .NET 環境:.NET フレームワーク4.6.2+ または .NET Core 3.1+ / .NET 5/6/7/8/9+
2. NuGetアクセス: NuGetパッケージをインストールする機能
3. IronPDFライセンス: ironpdf.comからライセンスキーを取得します。

NuGetパッケージの変更

# Remove Crystal Reports packages
dotnet remove package CrystalDecisions.CrystalReports.Engine
dotnet remove package CrystalDecisions.Shared
dotnet remove package CrystalDecisions.ReportAppServer
dotnet remove package CrystalDecisions.Web

# Remove legacy assemblies from project references
# Install IronPDF
dotnet add package IronPdf

# Remove Crystal Reports packages
dotnet remove package CrystalDecisions.CrystalReports.Engine
dotnet remove package CrystalDecisions.Shared
dotnet remove package CrystalDecisions.ReportAppServer
dotnet remove package CrystalDecisions.Web

# Remove legacy assemblies from project references
# Install IronPDF
dotnet add package IronPdf

ライセンス構成

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

名前空間の変更

// Before: SAP Crystal Reports
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using CrystalDecisions.ReportAppServer;

// After: IronPDF
using IronPdf;

// Before: SAP Crystal Reports
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using CrystalDecisions.ReportAppServer;

// After: IronPDF
using IronPdf;

コア API マッピング

例1: HTMLからPDFへの変換

翻訳前（SAP Crystal Reports）:

// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;

class Program
{
    static void Main()
    {
        // Crystal Reports requires a .rpt file template
        ReportDocument reportDocument = new ReportDocument();
        reportDocument.Load("Report.rpt");

        // Crystal Reports doesn't directly support HTML
        // You need to bind data to the report template
        // reportDocument.SetDataSource(dataSet);

        ExportOptions exportOptions = reportDocument.ExportOptions;
        exportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
        exportOptions.ExportFormatType = ExportFormatType.PortableDocFormat;

        DiskFileDestinationOptions diskOptions = new DiskFileDestinationOptions();
        diskOptions.DiskFileName = "output.pdf";
        exportOptions.DestinationOptions = diskOptions;

        reportDocument.Export();
        reportDocument.Close();
        reportDocument.Dispose();
    }
}

// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;

class Program
{
    static void Main()
    {
        // Crystal Reports requires a .rpt file template
        ReportDocument reportDocument = new ReportDocument();
        reportDocument.Load("Report.rpt");

        // Crystal Reports doesn't directly support HTML
        // You need to bind data to the report template
        // reportDocument.SetDataSource(dataSet);

        ExportOptions exportOptions = reportDocument.ExportOptions;
        exportOptions.ExportDestinationType = ExportDestinationType.DiskFile;
        exportOptions.ExportFormatType = ExportFormatType.PortableDocFormat;

        DiskFileDestinationOptions diskOptions = new DiskFileDestinationOptions();
        diskOptions.DiskFileName = "output.pdf";
        exportOptions.DestinationOptions = diskOptions;

        reportDocument.Export();
        reportDocument.Close();
        reportDocument.Dispose();
    }
}

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        // Create a PDF from HTML string
        var renderer = new ChromePdfRenderer();

        string htmlContent = "<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>";

        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF created successfully!");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        // Create a PDF from HTML string
        var renderer = new ChromePdfRenderer();

        string htmlContent = "<h1>Hello World</h1><p>This is a PDF generated from HTML.</p>";

        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF created successfully!");
    }
}

この例は、基本的なパラダイムの違いを示しています。 SAP Crystal Reportsでは、Crystal Reports Designerで作成された.rptファイルテンプレートが必要です。その後、ExportOptions、ExportDestinationType、ExportFormatType、DiskFileDestinationOptionsを設定する必要があります。 ライブラリはHTMLコンテンツを直接サポートしていません。

IronPDFはHTML文字列を直接受け取ります: ChromePdfRendererを作成し、任意のHTMLコンテンツでRenderHtmlAsPdf()を呼び出し、SaveAs()します。 デザイナー不要、バイナリテンプレート不要、複雑なエクスポート設定不要。 包括的な例については、HTML to PDF documentationを参照してください。

例2: URLからPDFへの変換

翻訳前（SAP Crystal Reports）:

// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;
using System.Net;

class Program
{
    static void Main()
    {
        // Crystal Reports cannot directly convert URLs to PDF
        // You need to create a report template first

        // Download HTML content
        WebClient client = new WebClient();
        string htmlContent = client.DownloadString("https://example.com");

        // Crystal Reports requires .rpt template and data binding
        // This approach is not straightforward for URL conversion
        ReportDocument reportDocument = new ReportDocument();
        reportDocument.Load("WebReport.rpt");

        // Manual data extraction and binding required
        // reportDocument.SetDataSource(extractedData);

        reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf");
        reportDocument.Close();
        reportDocument.Dispose();
    }
}

// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;
using System.Net;

class Program
{
    static void Main()
    {
        // Crystal Reports cannot directly convert URLs to PDF
        // You need to create a report template first

        // Download HTML content
        WebClient client = new WebClient();
        string htmlContent = client.DownloadString("https://example.com");

        // Crystal Reports requires .rpt template and data binding
        // This approach is not straightforward for URL conversion
        ReportDocument reportDocument = new ReportDocument();
        reportDocument.Load("WebReport.rpt");

        // Manual data extraction and binding required
        // reportDocument.SetDataSource(extractedData);

        reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf");
        reportDocument.Close();
        reportDocument.Dispose();
    }
}

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        // Create a PDF from a URL
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF created from URL successfully!");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        // Create a PDF from a URL
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF created from URL successfully!");
    }
}

SAP Crystal Reports では、URLを直接 PDF に変換することはできません。 WebClient を使って HTML コンテンツを手動でダウンロードし、そのデータを何らかの方法で抽出して、あらかじめデザインされた .rpt テンプレートにバインドする必要があります。

IronPDFのRenderUrlAsPdf()メソッドは、すべてのCSS、JavaScript、画像を含む完全にレンダリングされたウェブページを一回の呼び出しで取り込みます。 詳しくは、チュートリアルをご覧ください。

例3：ページ番号を含むヘッダーとフッター

翻訳前（SAP Crystal Reports）:

// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;

class Program
{
    static void Main()
    {
        // Crystal Reports requires design-time configuration
        ReportDocument reportDocument = new ReportDocument();
        reportDocument.Load("Report.rpt");

        // Headers and footers must be designed in the .rpt file
        // using Crystal Reports designer
        // You can set parameter values programmatically
        reportDocument.SetParameterValue("HeaderText", "Company Name");
        reportDocument.SetParameterValue("FooterText", "Page ");

        // Crystal Reports handles page numbers through formula fields
        // configured in the designer

        reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf");
        reportDocument.Close();
        reportDocument.Dispose();
    }
}

// NuGet: Install-Package CrystalReports.Engine
using CrystalDecisions.CrystalReports.Engine;
using CrystalDecisions.Shared;
using System;

class Program
{
    static void Main()
    {
        // Crystal Reports requires design-time configuration
        ReportDocument reportDocument = new ReportDocument();
        reportDocument.Load("Report.rpt");

        // Headers and footers must be designed in the .rpt file
        // using Crystal Reports designer
        // You can set parameter values programmatically
        reportDocument.SetParameterValue("HeaderText", "Company Name");
        reportDocument.SetParameterValue("FooterText", "Page ");

        // Crystal Reports handles page numbers through formula fields
        // configured in the designer

        reportDocument.ExportToDisk(ExportFormatType.PortableDocFormat, "output.pdf");
        reportDocument.Close();
        reportDocument.Dispose();
    }
}

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        // Configure headers and footers
        renderer.RenderingOptions.TextHeader.CenterText = "Company Name";
        renderer.RenderingOptions.TextHeader.FontSize = 12;

        renderer.RenderingOptions.TextFooter.LeftText = "Confidential";
        renderer.RenderingOptions.TextFooter.RightText = "Page {page} of {total-pages}";
        renderer.RenderingOptions.TextFooter.FontSize = 10;

        string htmlContent = "<h1>Document Title</h1><p>Document content goes here.</p>";

        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF with headers and footers created!");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        // Configure headers and footers
        renderer.RenderingOptions.TextHeader.CenterText = "Company Name";
        renderer.RenderingOptions.TextHeader.FontSize = 12;

        renderer.RenderingOptions.TextFooter.LeftText = "Confidential";
        renderer.RenderingOptions.TextFooter.RightText = "Page {page} of {total-pages}";
        renderer.RenderingOptions.TextFooter.FontSize = 10;

        string htmlContent = "<h1>Document Title</h1><p>Document content goes here.</p>";

        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF with headers and footers created!");
    }
}

SAP Crystal Reports では、ヘッダーとフッターをデザイン時に設定する必要があります。 Crystal Reports Designer を使用して .rpt ファイルを設計し、実行時に "HeaderText" や "FooterText" などのパラメータ値を渡す必要があります。ページ番号は、デザイナーの数式フィールドで設定する必要があります。

IronPDFはTextHeaderとTextFooterプロパティでプログラムによるヘッダー/フッターの設定を提供します。 CenterText、LeftText、RightText、および FontSizeをコード内で直接設定します。 ページ番号は{page}と{total-pages}プレースホルダーを使用します。

課題1：.rptファイルの変換

SAP Crystal Reports: レイアウト、データ、数式が埋め込まれたバイナリ.rptファイル。

解決策：直接変換することはできません-HTMLとして再作成する必要があります： 1.Crystal Reports デザイナーで .rpt を開く 2.文書のレイアウト、フォント、色 3.すべての数式フィールドに注意 4.HTML/CSSで再作成 5.数式をC#コードに変換する

課題2: データベース接続

SAP Crystal Reports: 組み込み接続文字列とODBC。

ソリューション: アプリケーションのデータレイヤーを使用してください：

// Instead of Crystal's database integration
var data = await _dbContext.Orders
    .Where(o => o.Date >= startDate && o.Date <= endDate)
    .ToListAsync();

// Bind to HTML template
var html = GenerateReportHtml(data);

// Instead of Crystal's database integration
var data = await _dbContext.Orders
    .Where(o => o.Date >= startDate && o.Date <= endDate)
    .ToListAsync();

// Bind to HTML template
var html = GenerateReportHtml(data);

課題 3：ランタイム依存性

SAP Crystal Reports: Crystal Reports Runtimeのインストール（500MB以上）が必要です。

ソリューション: IronPDFは自己完結しています：

# Just add theNuGetpackage
dotnet add package IronPdf
# That's it - no additional installs needed

# Just add theNuGetpackage
dotnet add package IronPdf
# That's it - no additional installs needed

第4号:32ビット/64ビットの問題

SAP Crystal Reports: COM の依存関係には 32 ビットモードが必要なことがよくあります。

ソリューション: IronPDFはネイティブの64ビットで、特別な設定は必要ありません。

PDFマージ

var pdf1 = PdfDocument.FromFile("report1.pdf");
var pdf2 = PdfDocument.FromFile("report2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("complete_report.pdf");

var pdf1 = PdfDocument.FromFile("report1.pdf");
var pdf2 = PdfDocument.FromFile("report2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("complete_report.pdf");

PDFのセキュリティ

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(reportHtml);

pdf.MetaData.Title = "Quarterly Sales Report";
pdf.MetaData.Author = "Finance Department";

pdf.SecuritySettings.OwnerPassword = "admin123";
pdf.SecuritySettings.UserPassword = "view123";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SaveAs("secure_report.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(reportHtml);

pdf.MetaData.Title = "Quarterly Sales Report";
pdf.MetaData.Author = "Finance Department";

pdf.SecuritySettings.OwnerPassword = "admin123";
pdf.SecuritySettings.UserPassword = "view123";
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SaveAs("secure_report.pdf");

デジタル署名

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

ウォーターマーク

pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");

pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");

移行前

• すべての.rptファイルをインベントリする
• 参考のために各レポートレイアウトのスクリーンショットを撮る
• 数式フィールドと計算を文書化する
• すべてのデータソースとパラメータを一覧表示する
• 印刷要件を特定する
• ironpdf.comからIronPDFライセンスキーを取得します

コードの更新

• Crystal Reports パッケージ ( CrystalDecisions.CrystalReports.Engineなど) を削除します。
• デプロイメントからランタイムインストールを削除する
• IronPdf NuGetパッケージをインストールする
• .rptレイアウトをHTML/CSSテンプレートに変換する
• Crystal の式を C# コードに変換する
• SetDataSource()から HTML 文字列補間へのデータバインディングを更新します
• 印刷コードをPrintToPrinter()からpdf.Print()に更新します
• アプリケーションの起動時にライセンスの初期化を追加

インフラ

• サーバーからCrystal Runtimeを削除する
• デプロイメントスクリプトを更新する
• 32ビット互換モードを削除
• Dockerイメージを更新する（該当する場合）

テスティング

• PDF出力を元のレポートと比較する
• すべての計算を検証する
• すべてのパラメータをテストする
• 印刷機能のテスト
• パフォーマンステスト
• 64ビットテスト