RESTful API - gethistoricaldata (enuSpace for mars)

RESTful API - gethistoricaldata

특정변수의 히스토리 데이터에 대하여 값을 요청

--------------------------------------------

Description

enuSpace 서버측에 데이터베이스의 변수 히스토리 값을 요청하는 API

--------------------------------------------

Request

HTTP Method : POST

URI : http://localhost:8080/gethistoricaldata?tagid=@043DFEDEFD. A0&duration=300&endtime=0

Query Parameters

        tagid : database tagid

        duration : duration time

        endtime = 0      // 0->current time

Example : ?tagid=@043DFEDEFD. A0&duration=300&endtime=0

Content-Type : application/json; charset=UTF-8

--------------------------------------------

Response

Body

json file format

TIME_FORMAT : "SIM" or "SYS" -> SIM : Simulation Time, SYS : System Time

Body Example

{   "RESULT": "OK",   "RESULT_CODE": "RESULT_OK", "MESSAGE": "GETHISTORICAL DATA COMPLETE", "TIME_FORMAT": "SIM", "TAGID": "@043DFEDEFD. A0",   "VALUES": {  "TIME":"2017-04-19 10:46:23.001" , "VALUE":"84"  },{  "TIME":"2017-04-19 10:46:21.959" , "VALUE":"77"  } }

--------------------------------------------

Sample Call

JavaScript

function gethistoricaldata(tagid, duration, endtime, datalist) {   var xmlHttp = new XMLHttpRequest();   var strUrl = "gethistoricaldata" ; var strParam= "tagid="+tagid+"&"+"duration="+duration+"&"+"endtime="+endtime; xmlHttp.open("POST", strUrl, false); xmlHttp.setRequestHeader("Content-Type","application/x-www-form-urlencoded;charset=UTF-8"); xmlHttp.setRequestHeader("Cache-Control","no-cache, must-revalidate"); xmlHttp.setRequestHeader("Pragma","no-cache"); xmlHttp.send(strParam); var msg = xmlHttp.responseText; var arr = JSON.parse(msg);     if (arr.RESULT == "OK") {         var values = arr.VALUES;         if(values.length > 0)         {             if(arr.TIME_FORMAT == "SIM")             {                 for(var i in values)                 {                     var recive_time = new Date(values[i].TIME).valueOf();                     var sub_time = new Date("1601-01-01 00:00:00.000").valueOf();                     var x = recive_time - sub_time;                     var y = parseFloat(Number(values[i].VALUE));                     var point_data = new data_point(x, y);                     datalist.unshift(point_data);                 }             }             else if(arr.TIME_FORMAT == "SYS")             {                 for(var i in values)                 {                     var x = new Date(values[i].TIME).valueOf();                     var y = parseFloat(Number(values[i].VALUE));                     var point_data = new data_point(x, y);                     datalist.unshift(point_data);                 }             }         }     }     else     {         console.log("gethistoricaldata: 받아오기 에러");     } }