月次口座明細書をPDF文書として生成する

静的および手動の文書提供の問題

保険契約者が現在の声明ページを求めて電話をかけたり、銀行顧客がサポートチケットを開いて3か月の明細書を要求したりすると、その要求はスタッフメンバーのデスクにたどり着きます。 その人がシステムをクエリし、ドキュメントをフォーマットし、メールで返信することがあります。場合によっては同じ日、場合によっては48時間後に。 数千の顧客にわたって、そのワークフローはスケールしません。それが処理するすべての要求は、セルフサービスポータルがなければ不要になっていたはずのものです。

組織が目指す代替手段は、1 つの問題を別の問題と交換することが多いです。 毎晩スケジュールで各顧客に対して PDF を事前生成 することで、ダウンロードされることのない文書の山を生み出し、そのすべては基礎となるデータが変わり次第すぐに古くなります。 支払い方法を更新するか、カバレッジ層を変更した顧客は、アカウントを反映しなくなった PDF をダウンロードし、サポートに問い合わせることもあります。

サードパーティの文書生成 API は、オンデマンドレンダリングを提供しますが、ポータルトラフィックと直接比例する一リクエストあたりのコストを追加し、ネットワーク依存性がユーザー向けのアクションの重要なルートに存在します。 月に200,000件の明細書ダウンロードを送信する銀行ポータルは、それを計量される API で行いたくありません。

ユーザーの期待はシンプルです: "PDF をダウンロード"ボタンが、今、適切なドキュメントを生成します。 保険契約者が声明ページをダウンロードする、公益事業の顧客が最新の請求書を引き出す、SaaS 管理者が現在のサブスクリプションレポートをエクスポートする、通信顧客が通話詳細記録をダウンロードする、そのすべての人は、待機列の要求ではなく、即時の結果を期待します。

解決策: API エンドポイント内でのオンデマンドレンダリング

IronPDF は .NET Web アプリケーションが コントローラアクション または最小限 API エンドポイント内でオンデマンドで PDF ファイルを生成することを可能にします。 ユーザーが"PDF をダウンロード"をクリックすると、サーバがデータベースからライブデータを引き出し、HTML テンプレートを埋め、ChromePdfRenderer がメモリ内で PDF コンテンツをレンダリングします。 応答はファイルをダウンロードとしてブラウザに直接送信し、事前生成は行わず、古いファイルはなく、サポートキューもありません。

ドキュメントは、リクエストの正確な瞬間におけるユーザのアカウントデータを反映しています。レンダリングは、既存の .NET アプリケーション内で単一の NuGet パッケージとして実行され、外部プロセスはなく、呼び出すドキュメント API もなく、維持するサイドカーサービスもなく、トラックする必要のある一ダウンロードあたりのコストもありません。

これは C＃ の PDF ワークフロ用 NuGet ライブラリであるため、NuGet Package Manager を使用して IronPDF を簡単にインストールできます。 主な機能に PDF 生成、新規および既存の PDF ファイルの変更ツール、デジタル署名やパスワードなどのセキュリティ適用、さらに詳細を含む IronPDF は、プロジェクトに追加するのに素晴らしいツールです。

実際の使用方法

using IronPdf;

[HttpGet("portal/documents/statement")]
[Authorize]
public IActionResult DownloadStatement([FromQuery] string period)
{
    var userId = User.GetUserId();
    var data = _accountService.GetStatementData(userId, period);

    string html = $@"
        <h1>Account Statement — {data.Period}</h1>
        <p><strong>Account:</strong> {data.AccountNumber}</p>
        <p><strong>Name:</strong> {data.CustomerName}</p>
        {data.LineItemsHtml}
        <p><strong>Closing Balance:</strong> {data.ClosingBalance:C}</p>";

    var renderer = new ChromePdfRenderer();

    renderer.RenderingOptions.MarginTop = 20;

    renderer.RenderingOptions.MarginBottom = 20;

    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    return File(pdf.BinaryData, "application/pdf",
        $"Statement-{data.Period}-{data.AccountNumber}.pdf");

}

using IronPdf;

[HttpGet("portal/documents/statement")]
[Authorize]
public IActionResult DownloadStatement([FromQuery] string period)
{
    var userId = User.GetUserId();
    var data = _accountService.GetStatementData(userId, period);

    string html = $@"
        <h1>Account Statement — {data.Period}</h1>
        <p><strong>Account:</strong> {data.AccountNumber}</p>
        <p><strong>Name:</strong> {data.CustomerName}</p>
        {data.LineItemsHtml}
        <p><strong>Closing Balance:</strong> {data.ClosingBalance:C}</p>";

    var renderer = new ChromePdfRenderer();

    renderer.RenderingOptions.MarginTop = 20;

    renderer.RenderingOptions.MarginBottom = 20;

    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    return File(pdf.BinaryData, "application/pdf",
        $"Statement-{data.Period}-{data.AccountNumber}.pdf");

}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<HttpGet("portal/documents/statement")>
<Authorize>
Public Function DownloadStatement(<FromQuery> period As String) As IActionResult
    Dim userId = User.GetUserId()
    Dim data = _accountService.GetStatementData(userId, period)

    Dim html As String = $"
        <h1>Account Statement — {data.Period}</h1>
        <p><strong>Account:</strong> {data.AccountNumber}</p>
        <p><strong>Name:</strong> {data.CustomerName}</p>
        {data.LineItemsHtml}
        <p><strong>Closing Balance:</strong> {data.ClosingBalance:C}</p>"

    Dim renderer As New ChromePdfRenderer()

    renderer.RenderingOptions.MarginTop = 20

    renderer.RenderingOptions.MarginBottom = 20

    Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

    Return File(pdf.BinaryData, "application/pdf", $"Statement-{data.Period}-{data.AccountNumber}.pdf")
End Function

var dataHash = _accountService.GetStatementDataHash(userId, period);

string cacheKey = $"statement/{userId}/{period}/{dataHash}";

byte[] pdfBytes = await _cache.GetAsync(cacheKey);

if (pdfBytes == null)
{
    var renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    pdfBytes = pdf.BinaryData;

    await _cache.SetAsync(cacheKey, pdfBytes,
        new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(24)
        });
}

return File(pdfBytes, "application/pdf", $"Statement-{period}.pdf");

var dataHash = _accountService.GetStatementDataHash(userId, period);

string cacheKey = $"statement/{userId}/{period}/{dataHash}";

byte[] pdfBytes = await _cache.GetAsync(cacheKey);

if (pdfBytes == null)
{
    var renderer = new ChromePdfRenderer();
    PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

    pdfBytes = pdf.BinaryData;

    await _cache.SetAsync(cacheKey, pdfBytes,
        new DistributedCacheEntryOptions
        {
            AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(24)
        });
}

return File(pdfBytes, "application/pdf", $"Statement-{period}.pdf");

Imports System
Imports System.Threading.Tasks
Imports IronPdf

Dim dataHash = _accountService.GetStatementDataHash(userId, period)

Dim cacheKey As String = $"statement/{userId}/{period}/{dataHash}"

Dim pdfBytes As Byte() = Await _cache.GetAsync(cacheKey)

If pdfBytes Is Nothing Then
    Dim renderer As New ChromePdfRenderer()
    Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

    pdfBytes = pdf.BinaryData

    Await _cache.SetAsync(cacheKey, pdfBytes, New DistributedCacheEntryOptions With {
        .AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(24)
    })
End If

Return File(pdfBytes, "application/pdf", $"Statement-{period}.pdf")

実世界の利点

常に最新。 ドキュメントはリクエストの瞬間にライブデータから生成されます。データの変更と文書コンテンツの間に同期ラグはありません。アカウント情報を更新した顧客は、それを即座に反映した PDF をダウンロードします。

ゼロサポートオーバーヘッド。 自分のポリシー、ステートメント、またはレターをダウンロードできる顧客は、それらを要求するチケットを開きません。 ダウンロードボタンは、リクエストごとに時間がかかるサポートワークフローの代わりをします。

ストレージの肥大化はありません。 PDF はオンデマンドで生成され、ブラウザにストリームされます。 各請求サイクルにわたってすべての顧客のために文書を事前生成して保存する必要はなく、ストレージコストは顧客ベースと共にスケールしません。

迅速な応答時間。 ChromePdfRenderer は、単一ページのステートメント、ポリシーサマリー、支払い領収書など、通常のポータル文書をミリ秒単位で生成します。 ユーザーは進捗インジケーターではなく、ほぼ瞬時のダウンロードを体験します。

ブランドの一貫性。 すべての文書タイプには承認された HTML および CSS テンプレート があります。 ダウンロードされるすべての PDF には、ロゴ、タイポグラフィ、レイアウト、法的免責事項が同じように含まれており、どのエンドポイントがリクエストを処理したか、いつ生成されたかに関係なく、同じです。

一文書あたりのコストはありません。 レンダリングは Web アプリケーション内でプロセス内で実行されます。 サードパーティ API の計測はなく、使用量に基づく価格設定もなく、ポータルトラフィックに伴って増加するインフラストラクチャ請求に項目出しされることもありません。

結び

オンデマンドの PDF ダウンロードは、過剰な影響を持つ小さな機能です。 それは完全にサポートリクエストのクラスを排除し、古いドキュメントに基づいて行動するリスクを排除し、手動の配信ワークフローを数百ミリ秒しかかからない自動化されたものに置き換えます。

実装は、単一のコントローラアクション、データベースクエリ、HTML テンプレート、レンダリングコール、ファイルレスポンス内に収まります。 IronPDFは、C#でのPDF生成のライフサイクル全体を、ironpdf.comで処理し、HTMLテンプレートのレンダリングからドキュメントの保存、ストリーミング、操作までを行います。 無料の 30 日間トライアル を活用することで、自身のポータルとデータに対してオンデマンドダウンロードエンドポイントを構築しテストするのに十分な時間があります。