Documentation
Table of Contents
history.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
integer/array history.get(object parameters)
El m¨¨tode permet recuperar informaci¨® hist¨°rica segons els par¨¤metres prove?ts.
Veieu tamb¨¦: problemes coneguts
Aquest m¨¨tode retorna informaci¨® hist¨°rica d'una entitat esborrada si aquesta informaci¨® no ha estat esborrada per el proc¨¦s de neteja.
Aquest m¨¨tode ¨¦s disponible per a usuaris de qualsevol mena. Els permisos per cridar al m¨¨tode es poden revocar a les configuracions de rols d'usuari. Per a m¨¦s informaci¨®, veieu Rols d'usuari.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ que defineixen la sortida esperada.
El m¨¨tode admet els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| history | integer | Tipus d'objectes d'historial a retornar. Valors possibles: 0 - flotant num¨¨ric; 1 - car¨¤cter; 2 - registre; 3 - (per defecte) num¨¨ric sense signe; 4 - text; 5 - binari. |
| hostids | ID/array | Retorna nom¨¦s l'historial dels equips donats. |
| itemids | ID/array | Retorna nom¨¦s l'historial dels elements donats. |
| time_from | timestamp | Retorna nom¨¦s els valors que s'han rebut despr¨¦s o en el moment donat. |
| time_till | timestamp | Retorna nom¨¦s els valors que s'han rebut abans o en el moment donat. |
| sortfield | string/array | Ordena el resultat per les propietats donades. Els valors possibles s¨®n: itemid, clock, ns. |
| countOutput | boolean | Aquests par¨¤metres es descriuen a la p¨¤gina comentaris de refer¨¨ncia. |
| editable | boolean | |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Valors de retorn
(integer/array) Retorna un d'entre:
- una taula d'objectes;
- el recompte d'objectes recuperats, si s'empra el par¨¤metre
countOutput.
Exemples
Recuperar les dades de l'historial d'elements
Retorna els 10 darrers valors rebuts d'un element num¨¨ric (flotant).
{
"jsonrpc": "2.0",
"method": "history.get",
"params": {
"output": "extend",
"history": 0,
"itemids": "23296",
"sortfield": "clock",
"sortorder": "DESC",
"limit": 10
},
"id": 1
}Resposta:
{
"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
}Font
CHistory::get() in ui/include/classes/api/services/CHistory.php.