machine-readable_entscheidungsbaumdiagramme

Dieses Repository enthält Entscheidungsbaumdiagramme (EBD) in einem maschinenlesbaren Format, das deutlich einfacher zu verarbeiten ist als .docx oder .pdf. Wir pflegen analog zu den hier abgelegten Daten auch:

• machine-readable_message-implementation-guide für MIGs
• machine-readable_anwendungshandbuecher für AHBs
• edi_energy_ahb_conditions_and_packages für Bedingungen und Paket-Definitionen aus den AHBs

Unter der Haube

Zur Erstellung der hier veröffentlichten Daten nutzen wir ebd_amame und r_ebd_huhn, zwei Hochfrequenz Libraries zur Verarbeitung von EBDs. Konkret verwenden wir unsere EBD Toolchain mit der Datengrundlage aus dem edi-energy-mirror in einer Github Action.

Struktur & Datenformate

Zur Strukturierung nutzen wir nicht die Format- oder AHB-Versionen (z.B. UTILMD 5.2e oder GPKE AHB 6.1e), sondern lediglich den Zeitraum zu dem die Daten gültig sind. Beispielsweise bezeichnet FV2210 die Datenformate, die seit 2022-10-01 gültig sind oder FV2304 die Datenformate, die seit 2023-04-01 gültig sind.

Jeder EBD ist in je bis zu 4 verschiedenen Dateiformaten verfügbar:

• JSON (die rohen Daten, die aus der Word-Datei gescraped wurden)
• PlantUML, falls der Entscheidungsbaumgraph in PlantUML plotbar ist
• DOT (das Format hinter GraphViz, falls das Diagramm nicht zu komplex ist)
• SVG

Motivation

Wir freuen uns über jede durch dieses Repository ersparte Stunde Arbeit, in der wichtige Probleme gelöst werden können anstatt EBDs zu analysieren.

Urheberrecht

Das Urheberrecht der hier versionierten Daten liegt bei EDI@energy bzw. den Autor*innen der Anwendungshandbücher selbst. Dieses Repository macht die Daten aus den den EBDs zugrunde liegenden Tabellen lediglich leichter zugänglich. Hochfrequenz garantiert weder für die Korrektheit noch die Vollständigkeit der hier bereitgestellten Daten.

Rückmeldungen & Mitwirken

Die hier bereitgestellten Daten sind wahrscheinlich nicht fehlerfrei und mit Sicherheit unvollständig. Probleme oder Fehler können gerne als Issue gemeldet werden. Es ist jedoch nicht sinnvoll, Änderungen direkt hier an den Ergebnis-Daten vorzunehmen; Stattdessen sollten die den Problemen zu Grunde liegeneden Scrapingfehler im Paket ebd_amame und Probleme beim Plotten bzw. Erstellen eines Graphen im Paket r_ebd_huhn adressiert werden.

Weiterführendes Tooling

Dieses Repository ist Teil der Hochfrequenz Libraries und Tool für eine echte Digitalisierung der Marktkommunikation. Insbesondere die maschinenlesbaren Anwendungshandbücher könnten ebenfalls relevant sein.