上传频率计单值数据

地下工程和深基坑安全监测预警系统数据采集专用接口(中间件)使用说明目录1. 概述 32. 定义 33. 数据接口函数 33.1. 登陆验证 33.2. 获取工程信息 43.3. 上传全站仪数据 53.4. 上传水准仪数据 73.5. 上传测斜仪数据 103.6. 上传频率计(单值)数据 113.7. 上传频率计(四值)数据 123.8. 上传频率计(六值)数据 143.9. 上传水位计数据 163.10. 上传裂缝监测数据 174. 函数返回值参考 18

概述本说明针对地下工程和深基坑安全监测预警系统(以下简称“监测系统”)数据采集专用接口(中间件)加以描述。采集接口是基坑监测设备数据采集上传的统一入口，方便设备供应商或第三方软件供应商上传监测数据。采集专用接口为动态链接库文件形式，封装了地下工程和深基坑各监测项目数据上传所需的全部函数。定义字符串本说明中所有关于字符串的数据(包括输入与输出字符串)，默认为都是以’\0’Xml包封装格式所有xml内容(包括输入与输出)都使用UTF-8字符编码。数据接口函数登陆验证IntFT_Login(constchar*userId,constchar*password);验证用户信息，只有登录成功之后才允许调用其它接口函数。该方法只须成功调用一次即可。参数UserId用户名Password密码返回值如果登录成功，则返回0。如果登录失败，则返回相应的错误码。备注在使用接口的任何函数之前，必须保证成功调用过Login方法进行登录，否则将调用失败。获取工程信息IntFT_GetProjectInfo(char**data,int*dataLength);从服务器获取工程名称、检测项目等工程信息。返回值的格式如下：<NewDataSet><!--工程名称--><PROJECT><!--工程ID--><ID>94d15263-ae8b-4724-ae67-091b05fbd84a</ID><!--工程编号--><CODE>jc000a0007</CODE><NAME>系统测试</NAME></PROJECT><!--监测项目--><ITEM> <!--监测项目ID--><SYS_ITEMID>1</SYS_ITEMID><P_PROJECTID>94d15263-ae8b-4724-ae67-091b05fbd84a</P_PROJECTID><NAME>围护墙边坡顶部水平位移</NAME><!--测点编号前缀--><CODING>WYS</CODING></ITEM><!--监测编号--><JCCODE><SEQ_NO>jc000a0005130417008</SEQ_NO><P_PROJECTID>94d15263-ae8b-4724-ae67-091b05fbd84a</P_PROJECTID></JCCODE></NewDataSet>参数data用来存储返回结果的缓存。返回的结果为xml格式字符串。该参数的内存由函数内部分配，但不自动清理，请在使用完成后手动清理内存。dataLength结果缓存区的长度。如果函数调用成功，则该参数值为返回结果的长度。返回值如果函数调用成功，则返回0。如果调用失败，则返回相应的错误码。上传全站仪数据IntFT_UploadTotalStationData(constchar*data);上传全站仪的采集数据，参数使用xml的格式字符串。参数dataxml格式的字符串。格式如下：<?xmlversion='1.0'encoding='utf-8'?><DataSet><TotalStationData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--监测项目--><SurveillanceItemId></SurveillanceItemId><!--测站编号--><StationNum></StationNum><!--测点编号--><PointNum></PointNum><!--斜距--><SJ1></SJ1><SJ2></SJ2><!--观测坐标--><X></X><Y></Y><Z></Z><!--水平角盘左、盘右--><HAngle_FL></HAngle_FL><HAngle_FR></HAngle_FR><!--竖直角盘左、盘右--><VAngle_FL></VAngle_FL><VAngle_FR></VAngle_FR><!--方位角--><Azimuth></Azimuth><!--视点类型--><VisionPointType></VisionPointType><!--监测日期--><Date></Date><!--备注--><Comment></Comment></TotalStationData></DataSet>返回值如果上传成功，则返回0，如果上传失败，则返回相应的错误编码。上传水准仪数据IntFT_UploadLevelInstrumentData(constchar*data);上传水准仪的采集数据，参数使用xml的格式字符串。参数dataxml格式的字符串。格式如下：<?xmlversion='1.0'encoding='utf-8'?><DataSet><LevelInstrumentData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--监测项目--><SurveillanceItemId></SurveillanceItemId><!--测点编号--><PointNum></PointNum><!--Z1、Z2点的高程--><HZ1></HZ1><HZ2></HZ2><!--前、后视点读数--><Front1></Front1><Front2></Front2><FrontAvg></FrontAvg><Back1></Back1><Back2></Back2><BackAvg></BackAvg><!--实测高程--><SCGC></SCGC><!--修正后的高程--><H></H><!--前、后视距--><DistanceFront></DistanceFront><DistanceBack></DistanceBack><!--监测日期--><Date></Date><!--备注--><Comment></Comment></LevelInstrumentData><!--平差值及其精度--><LevelInstrumentAdjData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--起点、终点编号--><StartPointNum></StartPointNum><EndPointNum></EndPointNum><!--中误差--><MSE></MSE></LevelInstrumentAdjData></DataSet>返回值如果上传成功，则返回0。如果上传失败，则返回相应的错误编码。上传测斜仪数据IntFT_UploadLevelInstrumentData(constchar*data);上传测斜仪的采集数据，参数使用xml的格式字符串。参数dataxml格式的字符串。格式如下：<?xmlversion='1.0'encoding='utf-8'?><DataSet><InclinometerData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--监测项目--><SurveillanceItemId></SurveillanceItemId><!--测点编号--><PointNum></PointNum><!--深度--><Depth></Depth><!--A0、A180数据--><A0></A0><A180></A180><!--监测日期--><Date></Date><!--备注--><Comment></Comment></InclinometerData></DataSet>返回值如果上传成功，则返回0。如果上传失败，则返回相应的错误编码。上传频率计(单值)数据Int__stdcallFT_UploadFrequencyMeterSingleData(constchar*data);上传频率计（单值）的采集数据，参数使用xml的格式字符串。参数dataxml格式的字符串。格式如下：<?xmlversion='1.0'encoding='utf-8'?><DataSet><FrequencyMeterSingleData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--监测项目--><SurveillanceItemId></SurveillanceItemId><!--测点编号--><PointNum></PointNum><!--模数值--><Modulus1></Modulus1><!--频率值--><Frequency1></Frequency1><!--监测日期--><Date></Date><!--备注--><Comment></Comment></FrequencyMeterSingleData></DataSet>返回值如果上传成功，则返回0。如果上传失败，则返回相应的错误编码。上传频率计(四值)数据IntFT_UploadFrequencyMeterSingleData(constchar*data);上传频率计（单值）的采集数据，参数使用xml的格式字符串。参数dataxml格式的字符串。格式如下：<?xmlversion='1.0'encoding='utf-8'?><DataSet><FrequencyMeterSingleData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--监测项目--><SurveillanceItemId></SurveillanceItemId><!--测点编号--><PointNum></PointNum><!--模数值--><Modulus1></Modulus1><Modulus2></Modulus2><Modulus3></Modulus3><Modulus4></Modulus4><!--频率值--><Frequency1></Frequency1><Frequency2></Frequency2><Frequency3></Frequency3><Frequency4></Frequency4><!--频率平均值--><FrequencyAvg></FrequencyAvg><!--监测日期--><Date></Date><!--备注--><Comment></Comment></FrequencyMeterSingleData></DataSet>返回值如果上传成功，则返回0。如果上传失败，则返回相应的错误编码。上传频率计(六值)数据IntFT_UploadFrequencyMeterSixData(constchar*data);上传频率计（六值）的采集数据，参数使用xml的格式字符串。参数dataxml格式的字符串。格式如下：<?xmlversion='1.0'encoding='utf-8'?><DataSet><FrequencyMeterSixData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--监测项目--><SurveillanceItemId></SurveillanceItemId><!--测点编号--><PointNum></PointNum><!--模数值--><Modulus1></Modulus1><Modulus2></Modulus2><Modulus3></Modulus3><Modulus4></Modulus4><Modulus5></Modulus5><Modulus6></Modulus6><!--频率值--><Frequency1></Frequency1><Frequency2></Frequency2><Frequency3></Frequency3><Frequency4></Frequency4><Frequency5></Frequency5><Frequency6></Frequency6><!--频率平均值--><FrequencyAvg></FrequencyAvg><!--监测日期--><Date></Date><!--备注--><Comment></Comment></FrequencyMeterSixData></DataSet>返回值如果上传成功，则返回0。如果上传失败，则返回相应的错误编码。上传水位计数据IntFT_UploadWaterLevelData(constchar*data);上传水位计的采集数据，参数使用xml的格式字符串。参数dataxml格式的字符串。格式如下：<?xmlversion='1.0'encoding='utf-8'?><DataSet><FrequencyMeterSixData><!--设备编号--><DeviceNum></DeviceNum><!--设备型号--><DeviceModel></DeviceModel><!--工程编号--><ProjectCode></ProjectCode><!--监测编号--><SurveillanceNum></SurveillanceNum><!--监测项目--><SurveillanceItemId></SurveillanceItemId><!--测点编号--><PointNum></PointNum><!--测量读数值--><Data></Data><!--监测日期--><Date></Date><!--备注--><Comment></Comment></Frequen