Documentation
Table of Contents
history.get
Beschrijving
integer/array history.get(object parameters)
Deze methode maakt het mogelijk om historische gegevens op te halen volgens de opgegeven parameters.
Deze methode kan historische gegevens van een verwijderde entiteit retourneren als deze gegevens nog niet zijn verwijderd door de huishouder.
Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode te bellen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruikersrollen voor meer informatie.
Parameters
(object) Parameters die de gewenste uitvoer definiëren.
De methode ondersteunt de volgende parameters.
| Parameter | Type | Omschrijving |
|---|---|---|
| history | integer | Geeft de gewenste typen historische objecten terug. Mogelijke waarden: 0 - numerieke zwevende komma; 1 - karakter; 2 - logboek; 3 - (standaard) numerieke niet-ondertekende; 4 - tekst. |
| hostids | string/array | Geeft alleen geschiedenis terug van de opgegeven hosts. |
| itemids | string/array | Geeft alleen geschiedenis terug van de opgegeven items. |
| time_from | timestamp | Geeft alleen waarden terug die zijn ontvangen na of op het opgegeven tijdstip. |
| time_till | timestamp | Geeft alleen waarden terug die zijn ontvangen vóór of op het opgegeven tijdstip. |
| sortfield | string/array | Sorteer het resultaat op de opgegeven eigenschappen. Mogelijke waarden: itemid, clock. |
| countOutput | boolean | Deze parameters, die gemeenschappelijk zijn voor alle get-methoden, worden in detail beschreven op de referentiecommentaar pagina. |
| editable | boolean | |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Retourwaarden
(integer/array) Retourneert ofwel:
- een reeks objecten;
- het aantal opgehaalde objecten, als de
countOutputparameter heeft gebruikt.
Voorbeelden
Ophalen van itemgeschiedenisgegevens
Retourneer de 10 nieuwste waarden die zijn ontvangen van een numeriek (zwevendekommagetal) item.
{
"jsonrpc": "2.0",
"method": "history.get",
"params": {
"output": "extend",
"history": 0,
"itemids": "23296",
"sortfield": "clock",
"sortorder": "DESC",
"limit": 10
},
"id": 1
}Antwoord:
{
"jsonrpc": "2.0",
"result": [
{
"itemid": "23296",
"clock": "1351090996",
"value": "0.085",
"ns": "563157632"
},
{
"itemid": "23296",
"clock": "1351090936",
"value": "0.16",
"ns": "549216402"
},
{
"itemid": "23296",
"clock": "1351090876",
"value": "0.18",
"ns": "537418114"
},
{
"itemid": "23296",
"clock": "1351090816",
"value": "0.21",
"ns": "522659528"
},
{
"itemid": "23296",
"clock": "1351090756",
"value": "0.215",
"ns": "507809457"
},
{
"itemid": "23296",
"clock": "1351090696",
"value": "0.255",
"ns": "495509699"
},
{
"itemid": "23296",
"clock": "1351090636",
"value": "0.36",
"ns": "477708209"
},
{
"itemid": "23296",
"clock": "1351090576",
"value": "0.375",
"ns": "463251343"
},
{
"itemid": "23296",
"clock": "1351090516",
"value": "0.315",
"ns": "447947017"
},
{
"itemid": "23296",
"clock": "1351090456",
"value": "0.275",
"ns": "435307141"
}
],
"id": 1
}Bron
CHistory::get() in ui/include/classes/api/services/CHistory.php.