Quellsystem-API: Unterschied zwischen den Versionen
FKorb (Diskussion | Beiträge) K (FKorb verschob die Seite Source System API nach Quellsystem-API) |
|||
(246 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | + | 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. | |
− | Die Quellsystem-API (Source System API) | ||
− | |||
− | Um ein vollständiges Topologiemodell aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von | + | Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: |
+ | |||
+ | |||
+ | __TOC__ | ||
+ | |||
+ | |||
+ | ==basePath: /source-system/common/contact-data== | ||
+ | {| class="wikitable sortable" | ||
+ | |-class="hintergrundfarbe6" | ||
+ | !Bezeichnung | ||
+ | !Beschreibung | ||
+ | !bereitstellendes System | ||
+ | |- | ||
+ | |Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/common/contact-data|name = organisations|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}} | ||
+ | |<ul><li>mock-up-asset-data v2.2</li></ul> | ||
+ | |} | ||
+ | |||
+ | ==basePath: /source-system/electricity/asset-data== | ||
+ | {| class="wikitable sortable" | ||
+ | |-class="hintergrundfarbe6" | ||
+ | !Bezeichnung | ||
+ | !Beschreibung | ||
+ | !bereitstellendes System | ||
+ | |- | ||
+ | |Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/asset-data|name = asset-ownerships|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}} | ||
+ | |<ul><li>mock-up-asset-data v2.2</li></ul> | ||
+ | |- | ||
+ | |Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/asset-data|name = energy-sources|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}} | ||
+ | |<ul><li>mock-up-asset-data v2.2</li></ul> | ||
+ | |- | ||
+ | |Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/asset-data|name = energy-source-locations|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}} | ||
+ | |<ul><li>mock-up-asset-data v2.2</li></ul> | ||
+ | |} | ||
+ | |||
+ | ==basePath: /source-system/electricity/measurement== | ||
+ | {| class="wikitable sortable" | ||
+ | |-class="hintergrundfarbe6" | ||
+ | !Bezeichnung | ||
+ | !Beschreibung | ||
+ | !bereitstellendes System | ||
+ | |- | ||
+ | |aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/measurement|name = measurement-values|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}} | ||
+ | |<ul><li>mock-up-measurement v2.2</li></ul> | ||
+ | |- | ||
+ | |Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/measurement|name = measurement-points|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}} | ||
+ | |<ul><li>mock-up-measurement v2.2</li></ul> | ||
+ | |} | ||
+ | |||
+ | ==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 <code>ConnectivityNode</code>). 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. | * 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 <code>ConnectivityNode</code>). 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. | * 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. | * 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 | + | Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können: |
− | + | ||
− | ==allgemeine Topologieelemente== | + | ===allgemeine Topologieelemente=== |
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|-class="hintergrundfarbe6" | |-class="hintergrundfarbe6" | ||
Zeile 16: | Zeile 69: | ||
!Typ | !Typ | ||
!Beschreibung | !Beschreibung | ||
+ | !bereitstellendes System | ||
|- | |- | ||
− | | | + | |Nennspannungen |
|Kategorisierung | |Kategorisierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = base-voltages|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Netzgebiete |
|Gruppierung | |Gruppierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = geographical-regions|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Teilnetzgebiete |
|Gruppierung | |Gruppierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = sub-geographical-regions|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
+ | |- | ||
+ | |Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> | ||
+ | | | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = topology-id|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}} | ||
+ | |<ul><li>mock-up-static-topology v2.2</li></ul> | ||
|} | |} | ||
− | ==Erzeugung== | + | ===Erzeugung=== |
[[Datei:CIM-Model Generation.svg|490px]] | [[Datei:CIM-Model Generation.svg|490px]] | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
Zeile 37: | Zeile 99: | ||
!Typ | !Typ | ||
!Beschreibung | !Beschreibung | ||
+ | !bereitstellendes System | ||
|- | |- | ||
− | | | + | |Einspeiser |
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = energy-sources|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}} |
− | + | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | |
− | | | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |Kraftwerke |
|Gruppierung | |Gruppierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = plants|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}} |
− | + | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |- | ||
− | |||
− | |||
− | |||
|} | |} | ||
− | ==Leitungen und Leitungselemente== | + | ===Leitungen und Leitungselemente=== |
[[Datei:CIM-Model Line.svg|568px]] | [[Datei:CIM-Model Line.svg|568px]] | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
Zeile 70: | Zeile 119: | ||
!Typ | !Typ | ||
!Beschreibung | !Beschreibung | ||
+ | !bereitstellendes System | ||
|- | |- | ||
− | | | + | |Leitungen |
|Gruppierung | |Gruppierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = lines|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Leitungsabschnitte |
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = ac-line-segments|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Leitungsarten |
|Kategorisierung | |Kategorisierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = line-types|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Muffen |
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = junctions|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|} | |} | ||
− | == | + | ===Umspannwerk=== |
+ | [[Datei:CIM-Model Substation.svg|817px]] | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|-class="hintergrundfarbe6" | |-class="hintergrundfarbe6" | ||
!Bezeichnung | !Bezeichnung | ||
+ | !Typ | ||
!Beschreibung | !Beschreibung | ||
+ | !bereitstellendes System | ||
|- | |- | ||
− | | | + | |Erdschlussdrossel |
− | |{{REST- | + | |topologisches Basiselement |
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = grounding-impedances|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}} | ||
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Erdungswiderstände |
− | |{{REST- | + | |topologisches Basiselement |
− | | | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = earth-fault-compensators|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}} |
− | + | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |Felder |
|Gruppierung | |Gruppierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = bays|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Lastgangschalter |
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = load-break-switches|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Leistungsschalter |
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = breakers|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Petersenspulen |
− | | | + | |topologisches Basiselement |
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = petersen-coils|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Sammelschienen |
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = busbar-sections|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = switches|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}} |
+ | |<ul><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Spannungsebenen |
− | | | + | |Kategorisierung |
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = voltage-levels|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Stationen |
|Gruppierung | |Gruppierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = substations|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |Stationsarten |
|Kategorisierung | |Kategorisierung | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = substation-types|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
+ | |- | ||
+ | |Transformatoren | ||
+ | |topologisches Basiselement | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = power-transformers|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}} | ||
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
+ | |- | ||
+ | |Trennschalter | ||
+ | |topologisches Basiselement | ||
+ | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = disconnectors|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}} | ||
+ | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | ||
|} | |} | ||
− | ==Verbrauch== | + | ===Verbrauch=== |
[[Datei:CIM-Model Load.svg|489px]] | [[Datei:CIM-Model Load.svg|489px]] | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
Zeile 153: | Zeile 224: | ||
!Typ | !Typ | ||
!Beschreibung | !Beschreibung | ||
+ | !bereitstellendes System | ||
|- | |- | ||
− | | | + | |Verbraucher |
− | |||
− | |||
− | |||
− | |||
|topologisches Basiselement | |topologisches Basiselement | ||
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}} |
− | + | |<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul> | |
− | | | ||
− | |||
− | |||
− | |- | ||
− | |||
− | |||
− | |||
|} | |} | ||
− | = | + | ==basePath: /source-system/electricity/topology-state== |
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|-class="hintergrundfarbe6" | |-class="hintergrundfarbe6" | ||
!Bezeichnung | !Bezeichnung | ||
!Beschreibung | !Beschreibung | ||
+ | !bereitstellendes System | ||
|- | |- | ||
− | | | + | |aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}} |
+ | |<ul><li>mock-up-topology-state v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}} |
+ | |<ul><li>mock-up-topology-state v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}} |
+ | |<ul><li>mock-up-topology-state v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}} |
+ | |<ul><li>mock-up-topology-state v2.2</li></ul> | ||
|- | |- | ||
− | | | + | |aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font> |
− | |{{REST- | + | |{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = https|host = demo.openkonsequenz.de/swagger-ui/doc|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}} |
+ | |<ul><li>mock-up-topology-state v2.2</li></ul> | ||
|} | |} |
Aktuelle Version vom 22. Juni 2020, 08:29 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
basePath: /source-system/common/contact-data
Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Unternehmen (neu in CIM Cache Stufe II) |
|
|
basePath: /source-system/electricity/asset-data
Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anlagen-Eigentumsverhältnisse (neu in CIM Cache Stufe II) |
|
| ||||||||||||||
Einspeiserstammdaten (neu in CIM Cache Stufe II) |
|
| ||||||||||||||
Einspeiserstandorte (neu in CIM Cache Stufe II) |
|
|
basePath: /source-system/electricity/measurement
Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
aktuelle Messwerte (neu in CIM Cache Stufe II) |
|
| ||||||||||||||
Messpunkte (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 |
|
| ||||||||||||||
Topologiekennung (neu in CIM Cache Stufe II) |
|
|
Erzeugung
Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Einspeiser | topologisches Basiselement |
|
| ||||||||||||||
Kraftwerke | Gruppierung |
|
|
Leitungen und Leitungselemente
Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Leitungen | Gruppierung |
|
| ||||||||||||||
Leitungsabschnitte | topologisches Basiselement |
|
| ||||||||||||||
Leitungsarten | Kategorisierung |
|
| ||||||||||||||
Muffen | topologisches Basiselement |
|
|
Umspannwerk
Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Erdschlussdrossel | topologisches Basiselement |
|
| ||||||||||||||
Erdungswiderstände | topologisches Basiselement |
|
| ||||||||||||||
Felder | Gruppierung |
|
| ||||||||||||||
Lastgangschalter | topologisches Basiselement |
|
| ||||||||||||||
Leistungsschalter | topologisches Basiselement |
|
| ||||||||||||||
Petersenspulen | topologisches Basiselement |
|
| ||||||||||||||
Sammelschienen | topologisches Basiselement |
|
| ||||||||||||||
Schalter (neu in CIM Cache Stufe II) |
topologisches Basiselement |
|
| ||||||||||||||
Spannungsebenen | Kategorisierung |
|
| ||||||||||||||
Stationen | Gruppierung |
|
| ||||||||||||||
Stationsarten | Kategorisierung |
|
| ||||||||||||||
Transformatoren | topologisches Basiselement |
|
| ||||||||||||||
Trennschalter | topologisches Basiselement |
|
|
Verbrauch
Bezeichnung | Typ | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Verbraucher | topologisches Basiselement |
|
|
basePath: /source-system/electricity/topology-state
Bezeichnung | Beschreibung | bereitstellendes System | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
aktueller Betriebszustand der Einspeiser (neu in CIM Cache Stufe II) |
|
| ||||||||||||||
aktueller Kommunikationsstatus der Einspeiser (neu in CIM Cache Stufe II) |
|
| ||||||||||||||
aktuelle Regelstufe der Einspeiser (neu in CIM Cache Stufe II) |
|
| ||||||||||||||
aktuelle Schalterstellungen (neu in CIM Cache Stufe II) |
|
| ||||||||||||||
aktuelle Stellung der Transformatorstufenschalter (neu in CIM Cache Stufe II) |
|
|