# Datapisteet

##### **Lukeminen**

  
Read datapoint value lukee datapisteiden arvoja WS-rajapinnan ylitse. Samalla komennolla voidaan lukea useita pisteitä erottamalla niiden nimet puolipilkulla ( ; ).

Esimerkki: Luetaan koko piste ”sys/settings/networkSettings”.  
/plc.php?get=sys/settings/networkSettings

Vastaus:  
\[{"get":"{\\"defaultGateway\\":\\"192.168.0.1\\",\\"subnetMask\\":\\"255.255.255.0\\",\\"ipAddress\\":\\"192.168.0.128\\",\\"dnsServer\\":\\"8.8.8.8\\",\\"broadcastAddress\\":\\"192.168.0.255\\"}"},{"time":"1505132981"}\]

Esimerkki: Luetaan kahden prosessidatapisteen oloarvot (pisteet ioPoints/TK01/TE10 ja ioPoints/TK01/TE30).

/plc.php?get=ioPoints/TK01/TE10.pv;ioPoints/TK01/TE30.pv

Vastaus:  
\[{"get":"20.6"},{"get":"19.6"},{"time":"1505133163"}\]

Esimerkki: Luetaan sellaisen pisteen arvo, jota ei ole olemassa.

/plc.php?get=ioPoints/TK01/TE100.pv

Vastaus:  
\[{"get":"-4294967296"},{"time":"1505133224"}\]

##### **kirjoittaminen**

  
Datapisteen arvon kirjoittaminen WS-rajapinnan ylitse.

Value-parametri, eli kirjoitettava arvo annetaan JSON-muodossa.

**Huom! Ei käytössä shared key -autentikoinnin kautta.**

Esimerkki: Kirjoitetaan tuloilman asetusarvo (piste ”ioPoints/TK01/TE10\_SP”).

/plc.php?set=ioPoints/TK01/TE10.pv&value=22.0

Vastaus:  
\[{"set":"true"},{"time":"1505137224"}\]

##### **Listaus**  
  


Prosessorin datapisteiden listaaminen. Suodatusta listassa voidaan tehdä joko pistenimissä (wildcard-merkillä \*) tai niiden sisältämien arvojen perusteella.

Syntaksi *list*- ja *field*-parametreille on sama kuin Data.list() -kutsussa.

 **list**  Tällä parametrilla annetaan suodausehto pisteiden nimelle. Wildcardina toimii merkki ’\*’, joka on URL-koodattuna %2A.

 **field** Tämän parametrin avulla voidaan suodattaa pisteitä kenttien ja jopa kenttien arvojen perusteella. Tässä yhteydessä ei voi suoraan käyttää Wild card -merkkejä, koska lausekkeen täytyy olla validi vertailu.

Esimerkki 1: Listataan kaikki TK01:n pisteet, eli nimisuodattimena ”ioPoints/TK01/\*”.

/plc.php?list=ioPoints/TK01/%2A

Vastaus:  
\[{"list":\["ioPoints\\/TK01\\/TE10","ioPoints\\/TK01\\/TE30"\]},{"time":"1505137744"}\]

  
Esimerkki 2: Listataan kaikki pisteet joilla on kenttä ’dataSource’

/plc.php?list=ioPoints/TK01/%2A&field=(dataSource)

Esimerkki 3: Listataan kaikki pisteet joilla kenttä pv on suurempi kuin 9.0

Muista että field parametrille täytyy tehdä URL enkoodaus! Selväkielisenä vertailu on (pv > 9.0)

/plc.php?list=ioPoints/TK01/%2A&field=(pv%20%3E%209.0)