5.3.1

Features

Fixes

Upgrade Hinweise von Version 5.1 auf 5.x

Beim Upgrade von einem 5.1 System auf höhere Versionen ist folgendes zu beachten:

Systemvoraussetzungen: Beachten Sie die Anforderungen an die Hard- Software.

Bei dem Upgrade wird ein neuer Lizenz-Basis-Container benötigt. Der Umzug der vorhandenen Basis- und Zählpunkts-Lizenzen erfolgt über den KBR-Service.-

Der Excel-WCF-Service und damit das Excel Add-In konnte in der Version 5.1 unter anderem Live-Daten vom Busmaster über visual energy abrufen und anzeigen. Diese Funktion wird nicht mehr unterstützt. Der WCF-Service erlaubt nur noch das Abrufen von Datenbank-Daten aus visual energy.

Bis zur Version 5.2 konnte anstatt eines Benutzertoken auch das Token einer Rolle für den Excel / WCF Zugriff verwendet werden. Mit Einführung des Keycloak Identity- und Access-Management-Service ist dies aus Sicherheitsgründen nicht mehr möglich.

Der Workflow Busmaster Datei-Import existiert nicht mehr. Dateien (EN 50160 Berichte) werden nun automatisch importiert und stehen direkt im Zählpunkt zur Verfügung.

Der Workflow ‚CSV Import - Mehrere Zählpunkte in einer Datei‘ steht noch nicht zur Verfügung, sondern wird mit einer späteren Version nachgeliefert.

Der Maintenance Dienst muss neu konfiguriert werden und verwendet nun den in der visual energy Systemkonfiguration konfigurierten Mailserver. Bei der Version 5.1 war dies eine eigene Konfigurations-Option. Hier gab es auch die Option „KBR SMTP-Server“. Diese Option wird aus Sicherheitsgründen zukünftig nicht mehr unterstützt.

Der Excel WCF-Service ist über folgende URLs verfügbar:

/Api/DataAccess.svc (SOAP)

/Api/DataAccess.svc/json (WEB/REST)

Diese Schnittstellen unterstützen nun auch OIDC-Autorisierung.

Aus Kompatibilitätsgründen ist weiterhin noch die bisherigen URLs (/api/Services/ExcelWcfService.svc) verwendbar. Diese wird aber als veraltet betrachtet und sollte durch die vorgenannten SOAP / REST ersetzt werden.

Das testweise eingeführte Beta-Feature, der Busmaster als Modbus TCP Server bleibt eine experimentelle Funktionalität und wird nicht weiterentwickelt. Für eine verlässliche Datenkommunikation zu anderen Systemen empfehlen wir weiterhin OPC UA zu verwenden.

Direktes Lesen und Schreiben im Filesystem benötigen explizit eine SMB-Freigabe. Bisher konnten einige Workflows (z.B. CSV-Export) Datei vom Filesystem lesen oder dorthin schreiben. Diese müssen einmalig angepasst werden.

Update Hinweise von Version 5.3.0 auf 5.3.1

Beim Update ist folgendes zu beachten:

Ein Sicherheits-Update von Keycloak erfordert die einmalige manuelle Änderung des Admin-Zugriffs:

  • [visual energy Server-Url] /keycloak die Administration von Keycloak aufrufen und anmelden.
  • „Manage realms" anklicken und Realm visualenergy öffnen.
  • "Clients" auswählen und anschließen Client „ve-api" öffnen.
  • In der Client Ansicht den Tab „Client scopes“ auswählen.
  • Schaltfläche „Add client scope" anklicken.
  • In der Liste „kc-admin-api" anhaken.
  • Auf „Add" klicken und "Default" auswählen.

Keycloak erlaubt keine unsicheren Anmeldungen über das http-Protokoll. Deshalb wurde diese Option auch beim Excel-Add In entfernt.