|
<< Click to Display Table of Contents >> Navigation: API MasterSCADA 4D > Подключение к исполнительной системе по JSON > JSON для HTTP-запросов > Описание JSON-запросов > Доступ к архивам данных > /Methods/HistoryReadRaw |
HistoryReadRaw - запрос на чтение архива.
{"sessionId":<ID сессии>,
"parameters":
{"startTime":<время начала>,
"endTime"<время конца>, - если не указано, то до конца архива
"numValuesPerNode":0, - максимальное количество возвращаемых значений по каждой переменной
"returnBounds":true, - возвращать ли ближайшие к границам интервала значения, не принадлежащие интервалу
"returnFirstLastValue":false, - вернуть только первое и последнее значение в архиве (по каждому параметру будет возвращено 2, 1, или 0 значений)
"resampleInterval":<интервал> - интервал прореживания в мс. Сервер возвращает не более 4 значений (в зависимости от типа прореживания) за каждый интервал
}
"data":[ - массив запрашиваемых параметров:
{"archiveItemId":<ID>, - ID архивного параметра
"continuationPoint":"0000000000" - позиция в архиве, с которой начинать чтение (возвращается командой чтения архива, если все данные по данной переменной не удалось прочитать за один запрос). Если не задано, чтение идет с начала архива
}]
}
{
"data":[ - массив ответов по каждому параметру (порядок такой же, как в запросе):
{
"archiveItemId":<ID>, - ID архивного параметра
"statusCode":0, - код ошибки, если параметр не найден (если 0, то может не задаваться)
"areMoreValues":true, - имеются еще значения, попадающие в заданный интервал времени
"continuationPoint":"0000000100", - позиция в архиве. Если переданы не все данные, передается позиция в архиве, которую надо передать в следующем запросе (для каждой переменной передается отдельная позиция)
"values":[ - массив архивных записей по данному параметру:
[ - каждая запись приходит как массив из 3 полей:
▪метка времени,
▪значение,
▪признак качества значения
]
]
}
{"sessionId":"1234",
"parameters":
{"startTime":"1357002062000",
"endTime":"1357002062000",
"numValuesPerNode":0,
"returnBounds":true,
"returnFirstLastValue":false
},
"data":[
{"archiveItemId":111}]
}
{"code":0,
"data":[{
"archiveItemId":111,
"areMoreValues":true,
"continuationPoint":"0000000100",
"values":[
["1357002072000", 12.0, 0],
["1357002082000", 13.0, 0],
["1357002092000", 14.0, 0]]
]
}