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).

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ů, 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.