EDA
The EDA adapter connects OctoMesh to EDA (Energiewirtschaftlicher Datenaustausch), the Austrian energy data exchange between market participants such as grid operators, energy communities and service providers. The adapter does not talk to the EDA network directly: it exchanges XML messages (ebUtilities schemas) with the HttpAdapter of a Ponton X/P Messenger, which handles the transport (KEP) to the other market participants.
With the adapter, pipelines can
- receive EDA messages from the HttpAdapter and parse them (status messages, metering point lists, consumption records),
- start EDA market processes (e.g. register a metering point with an energy community, request consumption data) and
- send notifications (
CPNotification) as replies to received messages.
The market processes supported by the adapter, and how they are used by the energy community solution, are described in the user guide under Supported EDA processes.
Information table
| Field | Description |
|---|---|
| Docker image | meshmakers/octo-communication-adapter-eda |
| Helm chart | octo-eda-adapter |
| Alternative installation scenario | - |
| Adapter configuration | JSON object EdaHttpAdapter with the connection to the Ponton X/P HttpAdapter, see Adapter configuration |
Adapter configuration
The adapter configuration holds the connection to the HttpAdapter of the Ponton X/P Messenger. It is applied when the adapter starts and again whenever the configuration is updated at runtime (e.g. Update Configuration in Refinery Studio); running pipelines pick up the new values with their next execution, no restart is needed.
{
"EdaHttpAdapter": {
"Host": "https://ponton-messenger.example.com:8441",
"User": "http-adapter-user",
"Password": "********",
"IsSimulationMode": false
}
}
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
Host | string | Yes | - | Base address of the HttpAdapter |
User | string | Yes | - | User of the HttpAdapter (basic authentication) |
Password | string | Yes | - | Password of the HttpAdapter user |
IsSimulationMode | bool | No | false | If true, outgoing messages are sent with document mode SIMU instead of PROD (EDA test messages) |
The property names of the adapter configuration are case-sensitive and written in PascalCase. A configuration without Host, User or Password cannot be read and is rejected.
The nodes that talk to the HttpAdapter (EdaReceiver@1, EdaStartProcess@1 and SendNotification@1) have their own optional properties host, user, password and isSimulationMode. Every property that is set on the node overrides the corresponding value of the adapter configuration for this node only; properties that are not set fall back to the adapter configuration.
Nodes
Extract nodes
| Node | Description |
|---|---|
| EdaReceiver@1 | Receives EDA messages from the HttpAdapter of the Ponton X/P Messenger |
| EdaReceiverSimulation@1 | Reads EDA messages from XML files instead of the HttpAdapter (development, testing) |
Transformation nodes
| Node | Description |
|---|---|
| EdaParseMessage@1 | Parses a stored EDA status message into an EdaMessageInfo (process result, metering points) |
| ExtractProcesses@1 | Reduces a list of EdaMessageInfo objects to the newest message per process |
| SplitConsumptionRecord@1 | Splits long consumption record messages (DATEN_CRMSG) into chunks of a maximum duration |
| ParseConsumptionRecord@1 | Parses a consumption record into energy data, one entry per meter code |
| AggregateConsumptionRecord@1 | Parses a consumption record and aggregates the quantities to daily values |
| FilterEnergyData@1 | Keeps only the newest energy data per metering point and period |
| SearchExistingEnergyQuantities@1 | Finds stored energy quantities that overlap new energy data |
| CreateMeteringPointData@1 | Creates metering point data from an ECMPList message |
| CreateMeteringPointUpdate@1 | Decides whether a metering point is created or which existing entity is updated |
| ExportMeasurementsToCsv@1 | Exports measurements of metering points to CSV |
Load nodes
| Node | Description |
|---|---|
| EdaStartProcess@1 | Starts (or plans) an EDA market process and sends the request message |
| SendNotification@1 | Sends a CPNotification to a market participant |
API reference
The configuration classes of all nodes and the data transfer objects (e.g. EdaProcessInfo, EdaClientResult, EdaMessageInfo, EnergyData) are documented in the API reference of the EDA adapter.
All nodes are available in the EDA adapter that are tagged with general availability.