Verwendung von Daten im JSON Format in den Berichten

Früher war es problematisch, die Daten im JSON-Format in den Web-Berichten zu verwenden. Diese Lösung wurde in neuer Version 2016.2 realisiert.

Man soll sich merken, dass JSON (JavaScriptObjectNotation) ein basiertes auf JavaScript Text-Format.

Das JSON verwendet man sehr oft beim Daten Austausch zwischen dem Server und dem Browser oder zwischen den Servern. Im Vergleich zu XML ist dieses Format mehr lakonisch und es ist mehr bequem es mit JavaScript zu verwenden.

В данной статье я будет подробно описан алгоритм использования данных в формате JSON в отчете FastReport.Net. Такая возможность появилась в FastReport.Net 2016.2.

In diesem Artikel geht es um die deutliche Beschreibung vom Verwendungsbeispiel des JSON Formats im Bericht vom FastReport.Net. Solche Möglichkeit steht in den Release von 2016.2 zur Verfügung.

Zuerst braucht man den Connection-Plugin zu den JSON-Dateien, der sich im Ordner befindet C:\ProgramFiles (x86)\FastReports\FastReport.Net\Extras\Connections\FastReport.Json.

Betrachten wir jetzt alles Schritt für Schritt:

1) Öffnen Sie die Solution FastReport.Json.sln. Für erfolgreichen Build braucht man den Link auf die Bibliothek System.Data.Json.dll zu berichtigen, die sich hier befindet: C:\ProgramFiles (x86)\FastReports\FastReport.Net\Demo.

2) Um diese Bibliothek zu erhalten, soll das Projekt noch einmal kompiliert werden.

Es gibt drei Variante, den Plugin im Designer zu registrieren:

1) Registration mit Hilfe vom Berichtsdesigner:

Öffnen Sie den Berichtsdesigner. Er kann als ein Teil vom VisualStudio-Projekt oder als eine Anwendung sein;
Fügen Sie den Plagin hinzu. Das macht man im Menü: View->Options…, Tab Plugins. Klicken Sie auf die Taste „Add“ und fügen Sie früher kompilierte Bibliothek FastReport.Json.dll hinzu;

Starten Sie den Berichtseditor.

2) Machen Sie eine Registration mit der Hand in der Konfiguration-Datei FastReport:

Default soll diese Datei im Ordner sein:"C:\Documents and Settings\user_name\Local Settings\Application Data\FastReport";
Schalten Sie alle Sessions von FastReport.Net;
Öffnen Sie die Konfiguration-Datei im beliebigen Text-Editor und korrigieren Sie folgende Zeile:

<?xml version="1.0" encoding="utf-8"?>

...

</Plugins>

</Config>

1) Registrieren Sie die Bibliothek im Code des Programms:

Fügen Sie den Link auf die Bibliothek FastReport.Json.dll ins Projekt hinzu;
Führen Sie diese Codezeile einmal beim Start des Programms auf: FastReport.Utils.RegisteredObjects.AddConnection(typeof(JsonDataConnection)).

Nach der Plugins Registration registriert man die Datenquelle im Bericht. Dazu eröffnet man im Berichtsdesigner das Menü: Data->Adddatasource. Weiter startet der Data Wizard:

Klicken Sie jetzt die Taste «New connection».

Wählen Sie den Connections Typ „JSONdatabase“ für die Erstellung der Connections Zeile

Weiter wählen Sie die JSON-Datei mit den Daten. Es gibt eine Möglichkeit, dass der Datenlager auf anderem Server sein kann. In diesem Fall braucht man im Feld vom Weg zum Datenlager einen URL einsetzen. Klicken Sie „OK“.

In Data Wizard klicken Sie „Next“.

Heben Sie gewünschte Tabelle hervor. Zum Beispiel Products. Klicken Sie «Finish».

Im Datenfenster erscheint gewählte Tabelle. Fügen Sie auf dem Band „Daten“ die Felder: ProductName, UnitsInStock, UnitPrice und starten Sie den Bericht.

Es ist offensichtlich, dass die Arbeit mit einem Datenlager im JSON Format sowie mit anderer beliebigen Datenquelle sehr bequem ist. Und FastReport.Net bietet auch solche Möglichkeit.