Quellsystem-API

Aus Wiki openKONSEQUENZ
Version vom 29. August 2017, 15:01 Uhr von FKorb (Diskussion | Beiträge) (→‎basePath: /source-system/measurement)

Wechseln zu: Navigation, Suche

Die Quellsystem-API (Source System API) harmonisert den Zugriff auf die Quellsysteme des Netzbetreibers. Sie ist in ihren Abfragemöglichkeiten bewusst einfach gehalten, um die Integration zu vereinfachen und die Komplexität bei der Bereitstellung der Quellssystemdaten zu minimieren. Gleichzeitig sollen die datenliefernden Quellsysteme entlastet werden. Die Bereitstellung komfortabler, fachlicher Abfragen sowie umfassender Selektions- und Filtermöglichkeiten geschieht wiederverwendbar in den nachgelagerten Domänen-Modulen.

Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt:



basePath: /source-system/asset

Bezeichnung Beschreibung
Anlagen
http-Methode: GET
Bezeichnung: assets
aktuelle Version: 1
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anlagenbetreiber
http-Methode: GET
Bezeichnung: asset-owners
aktuelle Version: 1
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Aufteilungen und Zuordnungen des Anlagenbetriebs
http-Methode: GET
Bezeichnung: ownerships
aktuelle Version: 1
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anlagenstandort
http-Methode: GET
Bezeichnung: asset-locations
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anlagenverantwortlicher
http-Methode: GET
Bezeichnung: asset-operators
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI

basePath: /source-system/measurement

Bezeichnung Beschreibung
aktuelle Wirkleistung
(veraltet)
http-Methode: GET
Bezeichnung: active-power
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Messeinrichtung (aktuelle Wirkleistung)
http-Methode: GET
Bezeichnung: active-power-measurements
aktuelle Version: 1
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Schalterstellungen
http-Methode: GET
Bezeichnung: switch-states
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI

basePath: /source-system/topology

Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:

  • topologische Basiselemente: Topologische Basiselemente stellen die elektrisch leitenden Elemente in der Topologie dar. Hierzu zählen u. A. Tranformatoren, Leistungsschalter, Sammelschienen. Die Verbindung zwischen den einzelnen Basiselementen erfolgt über spezielle Knoten (im CIM ConnectivityNode). Jedes Basiselement besitzt hierzu einen Verweis auf mindestens einen Verbindungsknoten. Über den Vergleich der Verbindungsknoten können die Zusammenhänge und Verknüpfungen der Basiselemente hergestellt werden.
  • Kategorisierung: Hinter "Kategorisierung" verbirgt sich die Einteilung in bestimmte Arten von Elementen, die modellierungstechnisch gleich sind. Netzbetreiber haben hierüber die Möglichkeit, eigene Einteilung, die unternehmensspezifisch sind, vorzunehmen. Als Beispiel können hier Leitungsarten ("Hauptleitung", "Abzweig", ...) oder Umspannwerkarten ("Umspannwerk", "Ortsnetztrafo", ...) genannt werden.
  • Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.

Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:

allgemeine Topologieelemente

Bezeichnung Typ Beschreibung
Nennspannung Kategorisierung
http-Methode: GET
Bezeichnung: base-voltages
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Netzgebiet Gruppierung
http-Methode: GET
Bezeichnung: geographical-regions
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Teilnetzgebiet Gruppierung
http-Methode: GET
Bezeichnung: sub-geographical-regions
aktuelle Version: 2
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI

Erzeugung

CIM-Model Generation.svg

Bezeichnung Typ Beschreibung
Asynchrongenerator topologisches Basiselement
http-Methode: GET
Bezeichnung: asynchronous-machines
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Erzeuger topologisches Basiselement
http-Methode: GET
Bezeichnung: energy-sources
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Erzeugungsart Kategorisierung
http-Methode: GET
Bezeichnung: generation-types
aktuelle Version: 2
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Kraftwerk Gruppierung
http-Methode: GET
Bezeichnung: plants
aktuelle Version: 2
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
nicht-rotierende Energiequelle topologisches Basiselement
http-Methode: GET
Bezeichnung: non-rotating-energies
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Synchrongenerator topologisches Basiselement
http-Methode: GET
Bezeichnung: synchronous-machines
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Windkraftanlage (Typ 3 oder 4) topologisches Basiselement
http-Methode: GET
Bezeichnung: wind-turbines-type-3-or-4
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI

Leitungen und Leitungselemente

CIM-Model Line.svg

Bezeichnung Typ Beschreibung
Leitung Gruppierung
http-Methode: GET
Bezeichnung: lines
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Leitungsabschnitt topologisches Basiselement
http-Methode: GET
Bezeichnung: ac-line-segments
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Leitungsart Kategorisierung
http-Methode: GET
Bezeichnung: line-types
aktuelle Version: 2
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Muffe topologisches Basiselement
http-Methode: GET
Bezeichnung: junctions
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI

Umspannwerk

CIM-Model Substation.svg

Bezeichnung Typ Beschreibung
Erdungen topologisches Basiselement
http-Methode: GET
Bezeichnung: grounds
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Erdungswiderstände topologisches Basiselement
http-Methode: GET
Bezeichnung: earth-fault-compensators
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Erdschlussdrosseln topologisches Basiselement
http-Methode: GET
Bezeichnung: grounding-impedances
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Feld Gruppierung
http-Methode: GET
Bezeichnung: bays
aktuelle Version: 2
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Lastgangschalter topologisches Basiselement
http-Methode: GET
Bezeichnung: load-break-switches
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Leistungsschalter topologisches Basiselement
http-Methode: GET
Bezeichnung: breakers
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Petersenspulen topologisches Basiselement
http-Methode: GET
Bezeichnung: petersen-coils
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Spannungsebene Gruppierung
http-Methode: GET
Bezeichnung: voltage-levels
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Sammelschiene topologisches Basiselement
http-Methode: GET
Bezeichnung: busbar-sections
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Transformator topologisches Basiselement
http-Methode: GET
Bezeichnung: power-transformers
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Trenner topologisches Basiselement
http-Methode: GET
Bezeichnung: disconnectors
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Umspannwerk Gruppierung
http-Methode: GET
Bezeichnung: substations
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Umspannwerkart Kategorisierung
http-Methode: GET
Bezeichnung: substation-types
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI

Verbrauch

CIM-Model Load.svg

Bezeichnung Typ Beschreibung
Lasten mit Standardlastprofil topologisches Basiselement
http-Methode: GET
Bezeichnung: conform-loads
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Lasten ohne Standardlastprofil topologisches Basiselement
http-Methode: GET
Bezeichnung: non-conform-loads
aktuelle Version: 0
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Lasttyp Kategorisierung
http-Methode: GET
Bezeichnung: load-types
aktuelle Version: 1
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Standardlastprofilart Kategorisierung
http-Methode: GET
Bezeichnung: conform-load-types
aktuelle Version: 1
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
allgemeine Verbraucher Kategorisierung
http-Methode: GET
Bezeichnung: energy-consumers
aktuelle Version: 3
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Abgerufen von „http://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&oldid=664“