history.get

Опис

integer/array history.get(object parameters)

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

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

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

Параметри

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

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

Parameter Type Опис
imageids ID/array Враћа само слике са датим ID-ијевима.
sysmapids ID/array Враћа слике које се користе на датим мапама.
select_image flag Враћа својство image са Base64 кодираном сликом.
sortfield string/array Сортира резултат према датим својствима.

Могуће вредности: imageid, name.
countOutput boolean Ови параметри су описани у референтном коментару.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
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.