EDA
Der EDA Adapter verbindet OctoMesh mit EDA (Energiewirtschaftlicher Datenaustausch), dem österreichischen Datenaustausch zwischen Marktteilnehmern wie Netzbetreibern, Energiegemeinschaften und Dienstleistern. Der Adapter kommuniziert nicht direkt mit dem EDA-Netz: Er tauscht XML-Nachrichten (ebUtilities-Schemas) mit dem HttpAdapter eines Ponton X/P Messengers aus, der den Transport (KEP) zu den anderen Marktteilnehmern übernimmt.
Mit dem Adapter können Pipelines
- EDA-Nachrichten vom HttpAdapter empfangen und auswerten (Statusmeldungen, Zählpunktlisten, Verbrauchsdaten),
- EDA-Marktprozesse starten (z. B. einen Zählpunkt bei einer Energiegemeinschaft anmelden oder Verbrauchsdaten anfordern) und
- Benachrichtigungen (
CPNotification) als Antwort auf empfangene Nachrichten senden.
Die vom Adapter unterstützten Marktprozesse und ihre Verwendung in der Energiegemeinschafts-Lösung sind im Benutzerhandbuch unter Energiegemeinschaften – Externe Integrationen beschrieben.
Informationstabelle
| Feld | Beschreibung |
|---|---|
| Docker-Image | meshmakers/octo-communication-adapter-eda |
| Helm-Chart | octo-eda-adapter |
| Alternatives Installationsszenario | - |
| Adapter-Konfiguration | JSON-Objekt EdaHttpAdapter mit der Verbindung zum Ponton X/P HttpAdapter, siehe Adapter-Konfiguration |
Adapter-Konfiguration
Die Adapter-Konfiguration enthält die Verbindung zum HttpAdapter des Ponton X/P Messengers. Sie wird beim Start des Adapters angewendet und erneut, sobald die Konfiguration zur Laufzeit aktualisiert wird (z. B. Update Configuration in Refinery Studio); laufende Pipelines verwenden die neuen Werte ab ihrer nächsten Ausführung, ein Neustart ist nicht nötig.
{
"EdaHttpAdapter": {
"Host": "https://ponton-messenger.example.com:8441",
"User": "http-adapter-user",
"Password": "********",
"IsSimulationMode": false
}
}
| Property | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
Host | string | Ja | - | Basisadresse des HttpAdapters |
User | string | Ja | - | Benutzer des HttpAdapters (Basic Authentication) |
Password | string | Ja | - | Passwort des HttpAdapter-Benutzers |
IsSimulationMode | bool | Nein | false | Bei true werden ausgehende Nachrichten mit dem Dokumentmodus SIMU statt PROD gesendet (EDA-Testnachrichten) |
Die Property-Namen der Adapter-Konfiguration unterscheiden Groß- und Kleinschreibung und werden in PascalCase geschrieben. Eine Konfiguration ohne Host, User oder Password kann nicht gelesen werden und wird abgewiesen.
Die Nodes, die mit dem HttpAdapter kommunizieren (EdaReceiver@1, EdaStartProcess@1 und SendNotification@1), haben eigene optionale Properties host, user, password und isSimulationMode. Jede am Node gesetzte Property überschreibt den entsprechenden Wert der Adapter-Konfiguration nur für diesen Node; nicht gesetzte Properties fallen auf die Adapter-Konfiguration zurück.
Nodes
Extract-Nodes
| Node | Beschreibung |
|---|---|
| EdaReceiver@1 | Empfängt EDA-Nachrichten vom HttpAdapter des Ponton X/P Messengers |
| EdaReceiverSimulation@1 | Liest EDA-Nachrichten aus XML-Dateien statt vom HttpAdapter (Entwicklung, Tests) |
Transformations-Nodes
| Node | Beschreibung |
|---|---|
| EdaParseMessage@1 | Wertet eine gespeicherte EDA-Statusmeldung zu einer EdaMessageInfo aus (Prozessergebnis, Zählpunkte) |
| ExtractProcesses@1 | Reduziert eine Liste von EdaMessageInfo-Objekten auf die neueste Nachricht je Prozess |
| SplitConsumptionRecord@1 | Teilt lange Verbrauchsdaten-Nachrichten (DATEN_CRMSG) in Abschnitte mit maximaler Dauer |
| ParseConsumptionRecord@1 | Wertet Verbrauchsdaten zu Energiedaten aus, ein Eintrag je Zählwerk (Meter Code) |
| AggregateConsumptionRecord@1 | Wertet Verbrauchsdaten aus und aggregiert die Mengen zu Tageswerten |
| FilterEnergyData@1 | Behält je Zählpunkt und Zeitraum nur die neuesten Energiedaten |
| SearchExistingEnergyQuantities@1 | Findet gespeicherte Energiemengen, die sich mit neuen Energiedaten überschneiden |
| CreateMeteringPointData@1 | Erzeugt Zählpunktdaten aus einer ECMPList-Nachricht |
| CreateMeteringPointUpdate@1 | Entscheidet, ob ein Zählpunkt angelegt oder welche bestehende Entität aktualisiert wird |
| ExportMeasurementsToCsv@1 | Exportiert Messwerte von Zählpunkten als CSV |
Load-Nodes
| Node | Beschreibung |
|---|---|
| EdaStartProcess@1 | Startet (oder plant) einen EDA-Marktprozess und sendet die Anfragenachricht |
| SendNotification@1 | Sendet eine CPNotification an einen Marktteilnehmer |
API-Referenz
Die Konfigurationsklassen aller Nodes und die Datentransferobjekte (z. B. EdaProcessInfo, EdaClientResult, EdaMessageInfo, EnergyData) sind in der API-Referenz des EDA Adapters dokumentiert.
Alle Nodes, die mit general availability gekennzeichnet sind, sind im EDA Adapter verfügbar.