BTC Netzportal
ZEREZ Anbindung
Ablauf / Prozess
Für die korrekte Verwendung der ZEREZ Daten ist es notwendig die nötigen Benutzerdaten für die ZEREZ Schnittstelle anzugeben. In der Konfiguration vom Kundenmarktplatz können die nötigen Daten hinterlegt werden.
Um ZEREZ Schnittstelle zu verwenden benötigen Sie einen Benutzer bei ZEREZ und müssen einen API-Schlüssel generieren, damit Sie die nötigen Benutzerdaten erhalten. (Client-ID & Client-Secret (Geheimnis))
Für die Konfiguration navigieren Sie in den Administrativen Bereich in den Globalen Einstellungen.
Wenn Sie an das untere Ende der Seite navigieren finden Sie einen Bereich mit dem Namen "Zentralen Register für Einheiten- und Komponentenzertifikate (ZEREZ)".
In diesem Bereich können Sie die Benutzerdaten für ZEREZ hinterlegen.

Verbindung Prüfen
Hier können Sie mit einem Klick prüfen ob bereits Daten hinterlegt sind, bzw. falsche Daten hinterlegt wurden.
Nach Klick ändert sich der Status entweder auf "Verbindung aktiv" oder "Verbindung fehlgeschlagen"
Zugangsdaten hinzufügen/aktualisieren
Über diese Einstellung können Sie entscheiden ob die ZEREZ Daten beim Klick auf "Einstellungen speichern" zusätzlich zu den Globalen Einstellungen gespeichert werden sollen.
Wenn Ja
Es erscheinen zwei neue Felder, die Client-ID und das Client-Secret (Geheimnis). Die nötigen Informationen woher Sie die Daten bekommen können SIe dem Hilfetext entnehmen. Grunsätzlich erhalten Sie die Daten in Ihrem ZEREZ Benutzermenü.
Nachdem beide Felder befüllt wurden können die Einstellungen gespeichert werden. Beim Speichern wird geprüft ob die eingegebene Client-ID und das eingegebene Client-Secret zueinander passen.
Wenn valide Daten eingegeben wurden wird eine positive Rückmeldung ausgegeben.
Wenn ein Fehler aufgetreten ist öffnet sich ein Dialog, welcher auf den Fehler hinweist.
Wichtig: Wenn beim Speichern der ZEREZ Daten ein Fehler aufgetreten ist, jedoch der Prozess der Globalen Einstellungen in Ordnung war, dann werden die Globalen Einstellungen dennoch gespeichert.
Wenn Nein
Die ZEREZ Daten werden beim Speicherprozess nicht berücksichtigt und werden nicht hinzugefügt oder aktualisiert.
Damit ist die Konfiguration der ZEREZ Schnittstelle abgeschlossen. Im nächsten Schritt möchten wir die Daten aus ZEREZ erhalten und diese im Produkt verwenden.
Die ZEREZ Daten werden jede Nacht aktualisert und in einer lokalen Datenbank gehalten.
Dafür verwenden wir unsere Datenquellen. Diese können Sie in der Kundenmarktplatz Konfiguration einsehen.
Die in diesem Fall wichtige Datenquelle heißt "ZEREZ_DATA". Sollten Sie diese Datenquelle nicht auf Ihrem System finden, dann wenden Sie sich bitte an den Support.
Die Datenquelle ist für Sie nicht anpassbar. Sie können hier nur das Protokoll verfolgen um zu sehen ob es zu Fehlern bei der Aktualisierung gekommen ist.
Die ZEREZ Daten können nach der ersten Aktualisierung im Feld "ZerezGeraete" verwendet werden.
Aktuell werden nachfolgende Daten ausgelesen und zur Verfügung gestellt.
- Hersteller
- Gerätename
- Zertifikatsstatus
- Maximale Wirkleistung
- Maximale Scheinleistung
- ZEREZ ID
- Bemessungswirkleistung
Falls noch weitere Daten benötigt werden, wenden Sie sich bitte an unseren Support.
Ablauf / Prozess
Konfiguration
Feld kann wie jedes Generische Feld Konfiguriert werden mit Titel, Hilfe und Hinweistexten.
Zudem kann man für beide Auswahlfelder im Frontend eine Beschriftung und Pflicht vergeben.
Des weiteren lässt sich eine Datenanzeige pflegen welche die Daten aus der Schnittstelle die jeweils zu den Modellen vorhanden ist darstellt.
Diese Tabelle wird im Frontend erst angezeigt wenn Hersteller und Modell gewählt wurden.
Sichtbarkeiten sind wie bei allen anderen Generischen Feldern konfigurierbar.
Kundenmarktplatz
Nach Auswahl von Hersteller und Modell wird, wie konfiguriert die Tabelle mit den Daten angezeigt zum Modell.
Diese können ggf. reduziert dargestellt werden, da die einzelnen Spalten eine Sichtbarkeitssteuerung auf den Wert haben, es gibt durchaus Modelle die nicht alle Werte gepflegt haben.





