NETReporter

Moderní knihovna pro generování PDF reportů z JSON šablon

🚀 Instalace

dotnet add package NETReporter

📋 Použití

using NetReporter;

// Registrace služeb
services.AddNetReporter();

// Generování reportu
var renderer = serviceProvider.GetRequiredService<IReportRenderer>();
var pdfBytes = await renderer.RenderAsync(templateJson, dataJson);

// Uložení do souboru
await File.WriteAllBytesAsync("report.pdf", pdfBytes);

Strukturovaný JSON výstup pro automatické kontroly

var renderer = new ReportRenderer();
await using var jsonStream = await renderer.RenderAsync(
	templateStream,
	dataStream,
	new RenderOptions { Format = RenderFormat.Json });

Výstup RenderFormat.Json je určený pro strojové/AI validace parseru a runtime renderingu:

• obsahuje sekce (pageHeader, reportHeader, content, reportFooter, pageFooter),
• obsahuje vyrenderované hodnoty uzlů (po vyhodnocení bindingů),
• pro Image, Barcode a Code2D obsahuje placeholder metadata (source, sourceType, requestedFormat, resolvedFormat, availability, availabilityReason),
• pro Chart obsahuje vyhodnocená data grafu (categories, series[].values, barvy).

Grafy

Uzel Chart vykreslí sloupcový, pruhový, čárový, plošný, koláčový nebo donut graf nad kolekcí dat:

{
  "type": "Chart",
  "chartType": "Column",
  "source": "$.Months",
  "as": "m",
  "category": "{{m.Month}}",
  "series": [
    { "name": "2025", "value": "m.Revenue" },
    { "name": "2024", "value": "m.RevenuePrev" }
  ],
  "valueAxis": { "format": "N0" }
}

Grafy se kreslí vektorově (SVG) pomocí knihovny OxyPlot.Core (čistě managed, bez nativních závislostí). Popis všech vlastností je v dokumentaci formátu šablon (kapitola Chart).

SVG výstup

var renderer = new ReportRenderer();
await using var svgStream = await renderer.RenderAsync(
	templateStream,
	dataStream,
	new RenderOptions { Format = RenderFormat.Svg });

Výstup RenderFormat.Svg je určený pro lehký vizuální náhled, automatizované porovnávání struktury a integrace, kde je preferovaný vektorový formát.

✨ Funkce

• ✅ Deklarativní JSON šablony pro definici PDF reportů
• ✅ Dynamické vyhodnocování dat pomocí C# výrazů
• ✅ Podpora tabulek, grafů (sloupcové, pruhové, čárové, plošné, koláčové), obrázků a čárových kódů
• ✅ QR kódy a různé typy čárových kódů (EAN, Code128, atd.)
• ✅ SVG obrázky s automatickým fallbackem
• ✅ FlexibilníLayoutEngine pro složité rozvržení
• ✅ Validace šablon pomocí JSON Schema

📚 Dokumentace

Kompletní dokumentaci k šablonám a API najdete v dokumentaci projektu.

🔧 Požadavky

• .NET 10.0 nebo vyšší

📝 Licence

Copyright © PeNo

Pro více informací, příkladů a pokročilé použití navštivte repozitář projektu.