Quick start

Um zu starten, erstellen oder öffnen Sie ein TwinCAT HMI-Projekt.

Installation

Installieren Sie das NuGet-Paket „Beckhoff.TwinCAT.HMI.Reporting“ über den NuGet Package Manager.

Um die Reporting Extension nutzen zu können wird der TwinCAT Reporting Server benötigt (TwinCAT.XAR.ReportingServer). Installieren Sie diesen mittels TcPkg, falls nicht vorhanden.

Konfigurieren der Reporting Extension

1. Öffnen Sie die Konfigurationsseite der Reporting Erweiterung in Visual Studio oder separat im Browser.

2. Gehen Sie zum Reiter Reporting.

Hier können Sie die Konfiguration der Reporting Extension vornehmen.

Im Bereich Allgemein wird die Grundkonfiguration des Reports vorgenommen.

Erstellen einer neuen Runtime:

1. Passen Sie die Verbindung der vorhandenen Runtime an oder erstellen Sie eine neue.

2. Verbinden Sie diese zu einem TwinCAT Reporting Server, über die AMS Net Id des Zielsystems. Handelt es sich um einen externen TwinCAT Reporting Server, achten Sie auf die Router Konfiguration.

3. Erstellen Sie eine neue Konfiguration.

4. Tragen Sie den gewünschten Namen ein.

Hiermit haben Sie eine Grundkonfiguration für den Reporting Server erstellt.

Erstellen eines neuen Reports:

1. Erstellen Sie einen neuen Report.

2. Geben Sie den gewünschten Namen ein und verbinden Sie den Report mit einer dazugehörigen Runtime und Konfiguration.

3. Erstellen Sie unter Textfelder einen neuen Eintrag.

4. Geben Sie einen Namen und das auszulesende Symbol an.

Hiermit haben Sie eine Grundkonfiguration zum Erstellen eines Reports erstellt. Den Report können Sie jederzeit um Elemente wie Tabellen, Textfelder oder HTML-Container erweitern.

	Um ein Report zu erstellen, muss mindestens ein Textfeld, Tabelle oder HTML-Element im Report enthalten sein.

	Das Erstellen des PDF erfolgt direkt nach dem Aufbau der HTML-Seite. Alles Zeitverzögerte führt zu einer fehlerhaften Anzeige. Beispiel: Sind CSS-Animationen im Hintergrund vorhanden, könnten diese bis zum Zeitpunkt der PDF-Erstellung noch nicht abgeschlossen sein. Dies führt dazu, dass ein Bild entsteht, zu irgendeinem Zeitpunkt während der Animation, welches nicht dem Endergebnis entspricht. Dieses Verhalten ist z. B. bei der Einbindung von Charting-Bibliotheken mit Animation zu finden.

Erzeugen einer Report Datei (HTML, PDF, JSON)

Im Bereich Benutzerdefinierte Konfiguration haben Sie die Möglichkeit, einen Report zu erstellen.

1. Wählen Sie unter Reports die Laufzeit des TwinCAT Reports Servers aus auf dem Sie den Report erstellen möchten.

2. Wählen Sie unter Report-Generierung den zu erstellenden Report aus.

3. Klicken Sie auf den Button Erstellen in der Gruppe Report-Generierung.

Der Report wird erzeugt und unter Letzter Report als HTML-Datei angezeigt, sofern diese konfiguriert wurde. Ist kein „Exportpfad“ eingestellt finden Sie die Dateien auf dem Reporting Server System unter
C:\Program Files (x86)\Beckhoff\TwinCAT\Functions\Reporting-Server\Reports.