Documentation
Table of Contents
trend.get
Beschrijving
integer/array trend.get(object parameters)
Deze methode maakt het mogelijk om trendgegevens op te halen op basis van de opgegeven parameters.
Deze methode is beschikbaar voor gebruikers van elk type. Toestemmingen om de methode te gebruiken kunnen worden ingetrokken in de gebruikersrolinstellingen. Zie Gebruikersrollen voor meer informatie.
Parameters
(object) Parameters die de gewenste uitvoer definiëren.
De methode ondersteunt de volgende parameters.
| Parameter | Type | Beschrijving |
|---|---|---|
| itemids | string/array | Retourneer alleen trends met de opgegeven item-ID's. |
| time_from | timestamp | Retourneer alleen waarden die na of op het opgegeven tijdstip zijn verzameld. |
| time_till | timestamp | Retourneer alleen waarden die voor of op het opgegeven tijdstip zijn verzameld. |
| countOutput | boolean | Tel het aantal opgehaalde objecten. |
| limit | integer | Beperk het aantal opgehaalde objecten. |
| output | query | Stel velden in op uitvoer. |
Retourwaarden
(integer/array) Retourneert ofwel:
- een reeks objecten;
- het aantal opgehaalde objecten, als de
countOutputparameter heeft gebruikt.
Voorbeelden
Ophalen van trendgegevens van een item
{
"jsonrpc": "2.0",
"method": "trend.get",
"params": {
"output": [
"itemid",
"clock",
"num",
"value_min",
"value_avg",
"value_max"
],
"itemids": [
"23715"
],
"limit": "1"
},
"id": 1
}Antwoord:
{
"jsonrpc": "2.0",
"result": [
{
"itemid": "23715",
"clock": "1446199200",
"num": "60",
"value_min": "0.165",
"value_avg": "0.2168",
"value_max": "0.35"
}
],
"id": 1
}Bron
CTrend::get() in ui/include/classes/api/services/CTrend.php.