trend.get

Beschreibung

integer/array trend.get(object parameters)

Mit dieser Methode können Trenddaten entsprechend den angegebenen Parametern abgerufen werden.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Typ Beschreibung
itemids ID/array Gibt nur Trends mit den angegebenen Datenpunkt-IDs zurück.
time_from timestamp Gibt nur Werte zurück, die nach oder zum angegebenen Zeitpunkt erfasst wurden.
time_till timestamp Gibt nur Werte zurück, die vor oder zum angegebenen Zeitpunkt erfasst wurden.
countOutput boolean Zählt die Anzahl der abgerufenen Objekte.
limit integer Begrenzt die Anzahl der abgerufenen Objekte.
output query Legt die Eigenschaften des Trend-Objekts fest, die zurückgegeben werden sollen.

Rückgabewerte

(integer/array) Gibt entweder Folgendes zurück:

  • ein Array von Objekten;
  • die Anzahl der abgerufenen Objekte, wenn der Parameter countOutput verwendet wurde.

Beispiele

Abrufen von Datenpunkt-Trenddaten

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "trend.get",
    "params": {
        "output": [
            "itemid",
            "clock",
            "num",
            "value_min",
            "value_avg",
            "value_max"
        ],
        "itemids": [
            "23715"
        ],
        "limit": "1"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "23715",
            "clock": "1446199200",
            "num": "60",
            "value_min": "0.165",
            "value_avg": "0.2168",
            "value_max": "0.35"
        }
    ],
    "id": 1
}

Quelle

CTrend::get() in ui/include/classes/api/services/CTrend.php.