history.get

Опис

integer/array history.get(object parameters)

Метода омогућава преузимање података историје у складу са датим параметрима.

Ова метода може да врати историјске податке избрисаног ентитета ако ове податке није уклонио домаћица.

Ова метода је доступна корисницима било ког типа . Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Userroles за више информација.

Параметри

(object) Параметри који дефинишу жељени излаз.

Метод подржава следеће параметре.

Parameter	Type	Description
history	integer	Типови објеката историје које треба вратити. Могуће вредности: 0 - нумерички у покретном зарезу; 1 - карактер; 2 - лог; 3 - (подразумевано) нумерички неозначени; 4 - текст; 5 - бинарно.
hostids	ID/array	Враћа само историју са датих домаћина.
itemids	ID/array	Враћа само историју из датих ставки.
time_from	timestamp	Враћа само вредности које су примљене после или у датом тренутку.
time_till	timestamp	Враћа само вредности које су примљене пре или у датом тренутку.
sortfield	string/array	Сортирај резултат према датим својствима. Могуће вредности: `itemid`, `clock`, `ns`.
countOutput	boolean	Ови параметри су описани у референтном коментару.
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
output	query
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Повратне вредности

(integer/array) Враћа било:

низ објеката;
број преузетих објеката, ако је параметар countOutput коришћен.

Примери

Преузимање података историје ставки

Врати 10 последњих вредности примљених од нумеричке (флоат) ставке.

Request:

{
            "jsonrpc": "2.0",
            "method": "history.get",
            "params": {
            "output": "extend",
            "history": 0,
            "itemids": "23296",
            "sortfield": "clock",
            "sortorder": "DESC",
            "limit": 10
            },
            "id": 1
       }

Одговор:

{
            "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
       }

Извор

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

Documentation