Für die Integration von Zählerwerte aus der Software GridVis steht für den NETx BMS Server 2.0 ein Plugin zur Verfügung. Dieses Plugin ermöglicht das Abrufen des Online Werte über die GridVis REST WEB API (https://gridvis-energy.de/rest/doc/).
Installation und Lizenzierung
Die Installation des GridVis Plugins erfolgt mittels Setup. Das Setup kann hier bezogen werden.
Für das Verwenden des GridVis Plugins im NETx BMS Server muss ein entsprechender Lizenzcode freigeschaltet werden. Dieser Code ist automatisch in der Demo Lizenz freigegeben. Für gekaufte Lizenz muss das Plugin in der Lizenz aktiviert werden.
Konfiguration
Die Konfiguration des GridVis Plugins erfolgt über das NETx BMS Studio. Nach erfolgreicher Installation des GridVis Plugins erscheint im BMS Studio das Menü "GridVis".
Im GridVis Menü befinden sich 4 Einträge:
- Explorer starten: Um die Konfiguration zu vereinfachen, ist im Plugin ein Explorer Tool inkludiert. Dieses dient zum Suchen und Selektieren der GridVis Projekte, Geräte und Zählerwerte.
- Serverdefinitionen: Diese Definitionstabelle enthält alle konfigurierten GridVis Server
- Data point definitions: Diese Definitionstabelle enthält alle konfigurierten GridVis Datenpunkte
- Treiberkonfiguration: Hier können globale Einstellungen wie Timeouts vorgenommen werden
GridVis Explorer
Diese Tool dient zum Suchen und Selektieren der GridVis Projekte, Geräte und Zählerwerte. Zum Starten des Explores ist der Menüeintrag "Explorer starten ..." im Menü "GridVis" im BMS Studio auszuwählen.
Der Explorer kann nur gestartet werden, wenn der NETx BMS Server gestoppt wurde.
Im oberen Bereichen können die verschiedenen GridVis Server verwaltet werden.
Im mittleren/unteren Bereich sind die jeweiligen Datenpunkte des ausgewählten Servers konfiguriert werden. Im linken Bereich sind die Datenpunkte aufgelistet, die mittels Online Scan vom GridVis Server detektiert wurden. Im rechten Bereich sind die im BMS Server konfigurierten Datenpunkte aufgelistet.
Serververwaltung
In der Dropdown-Liste sind alle konfigurierten GridVis Server aufgelistet. Bei Auswahl eines Servers werden automatisch die für diesen Server konfigurierten Datenpunkte im rechten Bereich "Momentane Konfiguration" angezeigt.
Mittels Schaltfläche "Hinzufügen" können neue Server hinzugefügt werden. Eine Serverdefinition besteht aus einen freiwählbaren, eindeutigen Namen und der Server URL. Die Server URL kann nachträglich mittels Schaltefläche "Ändern" geändert werden.
Mittels Schaltfläche "Löschen" kann der ausgewählte Server wieder gelöscht werden.
Wird ein Server gelöscht werden auch alle definierten Datenpunkte für diesen Server gelöscht.
Datenpunkte verwalten
Im mittleren/unteren Bereich können die Datenpunkte des selektierten Servers verwaltet werden. Im rechten Bereich werden die im BMS Server momentan konfigurierten Datenpunkte für den ausgewählten Server angezeigt.
Im linken Bereich können die verfügbaren Datenpunkte des selektierten Servers angezeigt werden. Durch Auswahl der Schaltfläche "Online Scan" verbindet sich der Explorer mit dem GridVis Server und sucht nach verfügbaren GridVis Projekte, deren Geräte und Zählerwerte. Das Ergebnis wird in einer Baumstruktur dargestellt.
Je nach Projektgröße kann ein Scan mehrere Minuten daueren.
Bei den Projekten und Geräten wird zusätzlich zum Namen die Anzahl der darunterliegenden Knoten in runder Klammer angezeigt.
Oberhalb der Baumstruktur befinden sich Textfelder zum Filtern der Scanergebnisse. Dabei stehen für Projekte, Geräte und Datenpunkte (Wertetypen) getrennte Textfelder zur Verfügung. Durch Eingabe eines Textes innerhalb dieser Felder und anschließendem Betätigen der "Enter" Taste oder der Schaltfläche "Filtern" wird das Gesamtergebnis des Scans entsprechend gefiltert. Der eingegeben Text muss im entsprechenden Namen enthalten sein wobei Groß- und Kleinschreibung ignoriert wird.
Aus Performancegründen werden nur die ersten 500 Datenpunkte eines Gerätes angezeigt. Sind mehr als 500 Datenpunkte verfügbar, wird ein entsprechender Hinweis angezeigt. Um auf die anderen Datenpunkte zugreifen zu können, muss die Filterfunktion verwendet werden.
Mittels Checkbox können nun einzelne Datenpunkte selektiert werden. Wird ein Gerät oder ein Projekt ausgewählt, werden alle Unterknoten ebenfalls selektiert. Das Deselektieren funktioniert analog.
Wurden alle gewünschten Datenpunkte ausgewählt, können diese mittels Schaltfläche "Hinzufügen" zur aktuellen Konfiguration im BMS Server hinzugefügt werden. Dabei muss ein Pollingintervall (in Sekunden) definiert werden. Dieses Pollingintervall gibt an, wie oft die Werte der selektieren Datenpunkte vom GridVis Server abgefragt werden sollen.
Nach Eingabe des Pollingintervalls muss das Speichern der momentanen Datenpunktliste bestätigt werden. Die hinzugefügten Datenpunkt sind nach dem Start des NETx BMS Servers verfügbar.
Im rechten Bereich ist die momentane Datenpunktkonfiguration für den ausgewählten GridVis Server. Wird in der Dropdown-Box der ausgewählte Server geändert, wird diese Liste automatisch aktualisiert. Auch hier werden alle konfigurierten Projekte, Geräte und deren Datenpunkte (Wertetypen) in einer Baumstruktur dargestellt.