https://wiki.openkonsequenz.de/api.php?action=feedcontributions&feedformat=atom&user=EThume
Wiki openKONSEQUENZ - Benutzerbeiträge [de]
2026-06-10T09:40:43Z
Benutzerbeiträge
MediaWiki 1.27.1
https://wiki.openkonsequenz.de/index.php?title=Administration_und_Installation&diff=1287
Administration und Installation
2019-03-12T07:41:30Z
<p>EThume: Der Seiteninhalt wurde durch einen anderen Text ersetzt: „{{Warning|text=Die Dokumentation von Administration und Installation des CIM Caches findet sich, nach den Anforderungen des überarb…“</p>
<hr />
<div>{{Warning|text=Die Dokumentation von Administration und Installation des CIM Caches findet sich, nach den Anforderungen des überarbeiteten QC-Handbooks, in der Service-Dokumentation im AsciiDoc-Format.}}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1278
Domänen-API
2019-02-13T09:50:54Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1277
Domänen-API
2019-02-13T09:16:05Z
<p>EThume: /* basePath: /domain/electricity/topology-state */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1276
Domänen-API
2019-02-13T09:14:03Z
<p>EThume: /* basePath: /domain/electricity/static-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1275
Domänen-API
2019-02-13T09:13:25Z
<p>EThume: /* basePath: /domain/electricity/measurement */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1274
Domänen-API
2019-02-13T09:12:04Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1273
Domänen-API
2019-02-13T09:07:33Z
<p>EThume: /* basePath: /domain/electricity/asset-data */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1272
Domänen-API
2019-02-13T09:05:37Z
<p>EThume: /* basePath: /domain/common/contact-data */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-protocol = https|link-host = 169.50.13.150|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1271
Quellsystem-API
2019-02-13T09:02:59Z
<p>EThume: /* basePath: /source-system/electricity/topology-state */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1270
Quellsystem-API
2019-02-13T09:02:18Z
<p>EThume: /* Verbrauch */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1269
Quellsystem-API
2019-02-13T09:00:33Z
<p>EThume: /* Umspannwerk */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1268
Quellsystem-API
2019-02-13T08:58:20Z
<p>EThume: /* Leitungen und Leitungselemente */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = grounding-impedances|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = earth-fault-compensators|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = bays|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = load-break-switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = breakers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = petersen-coils|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = busbar-sections|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = voltage-levels|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substations|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substation-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = power-transformers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = disconnectors|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1267
Quellsystem-API
2019-02-13T08:57:06Z
<p>EThume: /* Erzeugung */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = lines|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = ac-line-segments|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = line-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = junctions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = grounding-impedances|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = earth-fault-compensators|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = bays|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = load-break-switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = breakers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = petersen-coils|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = busbar-sections|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = voltage-levels|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substations|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substation-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = power-transformers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = disconnectors|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1266
Quellsystem-API
2019-02-13T08:55:53Z
<p>EThume: /* allgemeine Topologieelemente */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = plants|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = lines|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = ac-line-segments|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = line-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = junctions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = grounding-impedances|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = earth-fault-compensators|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = bays|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = load-break-switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = breakers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = petersen-coils|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = busbar-sections|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = voltage-levels|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substations|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substation-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = power-transformers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = disconnectors|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1265
Quellsystem-API
2019-02-13T08:53:59Z
<p>EThume: /* basePath: /source-system/electricity/measurement */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = geographical-regions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = sub-geographical-regions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = plants|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = lines|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = ac-line-segments|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = line-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = junctions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = grounding-impedances|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = earth-fault-compensators|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = bays|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = load-break-switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = breakers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = petersen-coils|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = busbar-sections|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = voltage-levels|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substations|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substation-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = power-transformers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = disconnectors|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1264
Quellsystem-API
2019-02-13T08:46:54Z
<p>EThume: /* basePath: /source-system/electricity/asset-data */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-measurement.openk.de|path = source-system/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-measurement.openk.de|path = source-system/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = geographical-regions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = sub-geographical-regions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = plants|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = lines|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = ac-line-segments|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = line-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = junctions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = grounding-impedances|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = earth-fault-compensators|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = bays|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = load-break-switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = breakers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = petersen-coils|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = busbar-sections|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = voltage-levels|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substations|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substation-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = power-transformers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = disconnectors|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Quellsystem-API&diff=1263
Quellsystem-API
2019-02-13T08:40:52Z
<p>EThume: /* basePath: /source-system/common/contact-data */</p>
<hr />
<div>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.<br />
<br />
Im Folgenden werden die unterschiedlichen Schnittstellen-Methoden der Quellsystem-API vorgestellt: <br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /source-system/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{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 = http|host = api.openk.de|file = source-system.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-asset-data.openk.de|path = source-system/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-asset-data.openk.de|path = source-system/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-asset-data.openk.de|path = source-system/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-measurement.openk.de|path = source-system/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-values_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-measurement.openk.de|path = source-system/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.measurement.measurement-points_GET_4_de.open-api.yaml|revision = 4}}<br />
|<ul><li>mock-up-measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/static-topology==<br />
Um ein vollständiges Topologiemodell flexibel aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Abfragen zur Verfügung:<br />
* 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.<br />
* 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.<br />
* Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.<br />
<br />
Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können:<br />
<br />
===allgemeine Topologieelemente===<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.base-voltages_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Netzgebiete<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = geographical-regions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.geographical-regions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Teilnetzgebiete<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = sub-geographical-regions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.sub-geographical-regions_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Erzeugung===<br />
[[Datei:CIM-Model Generation.svg|490px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Einspeiser<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-sources_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Kraftwerke<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = plants|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.plants_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Leitungen und Leitungselemente===<br />
[[Datei:CIM-Model Line.svg|568px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Leitungen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = lines|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.lines_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsabschnitte<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = ac-line-segments|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.ac-line-segments_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leitungsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = line-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.line-types_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Muffen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = junctions|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.junctions_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Umspannwerk===<br />
[[Datei:CIM-Model Substation.svg|817px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Erdschlussdrossel<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = grounding-impedances|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.grounding-impedances_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Erdungswiderstände<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = earth-fault-compensators|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.earth-fault-compensators_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Felder<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = bays|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.bays_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Lastgangschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = load-break-switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.load-break-switches_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Leistungsschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = breakers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.breakers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Petersenspulen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = petersen-coils|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.petersen-coils_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Sammelschienen<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = busbar-sections|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.busbar-sections_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Schalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = switches|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.switches_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Spannungsebenen<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = voltage-levels|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.voltage-levels_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationen<br />
|Gruppierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substations|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substations_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Stationsarten<br />
|Kategorisierung<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = substation-types|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.substation-types_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Transformatoren<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = power-transformers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.power-transformers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|-<br />
|Trennschalter<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = disconnectors|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.disconnectors_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
===Verbrauch===<br />
[[Datei:CIM-Model Load.svg|489px]]<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Verbraucher<br />
|topologisches Basiselement<br />
|{{REST-GET_2_with_link|link-host = mock-up-static-topology.openk.de|path = source-system/electricity/static-topology|name = energy-consumers|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.static-topology.energy-consumers_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-static-topology v2.1</li><li>mock-up-static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /source-system/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.operating-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.switch-states_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = mock-up-topology-state.openk.de|path = source-system/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = source-system.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>mock-up-topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Vorlage:REST-GET_2_with_link&diff=1262
Vorlage:REST-GET 2 with link
2019-02-13T08:38:47Z
<p>EThume: </p>
<hr />
<div><onlyinclude><!--<br />
--><div style='font-size: 88%;vertical-align:text-top;z-index: 2;<!--<br />
-->align: left;<!--<br />
-->background:#F9F9F9;<!--<br />
-->width:100%; }}<!--<br />
-->padding:7px 7px 7px 7px;<!--<br />
-->><!--<br />
--><table><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">http-Methode: </td><br />
<td style="align:left;vertical-align:text-top;">GET</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Bezeichnung: </td><br />
<td style="align:left;vertical-align:text-top;">{{{name}}}</td><br />
</tr> <br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">aktuelle Version: </td><br />
<td style="align:left;vertical-align:text-top;">{{{revision}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Sprache (ISO 639-1): </td><br />
<td style="align:left;vertical-align:text-top;">{{{language}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Quelltext: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol}}}://{{{host}}}/{{{path}}}/{{{file}}} {{{host}}}]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Spezifikation: </td><br />
<td style="align:left;vertical-align:text-top;">[http://swagger-ui.openk.de/?url={{{protocol}}}://{{{host}}}/{{{path}}}/{{{file}}} Swagger UI]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Testen: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{link-protocol}}}://{{{link-host}}}/{{{path}}}/{{{name}}}?revision={{{revision}}} {{{link-host}}}]</td><br />
</tr><br />
</table><br />
</div><br />
</onlyinclude></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Vorlage:REST-GET_with_link&diff=1261
Vorlage:REST-GET with link
2019-02-13T08:31:27Z
<p>EThume: </p>
<hr />
<div><onlyinclude><!--<br />
--><div style='font-size: 88%;vertical-align:text-top;z-index: 2;<!--<br />
-->align: left;<!--<br />
-->background:#F9F9F9;<!--<br />
-->width:100%; }}<!--<br />
-->padding:7px 7px 7px 7px;<!--<br />
-->><!--<br />
--><table><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">http-Methode: </td><br />
<td style="align:left;vertical-align:text-top;">GET</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Bezeichnung: </td><br />
<td style="align:left;vertical-align:text-top;">{{{name}}}</td><br />
</tr> <br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">aktuelle Version: </td><br />
<td style="align:left;vertical-align:text-top;">{{{revision}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Sprache (ISO 639-1): </td><br />
<td style="align:left;vertical-align:text-top;">{{{language}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Quelltext: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml {{{host}}}]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Spezifikation: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol}}}://{{{host}}}/swagger-ui-master/dist/?url={{{protocol}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml Swagger UI]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Link: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{link-protocol}}}://{{{link-host}}}/{{{base-path}}}/{{{name}}}?revision={{{revision}}} {{{link-host}}}]</td><br />
</tr><br />
</table><br />
</div><br />
</onlyinclude></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Vorlage:REST-GET_with_link&diff=1260
Vorlage:REST-GET with link
2019-02-13T08:31:17Z
<p>EThume: </p>
<hr />
<div><onlyinclude><!--<br />
--><div style='font-size: 88%;vertical-align:text-top;z-index: 2;<!--<br />
-->align: left;<!--<br />
-->background:#F9F9F9;<!--<br />
-->width:100%; }}<!--<br />
-->padding:7px 7px 7px 7px;<!--<br />
-->><!--<br />
--><table><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">http-Methode: </td><br />
<td style="align:left;vertical-align:text-top;">GET</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Bezeichnung: </td><br />
<td style="align:left;vertical-align:text-top;">{{{name}}}</td><br />
</tr> <br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">aktuelle Version: </td><br />
<td style="align:left;vertical-align:text-top;">{{{revision}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Sprache (ISO 639-1): </td><br />
<td style="align:left;vertical-align:text-top;">{{{language}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Quelltext: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml {{{host}}}]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Spezifikation: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol}}}://{{{host}}}/swagger-ui-master/dist/?url={{{protocol}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml Swagger UI]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Link: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{linkprotocol}}}://{{{link-host}}}/{{{base-path}}}/{{{name}}}?revision={{{revision}}} {{{link-host}}}]</td><br />
</tr><br />
</table><br />
</div><br />
</onlyinclude></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Vorlage:REST-GET_with_link&diff=1259
Vorlage:REST-GET with link
2019-02-13T08:29:40Z
<p>EThume: </p>
<hr />
<div><onlyinclude><!--<br />
--><div style='font-size: 88%;vertical-align:text-top;z-index: 2;<!--<br />
-->align: left;<!--<br />
-->background:#F9F9F9;<!--<br />
-->width:100%; }}<!--<br />
-->padding:7px 7px 7px 7px;<!--<br />
-->><!--<br />
--><table><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">http-Methode: </td><br />
<td style="align:left;vertical-align:text-top;">GET</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Bezeichnung: </td><br />
<td style="align:left;vertical-align:text-top;">{{{name}}}</td><br />
</tr> <br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">aktuelle Version: </td><br />
<td style="align:left;vertical-align:text-top;">{{{revision}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Sprache (ISO 639-1): </td><br />
<td style="align:left;vertical-align:text-top;">{{{language}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Quelltext: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol_1}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml {{{host}}}]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Spezifikation: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol_1}}}://{{{host}}}/swagger-ui-master/dist/?url={{{protocol}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml Swagger UI]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Link: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol_2}}}://{{{link-host}}}/{{{base-path}}}/{{{name}}}?revision={{{revision}}} {{{link-host}}}]</td><br />
</tr><br />
</table><br />
</div><br />
</onlyinclude></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Vorlage:REST-GET_with_link&diff=1258
Vorlage:REST-GET with link
2019-02-13T08:27:04Z
<p>EThume: </p>
<hr />
<div><onlyinclude><!--<br />
--><div style='font-size: 88%;vertical-align:text-top;z-index: 2;<!--<br />
-->align: left;<!--<br />
-->background:#F9F9F9;<!--<br />
-->width:100%; }}<!--<br />
-->padding:7px 7px 7px 7px;<!--<br />
-->><!--<br />
--><table><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">http-Methode: </td><br />
<td style="align:left;vertical-align:text-top;">GET</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Bezeichnung: </td><br />
<td style="align:left;vertical-align:text-top;">{{{name}}}</td><br />
</tr> <br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">aktuelle Version: </td><br />
<td style="align:left;vertical-align:text-top;">{{{revision}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Sprache (ISO 639-1): </td><br />
<td style="align:left;vertical-align:text-top;">{{{language}}}</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Quelltext: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml {{{host}}}]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Spezifikation: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{protocol}}}://{{{host}}}/swagger-ui-master/dist/?url={{{protocol}}}://{{{host}}}/{{{base-path}}}/GET_{{{name}}}_{{{revision}}}_{{{language}}}.open-api.yaml Swagger UI]</td><br />
</tr><br />
<tr><br />
<td style="white-space:nowrap;font-weight:bold;align:left;vertical-align:text-top;">Link: </td><br />
<td style="align:left;vertical-align:text-top;">[{{{link-protocol}}}://{{{link-host}}}/{{{base-path}}}/{{{name}}}?revision={{{revision}}} {{{link-host}}}]</td><br />
</tr><br />
</table><br />
</div><br />
</onlyinclude></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Mock-Up-Static-Topology&diff=1257
Mock-Up-Static-Topology
2019-02-12T18:23:31Z
<p>EThume: /* Elemente */</p>
<hr />
<div>__TOC__<br />
<br />
Dieser Dienst simuliert Quellsysteme, die topologische Elemente und Verknüpfungen über die [[Quellsystem-API]] zur Verfügung stellen.<br />
<br />
Für Testzwecke werden die verschiedenen Topologievarianten angeboten:<br />
<br />
=Vollständiges Referenzmodell=<br />
Der Zweck des vollständigen Referenzmodells liegt in der Funktionsüberprüfung der datennutzenden Domänen- und Nutzermodule.<br />
Daher sind alle unterstützten topologischen Elemente und Entitäten sowie deren Verknüpfung enthalten. Der Fokus liegt auf Vollständigkeit und Übersichtlichkeit, nicht auf Größe oder Sinnhaftigkeit des Modells.<br />
<br />
Das aktuell verwendete Referenzmodell ist im Folgenden definiert:<br />
<br />
[[Datei:CIM-Model_reference-model.svg]]<br />
<br />
==Elemente==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Nr.<br />
!Ressourcentyp<br />
!MRID<br />
!Bezugspunkt<br />
!Beschreibung<br />
!Eigenschaften<br />
|-<br />
|1<br />
|TopologyId<br />
|random<br />
| -<br />
|ID der Toplogie<br />
|<br />
|-<br />
|2<br />
|EnergySource<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
| -<br />
|Einspeiser<br />
|<br />
|-<br />
|3<br />
|Plant<br />
|0692e320-3ce6-47c4-bc57-525f9da47373<br />
| -<br />
|Kraftwerk<br />
|<br />
|-<br />
|4<br />
|SubstationType<br />
|3867ec39-1816-4905-b4a3-cc0d3678c269<br />
| -<br />
|Typ des Umspannwerks<br />
|<br />
|-<br />
|5<br />
|Substation<br />
|89edf801-13c2-4fb6-9fe1-4c01b7b07b21<br />
| -<br />
|Umspannwerk<br />
|<br />
|-<br />
|6<br />
|VoltageLevel<br />
|c8be6aa9-45f9-40de-aa1f-6e6c4f4ba46d<br />
| -<br />
|mid-voltage-voltage-level<br />
|<br />
|-<br />
|7<br />
|MeasurementPoint<br />
| -<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
|Messpunkt von breaker<br />
|<br />
|-<br />
|8<br />
|Breaker<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
| -<br />
|Leistungsschalter<br />
|<br />
|-<br />
|9<br />
|Disconnector<br />
|1c0b7ae1-1d28-4599-8659-ddda708b31c1<br />
| -<br />
|Trenner<br />
|<br />
|-<br />
|10<br />
|Bay<br />
|3569b278-014f-4584-af9d-b4fc1e39830f<br />
| -<br />
|mid-voltage-bay<br />
|<br />
|-<br />
|11<br />
|BusbarSection<br />
|b24dc203-7253-4ead-bf61-6e90e9b5ce21<br />
| -<br />
|Sammelschiene<br />
|<br />
|-<br />
|12<br />
|BaseVoltage<br />
|ea4cf040-cb88-4978-a3a4-630a8f144e4b<br />
| -<br />
|mid-voltage-base-voltage<br />
|<br />
|-<br />
|13<br />
|BaseVoltage<br />
|9542f9ef-9a5f-47de-aff5-33f04f362668<br />
| -<br />
|low-voltage-base-voltage<br />
|<br />
|-<br />
|14<br />
|PowerTransformer<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
| -<br />
|Transformer<br />
|<br />
|-<br />
|15<br />
|GroundingImpedance<br />
|544ecb76-3546-4c7a-a6b8-b424ec3c090f<br />
| -<br />
|Erdschlussdrossel<br />
|<br />
|-<br />
|16<br />
|PetersenCoil<br />
|50904041-d7aa-4b3b-8ef7-dbff8a65f37e<br />
| -<br />
|Petersenspule<br />
|<br />
|-<br />
|17<br />
|EarthFaultCompensator<br />
|131fb478-24ce-47af-98d9-e52285be0876<br />
| -<br />
|Erdungswiderstand<br />
|<br />
|-<br />
|18<br />
|MeasurementPoint<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Messpunkt von LoadBreakSwitch<br />
|<br />
|-<br />
|19<br />
|LoadBreakSwitch<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
| -<br />
|Lastgangschalter<br />
|<br />
|-<br />
|20<br />
|Bay<br />
|1482836f-10a5-48aa-bcf0-553417b25142<br />
| -<br />
|low-voltage-bay<br />
|<br />
|-<br />
|21<br />
|VoltageLevel<br />
|348ee15f-c00d-4053-afe3-7227b4405276<br />
| -<br />
|low-voltage-voltage-level<br />
|<br />
|-<br />
|22<br />
|AcLineSegment<br />
|1efdad09-d26f-4f1b-be82-7f63ef474c42<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|north-ac-line-segment<br />
|<br />
|-<br />
|23<br />
|Junction<br />
|300a4ede-ad47-47cd-839f-f78cfc96e001<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|Muffe<br />
|<br />
|-<br />
|24<br />
|AcLineSegment<br />
|ebb8f129-3e4f-4200-bb96-ba384c911c83<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|south-ac-line-segment<br />
|<br />
|-<br />
|25<br />
|Line<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|<br />
|Leitung<br />
|<br />
|-<br />
|26<br />
|SubGeographicalRegion<br />
|e238b44f-4d98-40c2-a1c9-6f72b10278f4<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
|Teilnetzgebiet<br />
|<br />
|-<br />
|27<br />
|LineType<br />
|c86d89fd-0662-4872-b0fe-9f0326718c9a<br />
| -<br />
|Leitungstyp<br />
|<br />
|-<br />
|28<br />
|GeographicalRegion<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
| -<br />
|Netzgebiet<br />
|<br />
|-<br />
|29<br />
|EnergyConsumer<br />
|f5babac5-e8c3-4b74-9620-237c08bd282d<br />
| -<br />
|Energieverbraucher<br />
|<br />
|-<br />
|32<br />
|TapChangerState<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Akt. Stellung der Transformatorstufenschalter<br />
|<br />
|-<br />
|33<br />
|Measurement<br />
| -<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
|Messung unterhalb des Transformators<br />
|<br />
|-<br />
|37<br />
|ControlStage<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Regelstufe der Einspeiser<br />
|<br />
|-<br />
|38<br />
|OperatingState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Betriebszustand der Einspeiser<br />
|<br />
|-<br />
|39<br />
|SwitchState<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Akt. Schalterstellungen<br />
|<br />
|-<br />
|40<br />
|TapChanger<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Transformatorstufenschalter<br />
|<br />
|-<br />
|41<br />
|CommunicationState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Kommunikationsstatus der Einspeiser<br />
|<br />
|-<br />
|42<br />
|EnergySource:Asset<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Einspeiserstammdaten<br />
|<br />
|-<br />
|43<br />
|AssetOwner:Organisation<br />
|dc896fa9-746d-42b2-8163-44c3248469d2<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Anlagenbetreiberrolle des Einspeisers<br />
|<br />
|-<br />
|44<br />
|Operator:Organisation<br />
|8db20a4b-8a1a-4799-aefc-9910dc99dedf<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Betreiber des Einspeisers<br />
|<br />
|-<br />
|45<br />
|EnergySourceLocation:Location<br />
|e916152a-4aaf-4a07-8aa5-ee9b7d06d525<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Standort des Einspeisers<br />
|<br />
|-<br />
|46<br />
|AssetOwnership<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b811<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Eigentumsverhätnisse des Einspeisers<br />
|<br />
|-<br />
|47<br />
|Terminal<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
| -<br />
|Terminal des Transformators<br />
|<br />
|}<br />
<br />
=Stresstest-Modell=<br />
Beinhaltet ein zufällig generiertes topologisches Modell. Für Performance- und Lasttests wird eine hohe Anzahl an Elementen erstellt.<br />
{{Warning|text=Diese Option ist in '''CIM-Cache Ertüchtigung Stufe I''' und '''CIM-Cache Ertüchtigung Stufe II''' kein Bestandteil der Beauftragung!}}<br />
<br />
=Realmodell=<br />
Dieses Modell beinhaltet ein reales, aber anonymisiertes Netzmodell. Folgende Schritte sind hier durchzuführen (Beispiel bezieht sich auf Windows-Umgebung):<br />
#Auschecken des entsprechenden git-Projektes: git-Link https://git.eclipse.org/r/openk-platform/org.eclipse.openk-platform.openk-repo mit dem Branch CR04<br />
#Innerhalb der Konsole in das Verzeichnis ROOT_PATH wechseln:<pre>cd LocalDirectory\git.openk\cim-cache</pre><br />
#Aufrufen der BAT-Datei zum Bauen des CIM-Cache:<pre>build-cim-cache.bat</pre><br />
#Innerhalb der Konsole in das folgende Verzeichnis wechseln:<pre>cd org-eclipse-openk-sourcesystem-mockupstatictopology\service</pre><br />
#Das Quellsystem-Mock-Up mit dem folgenden Befehl starten:<pre>java -jar target\mock-up-static-topology-service-0.0.1-SNAPSHOT.jar</pre><br />
#Abfrage des Default-Referenzmodels via Web-Browser: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
#Laden des anonymisiertes Netzmodells via POST-Request (z.B. mit RESTClient auf Firefox) <pre> "http://localhost:9518/command/execute" und dem Body "Inhalt der RDF-Datei"</pre><br />
#Prüfen, ob das anonymisiertes Netzmodell nun im Mock-up zur Verfügung steht: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
<br />
Somit können nun Domain-Module bzw. User-Module diese Topologie zu Test- oder Demonstrierzwecke verwenden.</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Datei:CIM-Model_reference-model.svg&diff=1256
Datei:CIM-Model reference-model.svg
2019-02-12T18:21:16Z
<p>EThume: EThume lud eine neue Version von Datei:CIM-Model reference-model.svg hoch</p>
<hr />
<div></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Mock-Up-Static-Topology&diff=1255
Mock-Up-Static-Topology
2019-02-12T18:20:35Z
<p>EThume: /* Elemente */</p>
<hr />
<div>__TOC__<br />
<br />
Dieser Dienst simuliert Quellsysteme, die topologische Elemente und Verknüpfungen über die [[Quellsystem-API]] zur Verfügung stellen.<br />
<br />
Für Testzwecke werden die verschiedenen Topologievarianten angeboten:<br />
<br />
=Vollständiges Referenzmodell=<br />
Der Zweck des vollständigen Referenzmodells liegt in der Funktionsüberprüfung der datennutzenden Domänen- und Nutzermodule.<br />
Daher sind alle unterstützten topologischen Elemente und Entitäten sowie deren Verknüpfung enthalten. Der Fokus liegt auf Vollständigkeit und Übersichtlichkeit, nicht auf Größe oder Sinnhaftigkeit des Modells.<br />
<br />
Das aktuell verwendete Referenzmodell ist im Folgenden definiert:<br />
<br />
[[Datei:CIM-Model_reference-model.svg]]<br />
<br />
==Elemente==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Nr.<br />
!Ressourcentyp<br />
!MRID<br />
!Bezugspunkt<br />
!Beschreibung<br />
!Eigenschaften<br />
|-<br />
|1<br />
|TopologyId<br />
|random<br />
| -<br />
|ID der Toplogie<br />
|<br />
|-<br />
|2<br />
|EnergySource<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
| -<br />
|Einspeiser<br />
|<br />
|-<br />
|3<br />
|Plant<br />
|0692e320-3ce6-47c4-bc57-525f9da47373<br />
| -<br />
|Kraftwerk<br />
|<br />
|-<br />
|4<br />
|SubstationType<br />
|3867ec39-1816-4905-b4a3-cc0d3678c269<br />
| -<br />
|Typ des Umspannwerks<br />
|<br />
|-<br />
|5<br />
|Substation<br />
|89edf801-13c2-4fb6-9fe1-4c01b7b07b21<br />
| -<br />
|Umspannwerk<br />
|<br />
|-<br />
|6<br />
|VoltageLevel<br />
|c8be6aa9-45f9-40de-aa1f-6e6c4f4ba46d<br />
| -<br />
|mid-voltage-voltage-level<br />
|<br />
|-<br />
|7<br />
|MeasurementPoint<br />
| -<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
|Messpunkt von breaker<br />
|<br />
|-<br />
|8<br />
|Breaker<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
| -<br />
|Leistungsschalter<br />
|<br />
|-<br />
|9<br />
|Disconnector<br />
|1c0b7ae1-1d28-4599-8659-ddda708b31c1<br />
| -<br />
|Trenner<br />
|<br />
|-<br />
|10<br />
|Bay<br />
|3569b278-014f-4584-af9d-b4fc1e39830f<br />
| -<br />
|mid-voltage-bay<br />
|<br />
|-<br />
|11<br />
|BusbarSection<br />
|b24dc203-7253-4ead-bf61-6e90e9b5ce21<br />
| -<br />
|Sammelschiene<br />
|<br />
|-<br />
|12<br />
|BaseVoltage<br />
|ea4cf040-cb88-4978-a3a4-630a8f144e4b<br />
| -<br />
|mid-voltage-base-voltage<br />
|<br />
|-<br />
|13<br />
|BaseVoltage<br />
|9542f9ef-9a5f-47de-aff5-33f04f362668<br />
| -<br />
|low-voltage-base-voltage<br />
|<br />
|-<br />
|14<br />
|PowerTransformer<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
| -<br />
|Transformer<br />
|<br />
|-<br />
|15<br />
|GroundingImpedance<br />
|544ecb76-3546-4c7a-a6b8-b424ec3c090f<br />
| -<br />
|Erdschlussdrossel<br />
|<br />
|-<br />
|16<br />
|PetersenCoil<br />
|50904041-d7aa-4b3b-8ef7-dbff8a65f37e<br />
| -<br />
|Petersenspule<br />
|<br />
|-<br />
|17<br />
|EarthFaultCompensator<br />
|131fb478-24ce-47af-98d9-e52285be0876<br />
| -<br />
|Erdungswiderstand<br />
|<br />
|-<br />
|18<br />
|MeasurementPoint<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Messpunkt von LoadBreakSwitch<br />
|<br />
|-<br />
|19<br />
|LoadBreakSwitch<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
| -<br />
|Lastgangschalter<br />
|<br />
|-<br />
|20<br />
|Bay<br />
|1482836f-10a5-48aa-bcf0-553417b25142<br />
| -<br />
|low-voltage-bay<br />
|<br />
|-<br />
|21<br />
|VoltageLevel<br />
|348ee15f-c00d-4053-afe3-7227b4405276<br />
| -<br />
|low-voltage-voltage-level<br />
|<br />
|-<br />
|22<br />
|AcLineSegment<br />
|1efdad09-d26f-4f1b-be82-7f63ef474c42<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|north-ac-line-segment<br />
|<br />
|-<br />
|23<br />
|Junction<br />
|300a4ede-ad47-47cd-839f-f78cfc96e001<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|Muffe<br />
|<br />
|-<br />
|24<br />
|AcLineSegment<br />
|ebb8f129-3e4f-4200-bb96-ba384c911c83<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|south-ac-line-segment<br />
|<br />
|-<br />
|25<br />
|Line<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|<br />
|Leitung<br />
|<br />
|-<br />
|26<br />
|SubGeographicalRegion<br />
|e238b44f-4d98-40c2-a1c9-6f72b10278f4<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
|Teilnetzgebiet<br />
|<br />
|-<br />
|27<br />
|LineType<br />
|c86d89fd-0662-4872-b0fe-9f0326718c9a<br />
| -<br />
|Leitungstyp<br />
|<br />
|-<br />
|28<br />
|GeographicalRegion<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
| -<br />
|Netzgebiet<br />
|<br />
|-<br />
|29<br />
|EnergyConsumer<br />
|f5babac5-e8c3-4b74-9620-237c08bd282d<br />
| -<br />
|Energieverbraucher<br />
|<br />
|-<br />
|32<br />
|TapChangerState<br />
| -<br />
| -<br />
|Akt. Stellung der Transformatorstufenschalter<br />
|<br />
|-<br />
|33<br />
|Measurement<br />
| -<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
|Messung unterhalb des Transformators<br />
|<br />
|-<br />
|37<br />
|ControlStage<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Regelstufe der Einspeiser<br />
|<br />
|-<br />
|38<br />
|OperatingState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Betriebszustand der Einspeiser<br />
|<br />
|-<br />
|39<br />
|SwitchState<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Akt. Schalterstellungen<br />
|<br />
|-<br />
|40<br />
|TapChanger<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Transformatorstufenschalter<br />
|<br />
|-<br />
|41<br />
|CommunicationState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Kommunikationsstatus der Einspeiser<br />
|<br />
|-<br />
|42<br />
|EnergySource:Asset<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Einspeiserstammdaten<br />
|<br />
|-<br />
|43<br />
|AssetOwner:Organisation<br />
|dc896fa9-746d-42b2-8163-44c3248469d2<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Anlagenbetreiberrolle des Einspeisers<br />
|<br />
|-<br />
|44<br />
|Operator:Organisation<br />
|8db20a4b-8a1a-4799-aefc-9910dc99dedf<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Betreiber des Einspeisers<br />
|<br />
|-<br />
|45<br />
|EnergySourceLocation:Location<br />
|e916152a-4aaf-4a07-8aa5-ee9b7d06d525<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Standort des Einspeisers<br />
|<br />
|-<br />
|46<br />
|AssetOwnership<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b811<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Eigentumsverhätnisse des Einspeisers<br />
|<br />
|-<br />
|47<br />
|Terminal<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
| -<br />
|Terminal des Transformators<br />
|<br />
|}<br />
<br />
=Stresstest-Modell=<br />
Beinhaltet ein zufällig generiertes topologisches Modell. Für Performance- und Lasttests wird eine hohe Anzahl an Elementen erstellt.<br />
{{Warning|text=Diese Option ist in '''CIM-Cache Ertüchtigung Stufe I''' und '''CIM-Cache Ertüchtigung Stufe II''' kein Bestandteil der Beauftragung!}}<br />
<br />
=Realmodell=<br />
Dieses Modell beinhaltet ein reales, aber anonymisiertes Netzmodell. Folgende Schritte sind hier durchzuführen (Beispiel bezieht sich auf Windows-Umgebung):<br />
#Auschecken des entsprechenden git-Projektes: git-Link https://git.eclipse.org/r/openk-platform/org.eclipse.openk-platform.openk-repo mit dem Branch CR04<br />
#Innerhalb der Konsole in das Verzeichnis ROOT_PATH wechseln:<pre>cd LocalDirectory\git.openk\cim-cache</pre><br />
#Aufrufen der BAT-Datei zum Bauen des CIM-Cache:<pre>build-cim-cache.bat</pre><br />
#Innerhalb der Konsole in das folgende Verzeichnis wechseln:<pre>cd org-eclipse-openk-sourcesystem-mockupstatictopology\service</pre><br />
#Das Quellsystem-Mock-Up mit dem folgenden Befehl starten:<pre>java -jar target\mock-up-static-topology-service-0.0.1-SNAPSHOT.jar</pre><br />
#Abfrage des Default-Referenzmodels via Web-Browser: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
#Laden des anonymisiertes Netzmodells via POST-Request (z.B. mit RESTClient auf Firefox) <pre> "http://localhost:9518/command/execute" und dem Body "Inhalt der RDF-Datei"</pre><br />
#Prüfen, ob das anonymisiertes Netzmodell nun im Mock-up zur Verfügung steht: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
<br />
Somit können nun Domain-Module bzw. User-Module diese Topologie zu Test- oder Demonstrierzwecke verwenden.</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1249
Domänen-API
2019-02-08T10:35:07Z
<p>EThume: /* basePath: /domain/electricity/measurement */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1248
Domänen-API
2019-02-08T10:33:49Z
<p>EThume: /* basePath: /domain/electricity/topology-state */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1247
Domänen-API
2019-02-08T10:33:07Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1246
Domänen-API
2019-02-08T10:32:39Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2_with_link|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1245
Domänen-API
2019-02-08T10:31:34Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2_with_link|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2_with_link|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2_with_link|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1244
Domänen-API
2019-02-08T10:31:13Z
<p>EThume: /* basePath: /domain/electricity/asset-data */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1243
Domänen-API
2019-02-08T10:30:59Z
<p>EThume: /* basePath: /domain/common/contact-data */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1242
Domänen-API
2019-02-07T11:09:11Z
<p>EThume: /* basePath: /domain/electricity/topology-state */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1241
Domänen-API
2019-02-07T11:08:30Z
<p>EThume: /* basePath: /domain/electricity/measurement */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1240
Domänen-API
2019-02-07T11:08:05Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1239
Domänen-API
2019-02-07T11:07:36Z
<p>EThume: /* basePath: /domain/common/contact-data */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1238
Domänen-API
2019-02-07T11:07:17Z
<p>EThume: /* basePath: /domain/electricity/asset-data */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1237
Domänen-API
2019-02-06T16:53:35Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1236
Domänen-API
2019-02-06T16:52:19Z
<p>EThume: /* basePath: /domain/electricity/static-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Inhalt topologischer Container<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = equipment-container-content|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.equipment-container-content_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1235
Domänen-API
2019-02-06T16:47:23Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = 2}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Dom%C3%A4nen-API&diff=1234
Domänen-API
2019-02-06T16:46:09Z
<p>EThume: /* basePath: /domain/electricity/dynamic-topology */</p>
<hr />
<div>Die Domänen-API (Domain API) bildet die Gesamtheit aller angebotenen Schnittstellen der fachlichen Domänen-Module. Da der Einsatz der Domänen-Module pro Netzbetreiber individuell sein kann, können die jeweils unterstützten Anwendungsfälle und Schnittstellen-Methoden varieren (z. B.: Wer Anlagestammdaten abfragen möchte, muss das Domänen-Modul [[AnlageDatenManagement|AnlageDatenManagement (ADM)]] betreiben.)<br />
<br />
Grundsätzlich bieten Domänen-Module fachlich wiederverwendbare Funktionen an. Im Gegensatz zur [[Quellsystem-API]] ermöglichen die Schnittellen der Domänen-Module komfortable, fachliche Abfragen sowie umfassende Selektions- und Filtermöglichkeiten.<br />
<br />
Es ist grundsätzlich denkbar, dass auf Ebene der Domänen-Module Software eingesetzt wird, die nicht im Standard-oK-Portfolie enthalten ist. An dieser Stelle wird daher ausschließlich die Domänen-API (Domain API) definiert, die als gemeinsamer oK-Standard Verwendung findet.<br />
Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) ([[TopologieDatenManagement|TopologieDatenManagement (TDM)]], [[MessDatenManagement|MessDatenManagement (MDM)]]) implementiert werden:<br />
<br />
<br />
__TOC__<br />
<br />
<br />
==basePath: /domain/common/contact-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Unternehmen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/common/contact-data|name = organisations|language = de|protocol = http|host = api.openk.de|file = domain.common.contact-data.organisations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/asset-data==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Anlagen-Eigentumsverhältnisse<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = asset-ownerships|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.asset-ownerships_GET_3_de.open-api.yaml|revision = 3}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstammdaten<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-sources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-sources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|-<br />
|Einspeiserstandorte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = asset-data.openk.de|path = domain/electricity/asset-data|name = energy-source-locations|language = de|protocol = http|host = api.openk.de|file = domain.electricity.asset-data.energy-source-locations_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>asset-data v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/dynamic-topology==<br />
{{Information|text=Bei der Ausprägung der folgenden Schnittstellen wurde bewusst darauf geachtet, diese möglichst allgemeingültig und für eine Vielzahl künftiger Anwendungsfälle zu konzipieren. Damit unterstützen die im Rahmen des Projektes "CIM-Cache Ertüchtigung Stufe 1" entstandenen Schnittstellen eine Obermenge der definierten Anwendungsfälle, Selektions- bzw. Filterkriterien. Die Spalte "Ertüchtigung Stufe 1" der jeweiligen Schnittstellendefinition beschreibt die bereits jetzt durch den CIM-Cache ermöglichten Abfragen.<br />
<p>Hierbei gelten folgende Konventionen:<br />
*<b>"?"</b> frei wählbar gemäß Schnittstellendefinition<br />
*<b>" "</b> Parameter nicht unterstützt<br />
*<b>"<< >>"</b> Beschreibung des zu ersetzenden Wertes<br />
</p>}}<br />
<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Typ<br />
!Beschreibung<br />
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"<br />
|-<br />
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font><br />
|Topologie<br />
|{{REST-GET_2|name = topology|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.topology_GET_2_de.open-api.yaml|revision = Revision 2 (CIM 17v07)}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&connections-state=Ignore&selector=All Abfrage der gesamten statischen Topologie]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|Ignore<br />
|All<br />
|<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/topology?revision=2&entry-point-id=abddaf44-13e6-46a3-8f87-0d675ea78659&connection-state=Normal&selector=Behind Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators]</i><br />
|2<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<eindeutige Kennung des Transformators>><br />
|Normal<br />
|Behind<br />
|<br />
|}<br />
|-<br />
|topologische Ressourcen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topological-resources|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topological-resources_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|-<br />
|topologische Ressourcen<br />
|<br />
|{{REST-GET_2|name = power-system-resources|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resources_GET_1_de.open-api.yaml|revision = Revision 1 (CIM 17v07)}}<br />
<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!power-system-resource-types<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resources?revision=1&power-system-resource-types=power-transformer Abfrage der topologischen Elemente (Entitäten)]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<<Liste der abzufragenden Ressourcentypen>><br />
|<<eindeutige Kennung des Element-Containers>><br />
|<br />
|<br />
|?<br />
|}<br />
|-<br />
|topologische Ressourcentypen<br />
|Eigenschaften<br />
|{{REST-GET_2|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|relative-path = domain/electricity/dynamic-topology/domain.electricity.dynamic-topology.power-system-resource-types_GET_1_de.open-api.yaml|revision = Revision 1 (CIM 17v07)}}<br />
|<br />
{| class="wikitable sortable"<br />
!Anwendungsfall<br />
!revision<br />
!timestamp<br />
!source<br />
!user-id<br />
!message-id<br />
!topology-id<br />
!entry-point-id<br />
!connection-state<br />
!selector<br />
!fetch-type<br />
|-<br />
|<i>[http://dynamic-topology.openk.de/domain/electricity/dynamic-topology/power-system-resource-types?revision=1 Abfrage aller topologischen Elementtypen]</i><br />
|1<br />
|?<br />
|?<br />
|?<br />
|?<br />
|?<br />
|<br />
|<br />
|<br />
|<br />
|}<br />
|-<br />
|verbundene topologische Verbindungselemente<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|<br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/dynamic-topology|name = connected-connecting-equipments|language = de|protocol = http|host = api.openk.de|file = domain.electricity.dynamic-topology.connected-connecting-equipments_GET_1_de.open-api.yaml|revision = 1}}<br />
|<br />
|<br />
|<br />
|}<br />
<br />
==basePath: /domain/electricity/measurement==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktuelle Messwerte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-values|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-values_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|-<br />
|Messpunkte<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = measurement.openk.de|path = domain/electricity/measurement|name = measurement-points|language = de|protocol = http|host = api.openk.de|file = domain.electricity.measurement.measurement-points_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>measurement v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/static-topology==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|Nennspannungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = base-voltages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.base-voltages_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|-<br />
|Topologiekennung<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = dynamic-topology.openk.de|path = domain/electricity/static-topology|name = topology-id|language = de|protocol = http|host = api.openk.de|file = domain.electricity.static-topology.topology-id_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>static-topology v2.2</li></ul><br />
|}<br />
<br />
==basePath: /domain/electricity/topology-state==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Bezeichnung<br />
!Beschreibung<br />
!bereitstellendes System<br />
|-<br />
|aktueller Betriebszustand der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = operating-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.operating-states_GET_2_de.open-api.yaml|revision = 2}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktueller Kommunikationsstatus der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = communication-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.communication-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Regelstufe der Einspeiser<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = control-stages|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.control-stages_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Schalterstellungen<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = switch-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.switch-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|-<br />
|aktuelle Stellung der Transformatorstufenschalter<br/><font color="MediumSeaGreen">(neu in CIM Cache Stufe II)</font><br />
|{{REST-GET_2_with_link|link-host = topology-state.openk.de|path = domain/electricity/topology-state|name = tap-changer-states|language = de|protocol = http|host = api.openk.de|file = domain.electricity.topology-state.tap-changer-states_GET_1_de.open-api.yaml|revision = 1}}<br />
|<ul><li>topology-state v2.2</li></ul><br />
|}</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Datei:CIM-Model_reference-model.svg&diff=1233
Datei:CIM-Model reference-model.svg
2019-02-06T15:43:35Z
<p>EThume: EThume lud eine neue Version von Datei:CIM-Model reference-model.svg hoch</p>
<hr />
<div></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Datei:CIM-Model_reference-model.svg&diff=1232
Datei:CIM-Model reference-model.svg
2019-02-06T15:23:18Z
<p>EThume: EThume lud eine neue Version von Datei:CIM-Model reference-model.svg hoch</p>
<hr />
<div></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Datei:CIM-Model_reference-model.svg&diff=1231
Datei:CIM-Model reference-model.svg
2019-02-06T15:18:46Z
<p>EThume: EThume lud eine neue Version von Datei:CIM-Model reference-model.svg hoch</p>
<hr />
<div></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Datei:CIM-Model_reference-model.svg&diff=1230
Datei:CIM-Model reference-model.svg
2019-02-06T14:42:33Z
<p>EThume: EThume lud eine neue Version von Datei:CIM-Model reference-model.svg hoch</p>
<hr />
<div></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Mock-Up-Static-Topology&diff=1228
Mock-Up-Static-Topology
2019-02-06T14:38:23Z
<p>EThume: /* Vollständiges Referenzmodell */</p>
<hr />
<div>__TOC__<br />
<br />
Dieser Dienst simuliert Quellsysteme, die topologische Elemente und Verknüpfungen über die [[Quellsystem-API]] zur Verfügung stellen.<br />
<br />
Für Testzwecke werden die verschiedenen Topologievarianten angeboten:<br />
<br />
=Vollständiges Referenzmodell=<br />
Der Zweck des vollständigen Referenzmodells liegt in der Funktionsüberprüfung der datennutzenden Domänen- und Nutzermodule.<br />
Daher sind alle unterstützten topologischen Elemente und Entitäten sowie deren Verknüpfung enthalten. Der Fokus liegt auf Vollständigkeit und Übersichtlichkeit, nicht auf Größe oder Sinnhaftigkeit des Modells.<br />
<br />
Das aktuell verwendete Referenzmodell ist im Folgenden definiert:<br />
<br />
[[Datei:CIM-Model_reference-model.svg]]<br />
<br />
==Elemente==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Nr.<br />
!Ressourcentyp<br />
!MRID<br />
!Bezugspunkt<br />
!Beschreibung<br />
!Eigenschaften<br />
|-<br />
|1<br />
|TopologyId<br />
|random<br />
| -<br />
|ID der Toplogie<br />
|<br />
|-<br />
|2<br />
|EnergySource<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
| -<br />
|Einspeiser<br />
|<br />
|-<br />
|3<br />
|Plant<br />
|0692e320-3ce6-47c4-bc57-525f9da47373<br />
| -<br />
|Kraftwerk<br />
|<br />
|-<br />
|4<br />
|SubstationType<br />
|3867ec39-1816-4905-b4a3-cc0d3678c269<br />
| -<br />
|Typ des Umspannwerks<br />
|<br />
|-<br />
|5<br />
|Substation<br />
|89edf801-13c2-4fb6-9fe1-4c01b7b07b21<br />
| -<br />
|Umspannwerk<br />
|<br />
|-<br />
|6<br />
|VoltageLevel<br />
|c8be6aa9-45f9-40de-aa1f-6e6c4f4ba46d<br />
| -<br />
|mid-voltage-voltage-level<br />
|<br />
|-<br />
|7<br />
|MeasurementPoint<br />
| -<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
|Messpunkt von breaker<br />
|<br />
|-<br />
|8<br />
|Breaker<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
| -<br />
|Leistungsschalter<br />
|<br />
|-<br />
|9<br />
|Disconnector<br />
|1c0b7ae1-1d28-4599-8659-ddda708b31c1<br />
| -<br />
|Trenner<br />
|<br />
|-<br />
|10<br />
|Bay<br />
|3569b278-014f-4584-af9d-b4fc1e39830f<br />
| -<br />
|mid-voltage-bay<br />
|<br />
|-<br />
|11<br />
|BusbarSection<br />
|b24dc203-7253-4ead-bf61-6e90e9b5ce21<br />
| -<br />
|Sammelschiene<br />
|<br />
|-<br />
|12<br />
|BaseVoltage<br />
|ea4cf040-cb88-4978-a3a4-630a8f144e4b<br />
| -<br />
|mid-voltage-base-voltage<br />
|<br />
|-<br />
|13<br />
|BaseVoltage<br />
|9542f9ef-9a5f-47de-aff5-33f04f362668<br />
| -<br />
|low-voltage-base-voltage<br />
|<br />
|-<br />
|14<br />
|PowerTransformer<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
| -<br />
|Transformer<br />
|<br />
|-<br />
|15<br />
|GroundingImpedance<br />
|544ecb76-3546-4c7a-a6b8-b424ec3c090f<br />
| -<br />
|Erdschlussdrossel<br />
|<br />
|-<br />
|16<br />
|PetersenCoil<br />
|50904041-d7aa-4b3b-8ef7-dbff8a65f37e<br />
| -<br />
|Petersenspule<br />
|<br />
|-<br />
|17<br />
|EarthFaultCompensator<br />
|131fb478-24ce-47af-98d9-e52285be0876<br />
| -<br />
|Erdungswiderstand<br />
|<br />
|-<br />
|18<br />
|MeasurementPoint<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Messpunkt von LoadBreakSwitch<br />
|<br />
|-<br />
|19<br />
|LoadBreakSwitch<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
| -<br />
|Lastgangschalter<br />
|<br />
|-<br />
|20<br />
|Bay<br />
|1482836f-10a5-48aa-bcf0-553417b25142<br />
| -<br />
|low-voltage-bay<br />
|<br />
|-<br />
|21<br />
|VoltageLevel<br />
|348ee15f-c00d-4053-afe3-7227b4405276<br />
| -<br />
|low-voltage-voltage-level<br />
|<br />
|-<br />
|22<br />
|AcLineSegment<br />
|1efdad09-d26f-4f1b-be82-7f63ef474c42<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|north-ac-line-segment<br />
|<br />
|-<br />
|23<br />
|Junction<br />
|300a4ede-ad47-47cd-839f-f78cfc96e001<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|Muffe<br />
|<br />
|-<br />
|24<br />
|AcLineSegment<br />
|ebb8f129-3e4f-4200-bb96-ba384c911c83<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|south-ac-line-segment<br />
|<br />
|-<br />
|25<br />
|Line<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|<br />
|Leitung<br />
|<br />
|-<br />
|26<br />
|SubGeographicalRegion<br />
|e238b44f-4d98-40c2-a1c9-6f72b10278f4<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
|Teilnetzgebiet<br />
|<br />
|-<br />
|27<br />
|LineType<br />
|c86d89fd-0662-4872-b0fe-9f0326718c9a<br />
| -<br />
|Leitungstyp<br />
|<br />
|-<br />
|28<br />
|GeographicalRegion<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
| -<br />
|Netzgebiet<br />
|<br />
|-<br />
|29<br />
|EnergyConsumer<br />
|f5babac5-e8c3-4b74-9620-237c08bd282d<br />
| -<br />
|Energieverbraucher<br />
|<br />
|-<br />
|32<br />
|TapChangerState<br />
| -<br />
|278afbf2-2923-11e9-b210-d663bd873d93<br />
|Akt. Stellung der Transformatorstufenschalter<br />
|<br />
|-<br />
|33<br />
|Measurement<br />
| -<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
|Messung unterhalb des Transformators<br />
|<br />
|-<br />
|37<br />
|ControlStage<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Regelstufe der Einspeiser<br />
|<br />
|-<br />
|38<br />
|OperatingState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Betriebszustand der Einspeiser<br />
|<br />
|-<br />
|39<br />
|SwitchState<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Akt. Schalterstellungen<br />
|<br />
|-<br />
|40<br />
|TapChanger<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Transformatorstufenschalter<br />
|<br />
|-<br />
|41<br />
|CommunicationState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Kommunikationsstatus der Einspeiser<br />
|<br />
|-<br />
|42<br />
|EnergySource:Asset<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Einspeiserstammdaten<br />
|<br />
|-<br />
|43<br />
|AssetOwner:Organisation<br />
|dc896fa9-746d-42b2-8163-44c3248469d2<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Anlagenbetreiberrolle des Einspeisers<br />
|<br />
|-<br />
|44<br />
|Operator:Organisation<br />
|8db20a4b-8a1a-4799-aefc-9910dc99dedf<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Betreiber des Einspeisers<br />
|<br />
|-<br />
|45<br />
|EnergySourceLocation:Location<br />
|e916152a-4aaf-4a07-8aa5-ee9b7d06d525<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Standort des Einspeisers<br />
|<br />
|-<br />
|46<br />
|AssetOwnership<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b811<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Eigentumsverhätnisse des Einspeisers<br />
|<br />
|-<br />
|47<br />
|Terminal<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
| -<br />
|Terminal des Transformators<br />
|<br />
|-<br />
|48<br />
|PowerTransformerEnd<br />
|278afbf2-2923-11e9-b210-d663bd873d93 <br />
| -<br />
|Windung des Transformators (Sekundärseite)<br />
|<br />
|}<br />
<br />
=Stresstest-Modell=<br />
Beinhaltet ein zufällig generiertes topologisches Modell. Für Performance- und Lasttests wird eine hohe Anzahl an Elementen erstellt.<br />
{{Warning|text=Diese Option ist in '''CIM-Cache Ertüchtigung Stufe I''' und '''CIM-Cache Ertüchtigung Stufe II''' kein Bestandteil der Beauftragung!}}<br />
<br />
=Realmodell=<br />
Dieses Modell beinhaltet ein reales, aber anonymisiertes Netzmodell. Folgende Schritte sind hier durchzuführen (Beispiel bezieht sich auf Windows-Umgebung):<br />
#Auschecken des entsprechenden git-Projektes: git-Link https://git.eclipse.org/r/openk-platform/org.eclipse.openk-platform.openk-repo mit dem Branch CR04<br />
#Innerhalb der Konsole in das Verzeichnis ROOT_PATH wechseln:<pre>cd LocalDirectory\git.openk\cim-cache</pre><br />
#Aufrufen der BAT-Datei zum Bauen des CIM-Cache:<pre>build-cim-cache.bat</pre><br />
#Innerhalb der Konsole in das folgende Verzeichnis wechseln:<pre>cd org-eclipse-openk-sourcesystem-mockupstatictopology\service</pre><br />
#Das Quellsystem-Mock-Up mit dem folgenden Befehl starten:<pre>java -jar target\mock-up-static-topology-service-0.0.1-SNAPSHOT.jar</pre><br />
#Abfrage des Default-Referenzmodels via Web-Browser: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
#Laden des anonymisiertes Netzmodells via POST-Request (z.B. mit RESTClient auf Firefox) <pre> "http://localhost:9518/command/execute" und dem Body "Inhalt der RDF-Datei"</pre><br />
#Prüfen, ob das anonymisiertes Netzmodell nun im Mock-up zur Verfügung steht: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
<br />
Somit können nun Domain-Module bzw. User-Module diese Topologie zu Test- oder Demonstrierzwecke verwenden.</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Mock-Up-Static-Topology&diff=1227
Mock-Up-Static-Topology
2019-02-06T13:18:42Z
<p>EThume: </p>
<hr />
<div>__TOC__<br />
<br />
Dieser Dienst simuliert Quellsysteme, die topologische Elemente und Verknüpfungen über die [[Quellsystem-API]] zur Verfügung stellen.<br />
<br />
Für Testzwecke werden die verschiedenen Topologievarianten angeboten:<br />
<br />
=Vollständiges Referenzmodell=<br />
Der Zweck des vollständigen Referenzmodells liegt in der Funktionsüberprüfung der datennutzenden Domänen- und Nutzermodule.<br />
Daher sind alle unterstützten topologischen Elemente und Entitäten sowie deren Verknüpfung enthalten. Der Fokus liegt auf Vollständigkeit und Übersichtlichkeit, nicht auf Größe oder Sinnhaftigkeit des Modells.<br />
<br />
Das aktuell verwendete Referenzmodell ist im Folgenden definiert:<br />
<br />
[[Datei:CIM-Model_reference-model.svg]]<br />
<br />
==Elemente==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Nr.<br />
!Ressourcentyp<br />
!MRID<br />
!Bezugspunkt<br />
!Beschreibung<br />
!Eigenschaften<br />
|-<br />
|1<br />
|TopologyId<br />
|random<br />
| -<br />
|ID der Toplogie<br />
|<br />
|-<br />
|2<br />
|EnergySource<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
| -<br />
|Einspeiser<br />
|<br />
|-<br />
|3<br />
|Plant<br />
|0692e320-3ce6-47c4-bc57-525f9da47373<br />
| -<br />
|Kraftwerk<br />
|<br />
|-<br />
|4<br />
|SubstationType<br />
|3867ec39-1816-4905-b4a3-cc0d3678c269<br />
| -<br />
|Typ des Umspannwerks<br />
|<br />
|-<br />
|5<br />
|Substation<br />
|89edf801-13c2-4fb6-9fe1-4c01b7b07b21<br />
| -<br />
|Umspannwerk<br />
|<br />
|-<br />
|6<br />
|VoltageLevel<br />
|c8be6aa9-45f9-40de-aa1f-6e6c4f4ba46d<br />
| -<br />
|mid-voltage-voltage-level<br />
|<br />
|-<br />
|7<br />
|MeasurementPoint<br />
| -<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
|Messpunkt von breaker<br />
|<br />
|-<br />
|8<br />
|Breaker<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
| -<br />
|Leistungsschalter<br />
|<br />
|-<br />
|9<br />
|Disconnector<br />
|1c0b7ae1-1d28-4599-8659-ddda708b31c1<br />
| -<br />
|Trenner<br />
|<br />
|-<br />
|10<br />
|Bay<br />
|3569b278-014f-4584-af9d-b4fc1e39830f<br />
| -<br />
|mid-voltage-bay<br />
|<br />
|-<br />
|11<br />
|BusbarSection<br />
|b24dc203-7253-4ead-bf61-6e90e9b5ce21<br />
| -<br />
|Sammelschiene<br />
|<br />
|-<br />
|12<br />
|BaseVoltage<br />
|ea4cf040-cb88-4978-a3a4-630a8f144e4b<br />
| -<br />
|mid-voltage-base-voltage<br />
|<br />
|-<br />
|13<br />
|BaseVoltage<br />
|9542f9ef-9a5f-47de-aff5-33f04f362668<br />
| -<br />
|low-voltage-base-voltage<br />
|<br />
|-<br />
|14<br />
|PowerTransformer<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
| -<br />
|Transformer<br />
|<br />
|-<br />
|15<br />
|GroundingImpedance<br />
|544ecb76-3546-4c7a-a6b8-b424ec3c090f<br />
| -<br />
|Erdschlussdrossel<br />
|<br />
|-<br />
|16<br />
|PetersenCoil<br />
|50904041-d7aa-4b3b-8ef7-dbff8a65f37e<br />
| -<br />
|Petersenspule<br />
|<br />
|-<br />
|17<br />
|EarthFaultCompensator<br />
|131fb478-24ce-47af-98d9-e52285be0876<br />
| -<br />
|Erdungswiderstand<br />
|<br />
|-<br />
|18<br />
|MeasurementPoint<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Messpunkt von LoadBreakSwitch<br />
|<br />
|-<br />
|19<br />
|LoadBreakSwitch<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
| -<br />
|Lastgangschalter<br />
|<br />
|-<br />
|20<br />
|Bay<br />
|1482836f-10a5-48aa-bcf0-553417b25142<br />
| -<br />
|low-voltage-bay<br />
|<br />
|-<br />
|21<br />
|VoltageLevel<br />
|348ee15f-c00d-4053-afe3-7227b4405276<br />
| -<br />
|low-voltage-voltage-level<br />
|<br />
|-<br />
|22<br />
|AcLineSegment<br />
|1efdad09-d26f-4f1b-be82-7f63ef474c42<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|north-ac-line-segment<br />
|<br />
|-<br />
|23<br />
|Junction<br />
|300a4ede-ad47-47cd-839f-f78cfc96e001<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|Muffe<br />
|<br />
|-<br />
|24<br />
|AcLineSegment<br />
|ebb8f129-3e4f-4200-bb96-ba384c911c83<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|south-ac-line-segment<br />
|<br />
|-<br />
|25<br />
|Line<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|<br />
|Leitung<br />
|<br />
|-<br />
|26<br />
|SubGeographicalRegion<br />
|e238b44f-4d98-40c2-a1c9-6f72b10278f4<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
|Teilnetzgebiet<br />
|<br />
|-<br />
|27<br />
|LineType<br />
|c86d89fd-0662-4872-b0fe-9f0326718c9a<br />
| -<br />
|Leitungstyp<br />
|<br />
|-<br />
|28<br />
|GeographicalRegion<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
| -<br />
|Netzgebiet<br />
|<br />
|-<br />
|29<br />
|EnergyConsumer<br />
|f5babac5-e8c3-4b74-9620-237c08bd282d<br />
| -<br />
|Energieverbraucher<br />
|<br />
|-<br />
|32<br />
|TapChangerState<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Akt. Stellung der Transformatorstufenschalter<br />
|<br />
|-<br />
|33<br />
|Measurement<br />
| -<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
|Messung unterhalb des Transformators<br />
|<br />
|-<br />
|37<br />
|ControlStage<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Regelstufe der Einspeiser<br />
|<br />
|-<br />
|38<br />
|OperatingState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Betriebszustand der Einspeiser<br />
|<br />
|-<br />
|39<br />
|SwitchState<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Akt. Schalterstellungen<br />
|<br />
|-<br />
|40<br />
|TapChanger<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Transformatorstufenschalter<br />
|<br />
|-<br />
|41<br />
|CommunicationState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Kommunikationsstatus der Einspeiser<br />
|<br />
|-<br />
|42<br />
|EnergySource:Asset<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Einspeiserstammdaten<br />
|<br />
|-<br />
|43<br />
|AssetOwner:Organisation<br />
|dc896fa9-746d-42b2-8163-44c3248469d2<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Anlagenbetreiberrolle des Einspeisers<br />
|<br />
|-<br />
|44<br />
|Operator:Organisation<br />
|8db20a4b-8a1a-4799-aefc-9910dc99dedf<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Betreiber des Einspeisers<br />
|<br />
|-<br />
|45<br />
|EnergySourceLocation:Location<br />
|e916152a-4aaf-4a07-8aa5-ee9b7d06d525<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Standort des Einspeisers<br />
|<br />
|-<br />
|46<br />
|AssetOwnership<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b811<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Eigentumsverhätnisse des Einspeisers<br />
|<br />
|-<br />
|47<br />
|Terminal<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
| -<br />
|Terminal des Transformators<br />
|<br />
|}<br />
<br />
=Stresstest-Modell=<br />
Beinhaltet ein zufällig generiertes topologisches Modell. Für Performance- und Lasttests wird eine hohe Anzahl an Elementen erstellt.<br />
{{Warning|text=Diese Option ist in '''CIM-Cache Ertüchtigung Stufe I''' und '''CIM-Cache Ertüchtigung Stufe II''' kein Bestandteil der Beauftragung!}}<br />
<br />
=Realmodell=<br />
Dieses Modell beinhaltet ein reales, aber anonymisiertes Netzmodell. Folgende Schritte sind hier durchzuführen (Beispiel bezieht sich auf Windows-Umgebung):<br />
#Auschecken des entsprechenden git-Projektes: git-Link https://git.eclipse.org/r/openk-platform/org.eclipse.openk-platform.openk-repo mit dem Branch CR04<br />
#Innerhalb der Konsole in das Verzeichnis ROOT_PATH wechseln:<pre>cd LocalDirectory\git.openk\cim-cache</pre><br />
#Aufrufen der BAT-Datei zum Bauen des CIM-Cache:<pre>build-cim-cache.bat</pre><br />
#Innerhalb der Konsole in das folgende Verzeichnis wechseln:<pre>cd org-eclipse-openk-sourcesystem-mockupstatictopology\service</pre><br />
#Das Quellsystem-Mock-Up mit dem folgenden Befehl starten:<pre>java -jar target\mock-up-static-topology-service-0.0.1-SNAPSHOT.jar</pre><br />
#Abfrage des Default-Referenzmodels via Web-Browser: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
#Laden des anonymisiertes Netzmodells via POST-Request (z.B. mit RESTClient auf Firefox) <pre> "http://localhost:9518/command/execute" und dem Body "Inhalt der RDF-Datei"</pre><br />
#Prüfen, ob das anonymisiertes Netzmodell nun im Mock-up zur Verfügung steht: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
<br />
Somit können nun Domain-Module bzw. User-Module diese Topologie zu Test- oder Demonstrierzwecke verwenden.</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Datei:CIM-Model_reference-model.svg&diff=1179
Datei:CIM-Model reference-model.svg
2018-11-20T09:37:48Z
<p>EThume: EThume lud eine neue Version von Datei:CIM-Model reference-model.svg hoch</p>
<hr />
<div></div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Mock-Up-Static-Topology&diff=1178
Mock-Up-Static-Topology
2018-11-20T09:36:48Z
<p>EThume: /* Elemente */</p>
<hr />
<div>__TOC__<br />
<br />
Dieser Dienst simuliert Quellsysteme, die topologische Elemente und Verknüpfungen über die [[Quellsystem-API]] zur Verfügung stellen.<br />
<br />
Für Testzwecke werden die verschiedene Topologievarianten angeboten:<br />
<br />
=Vollständiges Referenzmodell=<br />
Der Zweck des vollständigen Referenzmodells liegt in der Funktionsüberprüfung der datennutzenden Domänen- und Nutzermodule.<br />
Daher sind alle unterstützten topologischen Elemente und Entitäten sowie deren Verknüpfung enthalten. Der Fokus liegt auf Vollständigkeit und Übersichtlichkeit, nicht auf Größe oder Sinnhaftigkeit des Modells.<br />
<br />
Das aktuell verwendete Referenzmodell ist im Folgenden definiert:<br />
<br />
[[Datei:CIM-Model_reference-model.svg]]<br />
<br />
==Elemente==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Nr.<br />
!Ressourcentyp<br />
!MRID<br />
!Bezugspunkt<br />
!Beschreibung<br />
!Eigenschaften<br />
|-<br />
|1<br />
|TopologyId<br />
|random<br />
| -<br />
|ID der Toplogie<br />
|<br />
|-<br />
|2<br />
|EnergySource<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
| -<br />
|Einspeiser<br />
|<br />
|-<br />
|3<br />
|Plant<br />
|0692e320-3ce6-47c4-bc57-525f9da47373<br />
| -<br />
|Kraftwerk<br />
|<br />
|-<br />
|4<br />
|SubstationType<br />
|3867ec39-1816-4905-b4a3-cc0d3678c269<br />
| -<br />
|Typ des Umspannwerks<br />
|<br />
|-<br />
|5<br />
|Substation<br />
|89edf801-13c2-4fb6-9fe1-4c01b7b07b21<br />
| -<br />
|Umspannwerk<br />
|<br />
|-<br />
|6<br />
|VoltageLevel<br />
|c8be6aa9-45f9-40de-aa1f-6e6c4f4ba46d<br />
| -<br />
|mid-voltage-voltage-level<br />
|<br />
|-<br />
|7<br />
|MeasurementPoint<br />
| -<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
|Messpunkt von breaker<br />
|<br />
|-<br />
|8<br />
|Breaker<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
| -<br />
|Leistungsschalter<br />
|<br />
|-<br />
|9<br />
|Disconnector<br />
|1c0b7ae1-1d28-4599-8659-ddda708b31c1<br />
| -<br />
|Trenner<br />
|<br />
|-<br />
|10<br />
|Bay<br />
|3569b278-014f-4584-af9d-b4fc1e39830f<br />
| -<br />
|mid-voltage-bay<br />
|<br />
|-<br />
|11<br />
|BusbarSection<br />
|b24dc203-7253-4ead-bf61-6e90e9b5ce21<br />
| -<br />
|Sammelschiene<br />
|<br />
|-<br />
|12<br />
|BaseVoltage<br />
|ea4cf040-cb88-4978-a3a4-630a8f144e4b<br />
| -<br />
|mid-voltage-base-voltage<br />
|<br />
|-<br />
|13<br />
|BaseVoltage<br />
|9542f9ef-9a5f-47de-aff5-33f04f362668<br />
| -<br />
|low-voltage-base-voltage<br />
|<br />
|-<br />
|14<br />
|PowerTransformer<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
| -<br />
|Transformer<br />
|<br />
|-<br />
|15<br />
|GroundingImpedance<br />
|544ecb76-3546-4c7a-a6b8-b424ec3c090f<br />
| -<br />
|Erdschlussdrossel<br />
|<br />
|-<br />
|16<br />
|PetersenCoil<br />
|50904041-d7aa-4b3b-8ef7-dbff8a65f37e<br />
| -<br />
|Petersenspule<br />
|<br />
|-<br />
|17<br />
|EarthFaultCompensator<br />
|131fb478-24ce-47af-98d9-e52285be0876<br />
| -<br />
|Erdungswiderstand<br />
|<br />
|-<br />
|18<br />
|MeasurementPoint<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Messpunkt von LoadBreakSwitch<br />
|<br />
|-<br />
|19<br />
|LoadBreakSwitch<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
| -<br />
|Lastgangschalter<br />
|<br />
|-<br />
|20<br />
|Bay<br />
|1482836f-10a5-48aa-bcf0-553417b25142<br />
| -<br />
|low-voltage-bay<br />
|<br />
|-<br />
|21<br />
|VoltageLevel<br />
|348ee15f-c00d-4053-afe3-7227b4405276<br />
| -<br />
|low-voltage-voltage-level<br />
|<br />
|-<br />
|22<br />
|AcLineSegment<br />
|1efdad09-d26f-4f1b-be82-7f63ef474c42<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|north-ac-line-segment<br />
|<br />
|-<br />
|23<br />
|Junction<br />
|300a4ede-ad47-47cd-839f-f78cfc96e001<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|Muffe<br />
|<br />
|-<br />
|24<br />
|AcLineSegment<br />
|ebb8f129-3e4f-4200-bb96-ba384c911c83<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|south-ac-line-segment<br />
|<br />
|-<br />
|25<br />
|Line<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|<br />
|Leitung<br />
|<br />
|-<br />
|26<br />
|SubGeographicalRegion<br />
|e238b44f-4d98-40c2-a1c9-6f72b10278f4<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
|Teilnetzgebiet<br />
|<br />
|-<br />
|27<br />
|LineType<br />
|c86d89fd-0662-4872-b0fe-9f0326718c9a<br />
| -<br />
|Leitungstyp<br />
|<br />
|-<br />
|28<br />
|GeographicalRegion<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
| -<br />
|Netzgebiet<br />
|<br />
|-<br />
|29<br />
|EnergyConsumer<br />
|f5babac5-e8c3-4b74-9620-237c08bd282d<br />
| -<br />
|Energieverbraucher<br />
|<br />
|-<br />
|32<br />
|TapChangerState<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Akt. Stellung der Transformatorstufenschalter<br />
|<br />
|-<br />
|33<br />
|Measurement<br />
| -<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
|Messung unterhalb des Transformators<br />
|<br />
|-<br />
|37<br />
|ControlStage<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Regelstufe der Einspeiser<br />
|<br />
|-<br />
|38<br />
|OperatingState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Betriebszustand der Einspeiser<br />
|<br />
|-<br />
|39<br />
|SwitchState<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Akt. Schalterstellungen<br />
|<br />
|-<br />
|40<br />
|TapChanger<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Transformatorstufenschalter<br />
|<br />
|-<br />
|41<br />
|CommunicationState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Kommunikationsstatus der Einspeiser<br />
|<br />
|-<br />
|42<br />
|EnergySource:Asset<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Einspeiserstammdaten<br />
|<br />
|-<br />
|43<br />
|AssetOwner:Organisation<br />
|dc896fa9-746d-42b2-8163-44c3248469d2<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Anlagenbetreiberrolle des Einspeisers<br />
|<br />
|-<br />
|44<br />
|Operator:Organisation<br />
|8db20a4b-8a1a-4799-aefc-9910dc99dedf<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Betreiber des Einspeisers<br />
|<br />
|-<br />
|45<br />
|EnergySourceLocation:Location<br />
|e916152a-4aaf-4a07-8aa5-ee9b7d06d525<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Standort des Einspeisers<br />
|<br />
|-<br />
|46<br />
|AssetOwnership<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b811<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Eigentumsverhätnisse des Einspeisers<br />
|<br />
|-<br />
|47<br />
|Terminal<br />
|55ee7075-0059-488e-84da-6cc4b0d9fd37<br />
| -<br />
|Terminal des Transformators<br />
|<br />
|}<br />
<br />
=Stresstest-Modell=<br />
Beinhaltet ein zufällig generiertes topologisches Modell. Für Performance- und Lasttests wird eine hohe Anzahl an Elementen erstellt.<br />
{{Warning|text=Diese Option ist in '''CIM-Cache Ertüchtigung Stufe I''' und '''CIM-Cache Ertüchtigung Stufe II''' kein Bestandteil der Beauftragung!}}<br />
<br />
=Realmodell=<br />
Dieses Modell beinhaltet ein reales, aber anonymisiertes Netzmodell. Folgende Schritte sind hier durchzuführen (Beispiel bezieht sich auf Windows-Umgebung):<br />
#Auschecken des entsprechenden git-Projektes: git-Link https://git.eclipse.org/r/openk-platform/org.eclipse.openk-platform.openk-repo mit dem Branch CR04<br />
#Innerhalb der Konsole in das Verzeichnis ROOT_PATH wechseln:<pre>cd LocalDirectory\git.openk\cim-cache</pre><br />
#Aufrufen der BAT-Datei zum Bauen des CIM-Cache:<pre>build-cim-cache.bat</pre><br />
#Innerhalb der Konsole in das folgende Verzeichnis wechseln:<pre>cd org-eclipse-openk-sourcesystem-mockupstatictopology\service</pre><br />
#Das Quellsystem-Mock-Up mit dem folgenden Befehl starten:<pre>java -jar target\mock-up-static-topology-service-0.0.1-SNAPSHOT.jar</pre><br />
#Abfrage des Default-Referenzmodels via Web-Browser: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
#Laden des anonymisiertes Netzmodells via POST-Request (z.B. mit RESTClient auf Firefox) <pre> "http://localhost:9518/command/execute" und dem Body "Inhalt der RDF-Datei"</pre><br />
#Prüfen, ob das anonymisiertes Netzmodell nun im Mock-up zur Verfügung steht: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
<br />
Somit können nun Domain-Module bzw. User-Module diese Topologie zu Test- oder Demonstrierzwecke verwenden.</div>
EThume
https://wiki.openkonsequenz.de/index.php?title=Mock-Up-Static-Topology&diff=1177
Mock-Up-Static-Topology
2018-11-20T09:18:28Z
<p>EThume: /* Elemente */</p>
<hr />
<div>__TOC__<br />
<br />
Dieser Dienst simuliert Quellsysteme, die topologische Elemente und Verknüpfungen über die [[Quellsystem-API]] zur Verfügung stellen.<br />
<br />
Für Testzwecke werden die verschiedene Topologievarianten angeboten:<br />
<br />
=Vollständiges Referenzmodell=<br />
Der Zweck des vollständigen Referenzmodells liegt in der Funktionsüberprüfung der datennutzenden Domänen- und Nutzermodule.<br />
Daher sind alle unterstützten topologischen Elemente und Entitäten sowie deren Verknüpfung enthalten. Der Fokus liegt auf Vollständigkeit und Übersichtlichkeit, nicht auf Größe oder Sinnhaftigkeit des Modells.<br />
<br />
Das aktuell verwendete Referenzmodell ist im Folgenden definiert:<br />
<br />
[[Datei:CIM-Model_reference-model.svg]]<br />
<br />
==Elemente==<br />
{| class="wikitable sortable"<br />
|-class="hintergrundfarbe6"<br />
!Nr.<br />
!Ressourcentyp<br />
!MRID<br />
!Bezugspunkt<br />
!Beschreibung<br />
!Eigenschaften<br />
|-<br />
|1<br />
|TopologyId<br />
|random<br />
| -<br />
|ID der Toplogie<br />
|<br />
|-<br />
|2<br />
|EnergySource<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
| -<br />
|Einspeiser<br />
|<br />
|-<br />
|3<br />
|Plant<br />
|0692e320-3ce6-47c4-bc57-525f9da47373<br />
| -<br />
|Kraftwerk<br />
|<br />
|-<br />
|4<br />
|SubstationType<br />
|3867ec39-1816-4905-b4a3-cc0d3678c269<br />
| -<br />
|Typ des Umspannwerks<br />
|<br />
|-<br />
|5<br />
|Substation<br />
|89edf801-13c2-4fb6-9fe1-4c01b7b07b21<br />
| -<br />
|Umspannwerk<br />
|<br />
|-<br />
|6<br />
|VoltageLevel<br />
|c8be6aa9-45f9-40de-aa1f-6e6c4f4ba46d<br />
| -<br />
|mid-voltage-voltage-level<br />
|<br />
|-<br />
|7<br />
|MeasurementPoint<br />
| -<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
|Messpunkt von breaker<br />
|<br />
|-<br />
|8<br />
|Breaker<br />
|043d903a-5702-4451-9613-4476e57e6a6d<br />
| -<br />
|Leistungsschalter<br />
|<br />
|-<br />
|9<br />
|Disconnector<br />
|1c0b7ae1-1d28-4599-8659-ddda708b31c1<br />
| -<br />
|Trenner<br />
|<br />
|-<br />
|10<br />
|Bay<br />
|3569b278-014f-4584-af9d-b4fc1e39830f<br />
| -<br />
|mid-voltage-bay<br />
|<br />
|-<br />
|11<br />
|BusbarSection<br />
|b24dc203-7253-4ead-bf61-6e90e9b5ce21<br />
| -<br />
|Sammelschiene<br />
|<br />
|-<br />
|12<br />
|BaseVoltage<br />
|ea4cf040-cb88-4978-a3a4-630a8f144e4b<br />
| -<br />
|mid-voltage-base-voltage<br />
|<br />
|-<br />
|13<br />
|BaseVoltage<br />
|9542f9ef-9a5f-47de-aff5-33f04f362668<br />
| -<br />
|low-voltage-base-voltage<br />
|<br />
|-<br />
|14<br />
|PowerTransformer<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
| -<br />
|Transformer<br />
|<br />
|-<br />
|15<br />
|GroundingImpedance<br />
|544ecb76-3546-4c7a-a6b8-b424ec3c090f<br />
| -<br />
|Erdschlussdrossel<br />
|<br />
|-<br />
|16<br />
|PetersenCoil<br />
|50904041-d7aa-4b3b-8ef7-dbff8a65f37e<br />
| -<br />
|Petersenspule<br />
|<br />
|-<br />
|17<br />
|EarthFaultCompensator<br />
|131fb478-24ce-47af-98d9-e52285be0876<br />
| -<br />
|Erdungswiderstand<br />
|<br />
|-<br />
|18<br />
|MeasurementPoint<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Messpunkt von LoadBreakSwitch<br />
|<br />
|-<br />
|19<br />
|LoadBreakSwitch<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
| -<br />
|Lastgangschalter<br />
|<br />
|-<br />
|20<br />
|Bay<br />
|1482836f-10a5-48aa-bcf0-553417b25142<br />
| -<br />
|low-voltage-bay<br />
|<br />
|-<br />
|21<br />
|VoltageLevel<br />
|348ee15f-c00d-4053-afe3-7227b4405276<br />
| -<br />
|low-voltage-voltage-level<br />
|<br />
|-<br />
|22<br />
|AcLineSegment<br />
|1efdad09-d26f-4f1b-be82-7f63ef474c42<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|north-ac-line-segment<br />
|<br />
|-<br />
|23<br />
|Junction<br />
|300a4ede-ad47-47cd-839f-f78cfc96e001<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|Muffe<br />
|<br />
|-<br />
|24<br />
|AcLineSegment<br />
|ebb8f129-3e4f-4200-bb96-ba384c911c83<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|south-ac-line-segment<br />
|<br />
|-<br />
|25<br />
|Line<br />
|47e63b23-a6ef-4316-bbd0-d81316b3df32<br />
|<br />
|Leitung<br />
|<br />
|-<br />
|26<br />
|SubGeographicalRegion<br />
|e238b44f-4d98-40c2-a1c9-6f72b10278f4<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
|Teilnetzgebiet<br />
|<br />
|-<br />
|27<br />
|LineType<br />
|c86d89fd-0662-4872-b0fe-9f0326718c9a<br />
| -<br />
|Leitungstyp<br />
|<br />
|-<br />
|28<br />
|GeographicalRegion<br />
|1fec2400-bf7a-481e-bb6a-2808096c0a99<br />
| -<br />
|Netzgebiet<br />
|<br />
|-<br />
|29<br />
|EnergyConsumer<br />
|f5babac5-e8c3-4b74-9620-237c08bd282d<br />
| -<br />
|Energieverbraucher<br />
|<br />
|-<br />
|32<br />
|TapChangerState<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Akt. Stellung der Transformatorstufenschalter<br />
|<br />
|-<br />
|33<br />
|Measurement<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Messung unterhalb der Station<br />
|<br />
|-<br />
|37<br />
|ControlStage<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Regelstufe der Einspeiser<br />
|<br />
|-<br />
|38<br />
|OperatingState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Betriebszustand der Einspeiser<br />
|<br />
|-<br />
|39<br />
|SwitchState<br />
| -<br />
|ce9e868a-d575-4688-aef4-fb217919ec2e<br />
|Akt. Schalterstellungen<br />
|<br />
|-<br />
|40<br />
|TapChanger<br />
| -<br />
|abddaf44-13e6-46a3-8f87-0d675ea78659<br />
|Transformatorstufenschalter<br />
|<br />
|-<br />
|41<br />
|CommunicationState<br />
| -<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Akt. Kommunikationsstatus der Einspeiser<br />
|<br />
|-<br />
|42<br />
|EnergySource:Asset<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|0fe1c631-490e-46d1-acf0-9f1eaa53522f<br />
|Einspeiserstammdaten<br />
|<br />
|-<br />
|43<br />
|AssetOwner:Organisation<br />
|dc896fa9-746d-42b2-8163-44c3248469d2<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Anlagenbetreiberrolle des Einspeisers<br />
|<br />
|-<br />
|44<br />
|Operator:Organisation<br />
|8db20a4b-8a1a-4799-aefc-9910dc99dedf<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Betreiber des Einspeisers<br />
|<br />
|-<br />
|45<br />
|EnergySourceLocation:Location<br />
|e916152a-4aaf-4a07-8aa5-ee9b7d06d525<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Standort des Einspeisers<br />
|<br />
|-<br />
|46<br />
|AssetOwnership<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b811<br />
|5417aeca-c8b1-4b5e-9412-b16e7d73b798<br />
|Eigentumsverhätnisse des Einspeisers<br />
|<br />
|}<br />
<br />
=Stresstest-Modell=<br />
Beinhaltet ein zufällig generiertes topologisches Modell. Für Performance- und Lasttests wird eine hohe Anzahl an Elementen erstellt.<br />
{{Warning|text=Diese Option ist in '''CIM-Cache Ertüchtigung Stufe I''' und '''CIM-Cache Ertüchtigung Stufe II''' kein Bestandteil der Beauftragung!}}<br />
<br />
=Realmodell=<br />
Dieses Modell beinhaltet ein reales, aber anonymisiertes Netzmodell. Folgende Schritte sind hier durchzuführen (Beispiel bezieht sich auf Windows-Umgebung):<br />
#Auschecken des entsprechenden git-Projektes: git-Link https://git.eclipse.org/r/openk-platform/org.eclipse.openk-platform.openk-repo mit dem Branch CR04<br />
#Innerhalb der Konsole in das Verzeichnis ROOT_PATH wechseln:<pre>cd LocalDirectory\git.openk\cim-cache</pre><br />
#Aufrufen der BAT-Datei zum Bauen des CIM-Cache:<pre>build-cim-cache.bat</pre><br />
#Innerhalb der Konsole in das folgende Verzeichnis wechseln:<pre>cd org-eclipse-openk-sourcesystem-mockupstatictopology\service</pre><br />
#Das Quellsystem-Mock-Up mit dem folgenden Befehl starten:<pre>java -jar target\mock-up-static-topology-service-0.0.1-SNAPSHOT.jar</pre><br />
#Abfrage des Default-Referenzmodels via Web-Browser: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
#Laden des anonymisiertes Netzmodells via POST-Request (z.B. mit RESTClient auf Firefox) <pre> "http://localhost:9518/command/execute" und dem Body "Inhalt der RDF-Datei"</pre><br />
#Prüfen, ob das anonymisiertes Netzmodell nun im Mock-up zur Verfügung steht: <pre> http://localhost:9518/service/model?repository-key=static-topology </pre><br />
<br />
Somit können nun Domain-Module bzw. User-Module diese Topologie zu Test- oder Demonstrierzwecke verwenden.</div>
EThume