Erstellen einer Bericht aus einer ASP.NET Core Anwendung mit FastReport.Core.Skia

Zuvor haben wir beschrieben, wie man einen Bericht aus einer ASP.NET Core Anwendung generiert, aber nicht alle Benutzer verwenden das Windows-Betriebssystem oder die GDI+-Grafik-Engine (aufgrund des instabilen Betriebs). Wir haben speziell für diese Benutzer eine Sonderversion von FastReport.Core entwickelt, die Skia und seinen Wrapper für .NET – SkiaSharp als Grafik-Engine verwendet. Der vollständige Name des Pakets lautet FastReport.Core.Skia. Die Pakete FastReport.Core.Skia und FastReport.Web.Skia sind auf unserem privaten NuGet-Server verfügbar.

Die wichtigsten Vorteile von FastReport.Core.Skia sind:

• Korrekter PDF-Export von RTL-Texten unter Linux;
• Korrekter PDF-Export von einigen östlichen Sprachen unter Linux;
• Korrekter HTML-Export unter Linux.

Lesen Sie mehr über die Vorteile von FastReport.Skia in diesem Artikel.

Erstellen eines Berichts bzw. einer Anwendung unter Windows

Der Prozess der Berichtserstellung ist einfach. Sie müssen einen Bericht im Designer erstellen und ihn in der ASP.NET Core-Anwendung ausführen. Als Beispiel verwenden wir die bekannte Standardvorlage “Simple List”.

Hier verfügen wir über eine fertige Vorlage, die nun über eine ASP.NET Core-Anwendung in der Web Preview angezeigt werden muss. Beginnen Sie mit der Erstellung einer Anwendung.

Als Ergebnis haben Sie das Projekt erfolgreich erstellt. Als Nächtstes werden erforderliche Nuget-Pakete hinzugefügt, nämlich FastReport.Core.Skia und FastReport.Web.Skia. In diesem Artikel wird die Methode zum Verbinden von Paketen aus einem privaten NuGet-Server beschrieben.

Die erforderlichen Pakete wurden installiert. Aktivieren Sie nun FastReport in der Datei Programme.cs.

var builder = WebApplication.CreateBuilder(args);
…
app.UseFastReport();
…
app.Run();

Der nächste Schritt ist die Bearbeitung der Index() Methode in HomeController.cs.

public IActionResult Index()
 {
 var report = new WebReport();
 var data = new DataSet();
 data.ReadXml($"C:/Users/User/Documents/nwind.xml"); 
 report.Report.RegisterData(data);
 report.Report.Load($"C:/Users/User/Documents/Simple List.frx");
 ViewBag.WebReport = report;
 return View();
 }

Jetzt müssen Sie nur noch die Ansicht konfigurieren. Dazu müssen Sie lediglich den folgenden Code in der Datei index.cshtml belassen.

@await ViewBag.WebReport.Render()

Unsere Anwendung ist fertig! Wir können sie ausführen und das Ergebnis sehen.

Wie Sie vielleicht bemerkt haben, ist der Prozess der Projekterstellung im Vergleich zum FastReport.Core-Paket fast derselbe. Alles, was Sie tun müssen, ist ein weiteres NuGet-Paket herunterzuladen.

Erstellen eines Berichts bzw. einer Anwendung unter Linux

Erstellen Sie nun ein ASP-Projekt unter Linux und zeigen den Bericht darin an.

Achtung! Stellen Sie sicher, dass Sie die erforderlichen Pakete heruntergeladen und mindestens VSCode installiert haben, um .NET-Projekte auszuführen. Zudem muss der VSCode selbst konfiguriert werden, d.h. die C#-Erweiterung muss installiert werden und der private NuGet-Server muss verbunden werden.

Nachdem Sie .NET heruntergeladen und den VSCode installiert haben, erstellen Sie ein Projekt. Als Nächstes verbinden Sie die NuGet Pakete FastReport.Core.Skia und FastReport.Web.Skia. Im Gegensatz zu Windows benötigen Sie noch zwei weitere Skia-Pakete: SkiaSharp.NativeAssets.Linux und HarfBuzzSharp.NativeAssets.Linux. So sollte die Liste der installierten NuGet-Pakete aussehen.

Die Pakete wurden installiert, jetzt können Sie das Projekt starten. Geben Sie zunächst den folgenden Befehl ein:

dotnet build

Geben Sie anschließend den folgenden Befehl ein:

dotnet run

Folgen Sie dem lokalen Link und prüfen Sie den Bericht im Browser.

Der Prozess der Projekterstellung mit FastReport.Core.Skia ist eigentlich recht einfach und in gewisser Weise “konventionell”. Alles, was Sie tun müssen, ist, zusätzliche Pakete für Linux zu verbinden. Im Gegenzug erhalten Sie eine verbesserte Anzeige einiger Texte, Symbole östlicher Sprachen in Exporten, die vielleicht bei der Verwendung von GDI+ nicht der Fall war. Außerdem empfehlen wir Ihnen als Linux-Benutzer, die Skia-Engine für das Rendering zu verwenden.