/Methods/GetArchiveItems

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > JSON для HTTP-запросов > Описание JSON-запросов > Доступ к архивам данных >

/Methods/GetArchiveItems

GetArchiveItems - запрос на получение числовых ID параметров.

Данные запроса

{"sessionId":<ID сессии>,

"items":[ - массив запрашиваемых параметров:

{"taskId":0 - ID задачи архивирования, которому принадлежит параметр

"itemId": <ID параметра>,

"path":"", - путь внутри составного параметра ItemID (можно не задавать)

"type":"STRING", - ST тип параметра (может быть именем сложного типа)

"typeHash":4} - хеш типа параметра

]

}

Данные ответа

{

items: [<Item>,...] - массив ответов по каждому параметру, порядок такой же, как в запросе

}

Item: {

statusCode: <uint32> - код ошибки, если параметр не найден. Если 0, то может не задаваться

description: <string> - поле Описание, заданное в редакторе

comment: <string> - поле Комментарий, заданное в редакторе

scaleAI: <ScaleAI> - описание шкалы параметра. Поля могут быть не заданы

archiveItemId: <int64> - cacheId параметра, передаваемый далее в запрос HistoryReadRaw. Если -1, то параметр не архивируется

fullName: <string> - полное имя архивируемого параметра

type: <string> - ST тип параметра (может быть именем сложного типа)

startTime: <unix time in ms> - время первой доступной записи в архиве

endTime:   <unix time in ms> - время последней доступной записи в архиве

}

ScaleAI: {

min: <double> - нижняя граница изменения значения параметра

max: <double> - верхняя граница изменения значения параметра

lo: <double> - нижнее предупредительное значение

lolo: <double> - нижнее аварийное значение

hi: <double> - верхнее предупредительное значение

hihi: <double> - верхнее аварийное значение

format: <string> - формат значений

unit: <string> - единицы измерения

id: <string> - ItemID шкалы в формате <ID>.<Path>

}

Пример

Запрос

{"sessionId":"1234",

"items":[

{

"taskId":0,

"itemId":28012,

"type":"STRING",

"typeHash":4,

"startTime":1357002062000,

"endTime":1357002062000

}]

}

Ответ

{

"items": [{

"statusCode": 0

"scaleAI": {

"min": 23.0,

"max": 24.0,

"lo": 2.0,

"lolo": 0.0,

"hi": 433.0,

"hihi": 433.0

"id": "12345.Parametr_S"

}

"archiveItemId": 1

"fullName": "Объекты.Объект 1.Параметр 1"

"type": "LREAL"

"startTime": 1690416372000

"endTime":   1690616372000

},...]

}