Reports.Web 1.0.0

Reports.Web

Reports.Web for .NET (C#) — 帳票定義（.prepdj）に値を入れて印刷データ（PREPEJ）を作り、Reports.Web エンジン（C++ WebAssembly）で PDF にします。請求書・見積書・納品書・宛名ラベル・名刺など、日本の業務帳票向けです。

Build print data (PREPEJ) from a report definition (.prepdj) and render it to PDF with the Reports.Web engine (C++ WebAssembly). Designed for Japanese business forms: invoices, estimates, delivery slips, address labels, business cards.

• 製品サイト / Product: https://www.pao.ac/reports.web/
• サンプル / Samples: https://github.com/ReportsWeb/wasm-dotnet
• オンラインデモ / Live demo: https://www.pao.ac/demo/reports.web/samples/dotnet/

しくみ / How it works

your .NET app ──(PREPEJ JSON)──▶ Reports.Web engine (Docker: ghcr.io/reportsweb/engine) ──▶ PDF
      ▲
 report definition (.prepdj) designed in the browser designer

帳票のデザインは、ブラウザで動くデザイナーで作ります。アプリは値を入れて印刷データを作り、エンジンに送るだけです。描画はすべてエンジンが行います。

インストール / Install

dotnet add package Reports.Web
docker run -d -p 3107:3107 ghcr.io/reportsweb/engine:1.0.0

.NET 8 以降。エンジンは Docker イメージで動きます。 Requires .NET 8 or later. The engine runs as a Docker image.

使い方 / Quick start

using System.Text.Json.Nodes;
using Pao.Reports.Web;

var definition = JsonNode.Parse(File.ReadAllText("quick-report.prepdj"))!.AsObject();

var printData = new PrintData()
    .SetDefinition(definition)
    .PageStart()
    .SetValue("Title", "C#/.NETから、あっという間に帳票出力")
    .SetValue("CustomerName", "株式会社パオ")
    .PageEnd();

using var engine = new ReportsWebEngine("http://127.0.0.1:3107");
File.WriteAllBytes("report.pdf", await engine.RenderPdfAsync(printData));

API

PrintData

ReportsWebEngine

エラーは ReportsWebEngineException（StatusCode に HTTP ステータス）で返ります。 Errors are thrown as ReportsWebEngineException with the HTTP StatusCode.

体験版と製品版 / Trial and product

このパッケージとエンジンのイメージは体験版です。出力には赤い「SAMPLE」の印が付きます。ご購入後に納品するライセンスファイルをエンジンに設定すると、印が消えます。

The package and the engine image are trial builds: output carries a red "SAMPLE" mark. Mount the license file delivered on purchase to remove it:

docker run -d -p 3107:3107 -v /path/to/reports-web.license:/app/reports-web.license:ro ghcr.io/reportsweb/engine:1.0.0

開発用パソコン 1 台につき 1 ライセンス、運用環境はランタイムライセンスフリーです。詳しくは LICENSE.md と 使用許諾 をご覧ください。

他の言語 / Other languages

Reports.Web は同じ帳票定義と印刷データを、PHP・Java・.NET・Go・Ruby・Rust・Node.js から使えます。Pure Java・WPF 版もあります。 https://github.com/ReportsWeb

Pao@Office — https://www.pao.ac/ — info@pao.ac