/reporting/DpNames

"/reporting/DpNames?[api-version=<vernr>]"
"/reporting/DpNames?[api-version=<vernr>]" stellt eine Liste aller verfügbaren Datenpunkte bereit. Die bereitgestellten Informationen enthalten den Namen des Datenpunkts einschließlich des jeweiligen Systemnamens. Siehe auch Beispiele unterhalb.
VORSICHT: Wenn Sie weiterhin das alte Format verwenden möchten, setzen Sie die api-version=1.0 oder api-version=1.1!
Parameter Beschreibung
api-version Versionsnummer aus Kompatibilitätsgründen. Der Defaultwert ist 2.0!
jsonCompact jsonCompact. Der Standardwert ist 0. Wenn Sie den Parameter auf 1 setzen, wird das JSON in einem komprimierten Format zurückgegeben (Ausgabe in einer Zeile), nicht "menschenlesbar", aber etwas weniger Netzwerkverkehr.

Beispiel mit der Version 2.0

Ab der Version 2.0 der REST Reporting API (verfügbar mit WinCC OA 3.19-P002) wurde das Standardformat der Antwort auf strukturierte JSON-Objekte anstelle eines flachen JSON-Arrays geändert.

Request:

https://HOST:443/reporting/DpNames

Response:

{                
  "generatedBy": "WinCC OA 3.19-P002 @ Windows AMD64",
  "formatVersionMajor": 2,
  "formatVersionMinor": 0,
  "dps": [
      {
        "DP": "System1:AlertHorn"
      },
      {
        "DP": "System1:Connection1"
      },
      {
         "DP": "System1:Connection2"
      },
      // ...
      {
         "DP": "System1:warning" 
      }
     ]            
}

Beispiel mit der Version 1.0 - 1.1

Request:

https://HOST:443/reporting/DpNames

Response:

[
   "System1:ExampleDP_AlertHdl1",
   "System1:ExampleDP_AlertHdl2",
   "System1:ExampleDP_Arg1",
   "System1:ExampleDP_Arg2",
   "System1:ExampleDP_BarTrend",
   "System1:ExampleDP_DDE",
   "System1:ExampleDP_Result",
   "System1:ExampleDP_Rpt1",
   "System1:ExampleDP_Rpt2"
   ...
]

Beispiel mit der Version 1.0 -1 .1

Wenn Sie weiterhin das alte Format verwenden möchten, setzen Sie die api-version=1.0 oder api-version=1.1!

Request:

https://HOST:443/reporting/DpNames?api-version=1.1

Response:

["System1:AlertHorn", "System1:Connection1", "System1:Connection2", /* ... */ "System1:warning"]