Quellsystem-API: Unterschied zwischen den Versionen
FKorb (Diskussion | Beiträge) |
FKorb (Diskussion | Beiträge) |
||
Zeile 1: | Zeile 1: | ||
==basePath: /source-system/asset== | ==basePath: /source-system/asset== | ||
− | |||
− | |||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|-class="hintergrundfarbe6" | |-class="hintergrundfarbe6" | ||
Zeile 21: | Zeile 19: | ||
|[[Anlagenverantwortlicher]] | |[[Anlagenverantwortlicher]] | ||
|{{REST-GET|name = asset-operators|language = de|protocol = http|host = api.openk.de|base-path = source-system/assets|revision = 0}} | |{{REST-GET|name = asset-operators|language = de|protocol = http|host = api.openk.de|base-path = source-system/assets|revision = 0}} | ||
+ | |} | ||
+ | |||
+ | ==basePath: /source-system/measurement== | ||
+ | {| class="wikitable sortable" | ||
+ | |-class="hintergrundfarbe6" | ||
+ | !Bezeichnung | ||
+ | !Beschreibung | ||
+ | |- | ||
+ | |[[Wirkleistung|aktuelle Wirkleistung]] | ||
+ | |{{REST-GET|name = active-power|language = de|protocol = http|host = api.openk.de|base-path = source-system/measurement|revision = 0}} | ||
+ | |- | ||
+ | |[[Messeinrichtung|Messeinrichtung (aktuelle Wirkleistung)]] | ||
+ | |{{REST-GET|name = active-power-measurements|language = de|protocol = http|host = api.openk.de|base-path = source-system/measurement|revision = 1}} | ||
|} | |} | ||
==basePath: /source-system/topology== | ==basePath: /source-system/topology== | ||
− | |||
− | |||
Die Quellsystem-API (Source System API) stellt u. A. verschiedene Schnittstellen bereit, um topologische Elemente eines Netzes abfragen zu können. | Die Quellsystem-API (Source System API) stellt u. A. verschiedene Schnittstellen bereit, um topologische Elemente eines Netzes abfragen zu können. | ||
Die Aufgabe der Quellsystem-API ist darauf beschränkt, den Aufbau eines vollständigen Topologiemodells zu unterstützen. Umfassende Abfrage- und Selektionsmöglichkeiten werden nicht angeboten. Dies ist Aufgabe einer nachgelagerten Komponente ([[Topologiedatenmanagement]]). Diese Restriktion soll helfen, die datenliefernden Quellsysteme der Netzbetreiber zu entlasten und die Integration der Quellsystem-API zu erleichtern. | Die Aufgabe der Quellsystem-API ist darauf beschränkt, den Aufbau eines vollständigen Topologiemodells zu unterstützen. Umfassende Abfrage- und Selektionsmöglichkeiten werden nicht angeboten. Dies ist Aufgabe einer nachgelagerten Komponente ([[Topologiedatenmanagement]]). Diese Restriktion soll helfen, die datenliefernden Quellsysteme der Netzbetreiber zu entlasten und die Integration der Quellsystem-API zu erleichtern. | ||
Zeile 112: | Zeile 121: | ||
|topologisches Basiselement | |topologisches Basiselement | ||
|{{REST-GET|name = junctions|language = de|protocol = http|host = api.openk.de|base-path = source-system/topology|revision = 1}} | |{{REST-GET|name = junctions|language = de|protocol = http|host = api.openk.de|base-path = source-system/topology|revision = 1}} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
Version vom 30. Juni 2017, 19:02 Uhr
Inhaltsverzeichnis
basePath: /source-system/asset
Bezeichnung | Beschreibung | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anlagen |
| ||||||||||||
Anlagenbetreiber |
| ||||||||||||
Aufteilungen und Zuordnungen des Anlagenbetriebs |
| ||||||||||||
Anlagenstandort |
| ||||||||||||
Anlagenverantwortlicher |
|
basePath: /source-system/measurement
Bezeichnung | Beschreibung | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
aktuelle Wirkleistung |
| ||||||||||||
Messeinrichtung (aktuelle Wirkleistung) |
|
basePath: /source-system/topology
Die Quellsystem-API (Source System API) stellt u. A. verschiedene Schnittstellen bereit, um topologische Elemente eines Netzes abfragen zu können. Die Aufgabe der Quellsystem-API ist darauf beschränkt, den Aufbau eines vollständigen Topologiemodells zu unterstützen. Umfassende Abfrage- und Selektionsmöglichkeiten werden nicht angeboten. Dies ist Aufgabe einer nachgelagerten Komponente (Topologiedatenmanagement). Diese Restriktion soll helfen, die datenliefernden Quellsysteme der Netzbetreiber zu entlasten und die Integration der Quellsystem-API zu erleichtern.
Um ein vollständiges Topologiemodell aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Daten 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 |
| ||||||||||||
Netzgebiet | Gruppierung |
| ||||||||||||
Teilnetzgebiet | Gruppierung |
|
Erzeugung
Bezeichnung | Typ | Beschreibung | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Asynchrongenerator | topologisches Basiselement |
| ||||||||||||
Erzeugungsart | Kategorisierung |
| ||||||||||||
Kraftwerk | Gruppierung |
| ||||||||||||
nicht-rotierende Energiequelle | topologisches Basiselement |
| ||||||||||||
Synchrongenerator | topologisches Basiselement |
| ||||||||||||
Windkraftanlage (Typ 3 oder 4) | topologisches Basiselement |
|
Leitungen und Leitungselemente
Bezeichnung | Typ | Beschreibung | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Leitung | Gruppierung |
| ||||||||||||
Leitungsabschnitt | topologisches Basiselement |
| ||||||||||||
Leitungsart | Kategorisierung |
| ||||||||||||
Muffe | topologisches Basiselement |
|
Umspannwerk
Bezeichnung | Typ | Beschreibung | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Feld | Gruppierung |
| ||||||||||||
Lastgangschalter | topologisches Basiselement |
| ||||||||||||
Leistungsschalter | topologisches Basiselement |
| ||||||||||||
Spannungsebene | Gruppierung |
| ||||||||||||
Sammelschiene | topologisches Basiselement |
| ||||||||||||
Transformator | topologisches Basiselement |
| ||||||||||||
Trenner | topologisches Basiselement |
| ||||||||||||
Umspannwerk | Gruppierung |
| ||||||||||||
Umspannwerkart | Kategorisierung |
|
Verbrauch
Bezeichnung | Typ | Beschreibung | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Lasten mit Standardlastprofil | topologisches Basiselement |
| ||||||||||||
Lasten ohne Standardlastprofil | topologisches Basiselement |
| ||||||||||||
Lasttyp | Kategorisierung |
| ||||||||||||
Standardlastprofilart | Kategorisierung |
|