Differences

This shows you the differences between two versions of the page.

--- en:mervis-scada:50-api [2020/04/06 13:14]
m.chlupac [api/set/history]
+++ en:mervis-scada:50-api [2020/04/27 12:45]
m.chlupac [api/set/history]
@@ Line 32: / Line 32: @@
-===== Example =====
+===== Examples =====
 ====api/checkCredentials====
@@ Line 146: / Line 146: @@
    * URL: /api/set/history?format=xml
    * Method: POST
+   * Content-Type: text/xml
-Attribute **i** sets **interval** ([[https://en.wikipedia.org/wiki/ISO_8601#Time_intervals|ISO 8601]]) in which the next value should be expected to be saved into database.
+Attribute **i** sets **interval** ([[https://en.wikipedia.org/wiki/ISO_8601#Time_intervals|ISO 8601]]) in which the next value should be expected to be saved into a database.
 Even though there could be used name and password in **cred** - you should always use **token** to get the best performance.
@@ Line 160: / Line 161: @@
 projId="5abf8ca0-94ba-48df-8d3c-7ebe87a12fd0"
 dpId="e86dba6d-1250-4e7f-aafb-84fd28324710">
-  <n2:cred t="xxxxx"/><!-- token should be always used here -->
+  <n2:cred t="xxxxx"/><!-- token should be used here -->
   <vals>
     <hv ts="2020-03-15T11:00:00+00:00" i="P1D">
@@ Line 194: / Line 195: @@
 xmlns:n1="http://dev.rcware.eu/auth"
 xmlns:r="http://dev.rcware.eu/serialization/references">
-  <n1:cred n="userName" p="password"/>
+  <n1:cred t="xxxxxx"/>
   <actionDefs projId="5abf8ca0-94ba-48df-8d3c-7ebe87a12fd0">
     <actions>
@@ Line 212: / Line 213: @@
 <code xml><?xml version="1.0" encoding="utf-8"?>
 <executeActionsResponse xmlns:r="http://dev.rcware.eu/serialization/references" code="Ok" message="OK" xmlns="http://dev.rcware.eu/scada/error-reporting" /></code>
+====api/get/values====
+The right way how to retrieve current values of data points (property "Output" which is usually what you want) from one or multiple projects.
+**Request**
+   * URL: /api/get/values?format=xml
+   * Method: POST
+<code javascript>
+{
+ "cred": {
+  "t": "xxxxxx" //token
+ },
+ "propNamesToSerialize": ["Output"],
+ "offset": 0,
+ "count": 1000,
+ "serverState": null,
+ "dps": [{
+   "projId": "ba1a92f7-f213-4a72-90e4-f7142b50274b",
+   "dpIds": ["e089dde2-a097-4e0d-8012-c8cf3dc62694", "1089dde2-a097-4e0d-8012-c8cf3dc62696"]
+  }
+ ]
+}
+</code>
+**Response**
+<code xml><?xml version="1.0" encoding="utf-8"?>
+<values xmlns:r="http://dev.rcware.eu/serialization/references" nextOffset="-1" serverTime="2020-04-07T07:46:34.850422Z" xmlns:n1="http://dev.rcware.eu/scada/basic-props" xmlns="http://dev.rcware.eu/scada/datapoints">
+ <vals>
+  <v projId="ba1a92f7-f213-4a72-90e4-f7142b50274b" dataVersion="637217783110000000" serverTime="2020-04-07T07:46:34.850422Z">
+   <dps>
+    <d id="e089dde2-a097-4e0d-8012-c8cf3dc62694" serAlr="true">
+     <props>
+      <p n="Output" t="2020-04-07T07:43:42.1000676Z" q="Bad" r:type="177e726a-3180-4152-bef2-6254e7055e1f">
+       <n1:v>ON</n1:v>
+      </p>
+     </props>
+    </d>
+    <d id="1089dde2-a097-4e0d-8012-c8cf3dc62696" serAlr="true">
+     <props>
+      <p n="Output" t="2020-04-07T07:45:00.2408399Z" q="Good" r:type="b133774d-21ce-42b6-add3-57c012079c55">
+       <n1:v>0</n1:v>
+      </p>
+     </props>
+    </d>
+   </dps>
+  </v>
+ </vals>
+</values></code>