/reporting/Dp

"/reporting/Dp"
Der Endpunkt "/reporting/Dp" fragt den Online-Wert oder historische Werte eines Datenpunktes ab.
Der Endpunkt "/reporting/Dp" liefert für jeden Datenpunkt:
  • den Wert,
  • den Zeitstempel, wann der Wert auf den Datenpunkt geschrieben wurde,
  • die Statusbits.
  • den Manager, der den Wert geschrieben hat,
Der Endpunkt "/reporting/Dp" erfordert einen Parameter und hat zwei optionale Parameter.
Anmerkung: Wir empfehlen den Endpunkt /reporting/Dps zu verwenden. Dieser ist ab der REST-Reporting API Version 2.0 (WinCC OA 3.19-P002) verfügbar.
Parameter Beschreibung
Der erste erforderliche Parameter ist der Datenpunktname einschließlich des Systemnamens.
from Die beiden optionalen Parameter sind ein Zeitstempel für from und ein Zeitstempel für to.

Das Format des Zeitstempels ist ISO-Format.

Wenn nur der Parameter from angegeben wird, setzt die API den Parameter to auf das aktuelle Datum und die aktuelle Uhrzeit.

Wenn die Parameter from und to nicht angegeben sind, wird der Online-Wert abgefragt.

to
Anmerkung: Es gibt einen Zählparameter, der jedoch nicht konfigurierbar ist und immer 1 ist.

Beispiel ohne Datum

Request:

https://HOST:443/reporting/Dp?System1:ExampleDP_Rpt1

Response:

[
   10.599999999999998,"2021-01-26T13:04:32.369Z",
   "1000001100000000000000000000000000000000001100000000000100000001",
   "UI -num 1"
]

Beispiel mit Datum

Request:

https://HOST:443/reporting/Dp?System1:ExampleDP_Rpt1&from=2021-01-01T12:47:37.369Z

Response:

[ [
     10.999999999999996,
     "2021-01-22T16:42:14.881Z",
     "1000001100000000000000000000000000000000001100000000000100000001",
     "UI -num 1"
   ],
   [
      11.199999999999996,
      "2021-01-22T16:42:15.880Z",
      "1000001100000000000000000000000000000000001100000000000100000001",
      "UI -num 1"
   ]]