Quellsystem-API: Unterschied zwischen den Versionen
FKorb (Diskussion | Beiträge) (→basePath: /source-system/common/asset-data) |
FKorb (Diskussion | Beiträge) (→basePath: /source-system/common/asset-data) |
||
| Zeile 26: | Zeile 26: | ||
!bereitstellendes System | !bereitstellendes System | ||
|- | |- | ||
| − | |<del>Anlagenbetreiber</del><br/>(veraltet) | + | |<del>Anlagenbetreiber</del><br/>(veraltet) |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = asset-owners|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/deprecated/source-system.electricity.asset-data.asset-operators_GET_1_de.open-api.yaml|revision = Revision 1 (CIM 17v07)}} |
| − | | | + | | |
|- | |- | ||
| − | |<del>Anlageneigentümer</del><br/>(veraltet) | + | |<del>Anlageneigentümer</del><br/>(veraltet) |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = asset-owners|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/deprecated/source-system.electricity.asset-data.asset-owners_GET_1_de.open-api.yaml|revision = Revision 1 (CIM 17v07)}} |
| − | | | + | | |
|- | |- | ||
| − | |<del>Anlagen-Eigentumsverhältnisse</del><br/>(veraltet) | + | |<del>Anlagen-Eigentumsverhältnisse</del><br/>(veraltet) |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = ownerships|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/deprecated/source-system.electricity.asset-data.ownerships_GET_1_de.open-api.yaml|revision = Revision 1 (CIM 17v07)}} |
| − | | | + | | |
|- | |- | ||
| − | | | + | |Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/source-system.electricity.asset-data.asset-ownerships_GET_2_de.open-api.yaml|revision = Revision 2 (cim-profile openkonsequenz)}} |
|<ul><li>asset-data v2.2</li></ul> | |<ul><li>asset-data v2.2</li></ul> | ||
|- | |- | ||
| − | |<del>Anlagen</del><br/>(veraltet)<br/ | + | |<del>Anlagen</del><br/>(veraltet)<br/> |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = assets|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/deprecated/source-system.electricity.asset-data.assets_GET_1_de.open-api.yaml|revision = Revision 1 (CIM 17v07)}} |
| − | | | + | | |
|- | |- | ||
| − | |<del>Anlagenstandorte</del><br/>(veraltet) | + | |<del>Anlagenstandorte</del><br/>(veraltet) |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = asset-locations|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/deprecated/source-system.electricity.asset-data.asset-locations_GET_1_de.open-api.yaml|revision = Revision 0 (CIM 17v07)}} |
| − | | | + | | |
|- | |- | ||
| − | | | + | |Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = energy-sources|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = Revision 1 (cim-profile openkonsequenz)}} |
| − | | | + | | |
|- | |- | ||
| − | | | + | |Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
| − | |{{REST-GET_2|name = | + | |{{REST-GET_2|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|relative-path = source-system/electricity/asset-data/source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = Revision 1 (cim-profile openkonsequenz)}} |
|<ul><li>asset-data v2.2</li></ul> | |<ul><li>asset-data v2.2</li></ul> | ||
|} | |} | ||
Version vom 19. September 2018, 10:54 Uhr
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:
Inhaltsverzeichnis
- 1 basePath: /source-system/common/contact-data
- 2 basePath: /source-system/common/asset-data
- 3 basePath: /source-system/electricity/asset-data
- 4 basePath: /source-system/electricity/measurement
- 5 basePath: /source-system/electricity/topology-state
- 6 basePath: /source-system/electricity/static-topology
basePath: /source-system/common/contact-data
| Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Unternehmen (neu in CIM Cache Stufe II) |
|
|
basePath: /source-system/common/asset-data
| Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(veraltet) |
|
|||||||||||||
(veraltet) |
|
|||||||||||||
(veraltet) |
|
|||||||||||||
| Anlagen-Eigentumsverhältnisse (neu in CIM Cache Stufe II) |
|
| ||||||||||||
(veraltet) |
|
|||||||||||||
(veraltet) |
|
|||||||||||||
| Einspeiserstammdaten (neu in CIM Cache Stufe II) |
|
|||||||||||||
| Einspeiserstandorte (neu in CIM Cache Stufe II) |
|
|
basePath: /source-system/electricity/asset-data
| Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(veraltet) |
|
|||||||||||||
(veraltet) |
|
|||||||||||||
| Anlagenbetreiber (neu in CIM Cache Stufe II) |
|
| ||||||||||||
(veraltet) |
|
|||||||||||||
| Anlagen-Eigentumsverhältnisse (neu in CIM Cache Stufe II) |
|
| ||||||||||||
(veraltet) |
|
|||||||||||||
| Anlagenstandorte (neu in CIM Cache Stufe II) |
|
| ||||||||||||
(veraltet) |
|
|||||||||||||
| Anlagenverantwortliche (neu in CIM Cache Stufe II) |
|
| ||||||||||||
| Einspeiserstammdaten (neu in CIM Cache Stufe II) |
|
|
basePath: /source-system/electricity/measurement
| Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(veraltet - nicht unterstützt) |
|
|||||||||||||
(veraltet - nicht unterstützt) |
|
|||||||||||||
| Messpunkte (neu in CIM Cache Stufe II) |
|
| ||||||||||||
| aktuelle Messwerte (Diskussionsgrundlage NDS) |
|
| ||||||||||||
| aktuelle Messwerte (neu in CIM Cache Stufe II) |
|
|
basePath: /source-system/electricity/topology-state
| Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| aktuelle Schalterstellungen (unterstützt ab CIM Cache Stufe II) |
|
| ||||||||||||
| aktuelle Stellung der Transformatorstufenschalter (neu in CIM Cache Stufe II) |
|
| ||||||||||||
| aktuelle Regelstufe der Einspeiser (neu in CIM Cache Stufe II) |
|
| ||||||||||||
| aktueller Betriebszustand der Einspeiser (neu in CIM Cache Stufe II) |
|
|
basePath: /source-system/electricity/static-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 | bereitstellendes System | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Nennspannungen | Kategorisierung |
|
| ||||||||||||||
| Netzgebiete | Gruppierung |
|
| ||||||||||||||
| Teilnetzgebiete | Gruppierung |
|
|
Erzeugung
| Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(veraltet) |
topologisches Basiselement |
|
|||||||||||||||
| Einspeiser | topologisches Basiselement |
|
| ||||||||||||||
(veraltet) |
Kategorisierung |
|
|||||||||||||||
| Kraftwerke | Gruppierung |
|
| ||||||||||||||
(veraltet) |
topologisches Basiselement |
|
|||||||||||||||
(veraltet) |
topologisches Basiselement |
|
|||||||||||||||
(veraltet) |
topologisches Basiselement |
|
Leitungen und Leitungselemente
| Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Leitungen | Gruppierung |
|
| ||||||||||||||
| Leitungsabschnitte | topologisches Basiselement |
|
| ||||||||||||||
| Leitungsarten | Kategorisierung |
|
| ||||||||||||||
| Muffen | topologisches Basiselement |
|
|
Umspannwerk
| Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(noch nicht) |
topologisches Basiselement |
|
|||||||||||||||
| Erdungswiderstände | topologisches Basiselement |
|
| ||||||||||||||
| Erdschlussdrosseln | topologisches Basiselement |
|
| ||||||||||||||
| Felder | Gruppierung |
|
| ||||||||||||||
| Lastgangschalter | topologisches Basiselement |
|
| ||||||||||||||
| Leistungsschalter | topologisches Basiselement |
|
| ||||||||||||||
| Petersenspulen | topologisches Basiselement |
|
| ||||||||||||||
| Spannungsebenen | Gruppierung |
|
| ||||||||||||||
| Sammelschienen | topologisches Basiselement |
|
| ||||||||||||||
| Transformatoren | topologisches Basiselement |
|
| ||||||||||||||
| Trennschalter | topologisches Basiselement |
|
| ||||||||||||||
| Stationen | Gruppierung |
|
| ||||||||||||||
| Stationsarten | Kategorisierung |
|
|
Verbrauch
| Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(veraltet) |
topologisches Basiselement |
|
|||||||||||||||
(veraltet) |
topologisches Basiselement |
|
|||||||||||||||
(veraltet) |
Kategorisierung |
|
|||||||||||||||
(veraltet) |
Kategorisierung |
|
|||||||||||||||
| Verbraucher | Kategorisierung |
|
|