Domänen-API: Unterschied zwischen den Versionen

Aus Wiki openKONSEQUENZ
Wechseln zu: Navigation, Suche
(→‎basePath: /domain/electricity/topology-state)
(→‎basePath: /domain/electricity/dynamic-topology)
Zeile 57: Zeile 57:
 
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"
 
!unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"
 
|-
 
|-
 +
|Topologie<br/><font color="MediumSeaGreen">(Neue Funktionen in CIM Cache Stufe II)</font>
 
|Topologie
 
|Topologie
−
|Topologie
+
|{{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)}}
−
|{{REST-GET|cim-version = 17v07|name = topology|language = de|protocol = http|host = api.openk.de|base-path = domain/electricity/dynamic-topology|revision = 2}}
 
 
|
 
|
 
  {| class="wikitable sortable"
 
  {| class="wikitable sortable"
Zeile 101: Zeile 101:
 
|topologische Ressourcen
 
|topologische Ressourcen
 
|
 
|
−
|{{REST-GET|cim-version = 17v07|name = power-system-resources|language = de|protocol = http|host = api.openk.de|base-path = domain/electricity/dynamic-topology|revision = 1}}
+
|{{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)}}
 +
 
 
|
 
|
 
  {| class="wikitable sortable"
 
  {| class="wikitable sortable"
Zeile 133: Zeile 134:
 
|topologische Ressourcentypen
 
|topologische Ressourcentypen
 
|Eigenschaften
 
|Eigenschaften
−
|{{REST-GET|cim-version = 17v07|name = power-system-resource-types|language = de|protocol = http|host = api.openk.de|base-path = domain/electricity/dynamic-topology|revision = 1}}
+
|{{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)}}
 
|
 
|
 
  {| class="wikitable sortable"
 
  {| class="wikitable sortable"
Zeile 161: Zeile 162:
 
  |}
 
  |}
 
|}
 
|}
−
 
  
 
==basePath: /domain/electricity/measurement==
 
==basePath: /domain/electricity/measurement==

Version vom 19. September 2018, 11:58 Uhr

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 (ADM) betreiben.)

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.

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. Im Folgenden werden die Schnittstellen-Methoden vorgestellt, die durch die Domänen-Module des oK-CIM-Caches (1. Ausbaustufe) (TopologieDatenManagement (TDM), MessDatenManagement (MDM)) implementiert werden:



basePath: /domain/common/contact-data

Bezeichnung Beschreibung bereitstellendes System
Unternehmen
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: organisations
aktuelle Version: Revision 1 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • asset-data v2.2

basePath: /domain/electricity/asset-data

Bezeichnung Beschreibung bereitstellendes System
Anlagen-Eigentumsverhältnisse
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: asset-ownerships
aktuelle Version: Revision 2 (cim-profile openkonsequenz)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • asset-data v2.2
Einspeiserstammdaten
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: energy-sources
aktuelle Version: Revision 1 (cim-profile openkonsequenz)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • asset-data v2.2
Einspeiserstandorte
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: energy-source-locations
aktuelle Version: Revision 1 (cim-profile openkonsequenz)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • asset-data v2.2

basePath: /domain/electricity/dynamic-topology

Information.icon.svg 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.

Hierbei gelten folgende Konventionen:

  • "?" frei wählbar gemäß Schnittstellendefinition
  • " " Parameter nicht unterstützt
  • "<< >>" Beschreibung des zu ersetzenden Wertes


Bezeichnung Typ Beschreibung unterstütze Anwendungsfälle aus "CIM-Cache Ertüchtigung Stufe 1"
Topologie
(Neue Funktionen in CIM Cache Stufe II) 		Topologie
http-Methode: GET
Bezeichnung: topology
aktuelle Version: Revision 2 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anwendungsfall revision timestamp source user-id message-id topology-id entry-point-id connection-state selector fetch-type
Abfrage der gesamten statischen Topologie 2 ? ? ? ? ? Ignore All
Abfrage statischer Teilnetze (unter Schalternormalstellung) unterhalb eines Transformators 2 ? ? ? ? ? <<eindeutige Kennung des Transformators>> Normal Behind
topologische Ressourcen
http-Methode: GET
Bezeichnung: power-system-resources
aktuelle Version: Revision 1 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI


Anwendungsfall revision timestamp source user-id message-id topology-id power-system-resource-types entry-point-id connection-state selector fetch-type
Abfrage der topologischen Elemente (Entitäten) 1 ? ? ? ? ? <<Liste der abzufragenden Ressourcentypen>> <<eindeutige Kennung des Element-Containers>> ?
topologische Ressourcentypen Eigenschaften
http-Methode: GET
Bezeichnung: power-system-resource-types
aktuelle Version: Revision 1 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anwendungsfall revision timestamp source user-id message-id topology-id entry-point-id connection-state selector fetch-type
Abfrage aller topologischen Elementtypen 1 ? ? ? ? ?

basePath: /domain/electricity/measurement

Bezeichnung Beschreibung bereitstellendes System
aktuelle Messwerte
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: measurements
aktuelle Version: Revision 1 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • measurement v2.2
Messpunkte
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: measurement-points
aktuelle Version: Revision 1 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • measurement v2.2

basePath: /domain/electricity/topology-state

Bezeichnung Beschreibung bereitstellendes System
aktueller Betriebszustand der Einspeiser
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: /operating-states
aktuelle Version: Revision 1 (cim-profile openkonsequenz)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • topology-state v2.2
aktuelle Regelstufe der Einspeiser
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: /control-stage
aktuelle Version: Revision 1 (cim-profile openkonsequenz)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • topology-state v2.2
aktuelle Schalterstellungen
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: /switch-states
aktuelle Version: Revision 3 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • topology-state v2.2
aktuelle Stellung der Transformatorstufenschalter
(neu in CIM Cache Stufe II)
http-Methode: GET
Bezeichnung: /tap-changer-states
aktuelle Version: Revision 1 (CIM 17v07)
Sprache (ISO 639-1): de
Quelltext: api.openk.de
Spezifikation: Swagger UI
  • topology-state v2.2
Abgerufen von „http://wiki.openkonsequenz.de/index.php?title=Domänen-API&oldid=1108“