Web-basiertes Deklarations-Tool für SmartGridready

Ein webbasiertes Tool, mit dem Produktdeklarationen und Funktionsprofile über eine geführte Oberfläche erstellt und gepflegt werden können.

Landingpage des Deklarations-Tools
Editor mit Export/Preview und XML-Struktur

Ausgangslage

SmartGridready steht für standardisierte Kommunikation zwischen Produkten, Gebäuden und dem Verteilnetz. XML-Deklarationen beschreiben dabei Kommunikationsschnittstellen und Datenpunkte von Geräten. Aktuell werden Deklarationen manuell in verschiedenen Editoren erstellt, da kein geeignetes Tool existiert, das die Komplexität des umfangreichen XML-Schemas in eine geführte, intuitive Eingabemaske übersetzt. Dadurch ist die Bearbeitung fehleranfällig und zeitaufwendig.

Zielsetzung

Ziel war die Entwicklung eines web-basierten Deklarations-Tools, das die Erstellung und Bearbeitung von SmartGridready-Produktbeschreibungen und Funktionsprofilen vereinfacht. Das Tool bietet eine intuitive Benutzeroberfläche, sodass komplexe XML-Deklarationen erstellt, bearbeitet und validiert werden können. Dadurch werden Fehler reduziert und der Deklarationsprozess beschleunigt.

Import

Auszug aus der Import-Funktion

Mit der Import-Funktion können bestehende Produktbeschreibungen oder Funktionsprofile aus der SmartGridready-Bibliothek oder aus dem lokalen Dateisystem geladen werden.

Editor

Auszug aus dem Device Editor

Der Editor ermöglicht das geführte Erstellen und Bearbeiten von Deklarationen für Geräte und Funktionsprofile.

Preview

Preview der Deklaration

Die Preview zeigt die Deklaration als formatierte HTML-Ansicht – entsprechend der Darstellung im SmartGridready-Standard.

Export

Auszug aus der Export-Funktion

Mit der Export-Funktion können bearbeitete Produktbeschreibungen oder Funktionsprofile als valide XML-Datei ins lokale Dateisystem exportiert werden – inklusive syntaktischer und semantischer Validierung.

Ergebnisse

Es ist ein funktionaler Prototyp eines web-basierten Deklarations-Tools für SmartGridready entstanden. Produktbeschreibungen und Funktionsprofile können erstellt, importiert, bearbeitet und wieder exportiert werden. Das vollständige XML-Schema wird in einer geführten Oberfläche abgebildet.

  • Schema-konforme Formulargenerierung mit vollständiger Abbildung der XML-Struktur
  • Import von XML-Deklarationen aus dem lokalen Dateisystem und aus der SmartGridready-Bibliothek
  • Export als valide XML-Datei mit Validierung (syntaktisch und semantisch)
  • Autosave: automatische Speicherung des Editor-Zustands im Browser
  • XSLT-Vorschau zur visuellen Prüfung der Deklarationen

Statt mit XML im Texteditor zu arbeiten, werden die Inhalte hinter einer klar strukturierten Eingabemaske versteckt. Die Hürde beim Erstellen und Pflegen von Deklarationen wird damit reduziert.

Technische Schlüsselbegriffe

  • SmartGridready Label für standardisierte und sichere Kommunikation zwischen Produkten, Gebäuden und Stromnetzen.
  • Produkt Ein Gerät mit energierelevanten Funktionen (z. B. Wärmepumpe, Smart Meter, PV-Wechselrichter, Ladestation), das Daten und Steuerbefehle über eine Schnittstelle bereitstellt.
  • Funktionsprofil Eine definierte Sammlung von Funktionen und Datenpunkten, die ein Produkt unterstützt (z. B. Energiemessung oder Steuerung einer Wärmepumpe).
  • Produktbeschreibung Eine maschinenlesbare Datei, die beschreibt, welche Funktionsprofile ein Produkt unterstützt und wie seine Geräteschnittstelle an die standardisierte Schnittstelle angebunden wird.
  • Datenpunkt Ein einzelner Wert oder Befehl eines Produkts, der gelesen und/oder geschrieben werden kann (z. B. Leistung, Temperatur, Betriebsmodus).
  • XML Ein strukturiertes Textformat, das Daten in Tags organisiert und dadurch gut prüfbar sowie zwischen Systemen austauschbar macht.
  • React JavaScript-Bibliothek für den Aufbau der Benutzeroberfläche mit Komponenten.
  • Zustand Leichte State-Management-Bibliothek zur Verwaltung des App-Zustands.
  • Zod Schema- und Validierungsbibliothek zur Prüfung von Formulardaten und Strukturen.
  • Shadcn/UI Wiederverwendbare UI-Komponenten (auf Tailwind-Basis) für konsistente Oberflächen.
  • Tailwind CSS Utility-First CSS-Framework für schnelles, konsistentes Styling direkt im Markup.

In Kollaboration mit

SmartGridready

SmartGridready
Albisriederstrasse 184b
8047 Zürich
smartgridready.ch

Team

Fatlum Cikaqi
Maurin Wirth

Betreuer
Jürg Luthiger
Matthias Krebs