静载数据接口说明

1、静载数据接口说明、系统组成说明：1静载测试仪和无线传输仪均位于测试现场，相互之间使用电缆直接连接；2现场的检测数据由无线传输仪通过GPRSCDMA或3G网络上传至服务器；3由设备生产商自行开发针对各自测试仪器的数据接收程序，统一部署在质监站的服务器上。各设备生产商需确保数据由现场直接上传至质监站的服务器，中间不得经过设备生产商或检测单位自己的数据服务器，各设备生产商必须保证数据的真实性和完整性；4监督管理人员和检测单位人员通过Web服务访问数据，不能直接访问数据库服务。、接口数据库服务器运行WindowsServer2003或更高版本操作系统，数据库选用MicrosoftSQLServer20

2、05或更高版本。每个设备生产商在数据库服务器建立自己的登录名、用户名和数据库（如果有必要），考虑到服务器的安全因素，各登录名的服务器角色只能是public，用户名也只能在各生产商自己的数据库里拥有db_owner角色身份，该用户并不拥有直接读写接口数据库中数据表的权限，对于接口数据库的访问只能通过接口库提供的存储过程来实现。在各设备生产商需将各自建立的登录名上报备案后，数据库管理员将给该登录名分配执行接口数据库存储过程的权限。设备生产商的数据接收程序使用该登录名登录数据库，并运行接口数据库提供的存储过程写入测试数据和信息。需要写入数据库的信息分为三类：静载测试基本信息、静载测试详细数据和测试现

3、场日志。其中，静载测试详细数据和测试现场日志仅提供插入记录的操作，静载测试基本信息除提供插入记录的操作之外，还提供部分信息的更新操作。数据库服务器实例名称、数据库名称以具体的服务器安装环境为准。三、存储过程文档中的约定:约定用于斜体存储过程的参数。粗体存储过程名称、数据类型名以及必须按所显示的原样键入的文本。（方括号）可选语法项。不要键入方括号。1.插入静载测试基本信息Jy_splnsertBasicInfo语法:Jy_spInsertBasicInfoMachineld='Machineld',SerialNo='SerialNo',PileNo='P

4、ileNo',TestType='TestType',MaxLoad=MaxLoad,StartTime=StartTime,SourceParam=SourceParam,RecordCount=RecordCount,GpslsValid=GpsIsValid,GpsLongitude=GpsLongitude,GpsLatitude=GpsLatitude,IsTesting=IsTesting,CurrentParam=CurrentParam,CurrentData=CurrentData,Basiclnfold=BasiclnfoldOUTPUT,Shang

5、GangZheng='ShangGangZheng'参数:Machineld='Machineld'静载测试仪的编号，设备生产商必须要保证该编号的唯一性，不得出现两台设备的编号相同的情况。'Machinel啲数据类型为nvarchar(16)，无默认值。SerialNo='SerialNo'检测流水号，该流水号是在检测单位申报检测项目后，经监督部门审核通过并发放下来的流水号，流水号和桩号一起唯一确定一根的被检桩。SerialN的数据类型为nvarchar(24)，无默认值。PileNo='PileNo'桩号，桩号对应于现场

6、检测的实际桩号，桩号和流水号一起唯一确定一根的被检桩。数据类型为nvarchar(16)，无默认值。'PilelN的'TestType='TestType'检测选用的测试规范或试验方法。'TestTyp的'数据类型为nvarchar(32)，无默认值。MaxLoad=MaxLoad被检桩的最大预估荷载，单位为kN。MaxLoad的数据类型为real，无默认值。StartTime=StartTime检测开始的时间。StartTime的数据类型为datetime，无默认值。SourceParam=SourceParam检测开始时选用的原始测试参数。x

7、ml格式见文档后的说明。SourceParam的数据类型为xml，无默认值。原始测试参数的RecordCount=RecordCount检测总共的记录次数，记录次数会随着检测的进行不断增加。smalllnt，默认值为0。RecordCount的数据类型为GpsIsValid=GpslsValidGps定位信息是否有效，为0时表示Gps定位信息无效，随后的数会被忽略，其他值表示Gps信息有效。GpslsValid的数据类型为GpsLongitude禾口GpsLatitude参tinylnt，默认值为0。GpsLongitude=GpsLongitudeGps定位信息中的经度，单位为度，为正值时表

8、示东经，为负值时表示西经，该值在GpslsValid不为0时有效。GpsLongitude的数据类型为float，默认值为0。GpsLatitude=GpsLatitudeGps定位信息中的纬度，单位为度，为正值时表示北纬，为负值时表示南纬，该值在不为0时有效。GpsLatitude的数据类型为float，默认值为0。GpslsValidlsTesting=IsTesting被检桩是否正处于测试中，为0时表示被检桩中断测试或是已检测完成，随后的和CurrentData信息无效，其他值表示被检桩正在测试进程中，此时可以通过CurrentData信息以及已经上传的测试数据监控测试进程。IsTest

9、ing的数据类型为0。CurrentParamCurrentParam禾口tinylnt，默认值为CurrentParam=CurrentParam静载测试仪中实时的测试参数。该值在IsTesting不为0时有效。CurrentParam的数据类型为xml，默认值为NULL。测试参数的xml格式见文档后的说明。CurrentData=CurrentData静载测试仪中的测试进度和传感器的实时读数。该值在IsTesting不为0时有效。CurrentData的数据类型为xml，默认值为NULL。该值的xml格式见文档后的说明。BasicInfold=BasicInfoldOUTPUT信息插入成功

10、后，该条信息在数据表中的唯一标识。如果插入不成功，该值被设置为BasicInfold为输出变量，数据类型为int,无默认值。NULL。ShangGangZheng='ShangGangZheng'现场检测人员上岗证编号。'ShangGangZheng'的数据类型为nvarchar(16)，默认值为NULL。返回代码值:0：成功；其他值：由MicrosoftSQLServer定义的错误号。2.更新静载测试基本信息Jy_spUpdateBasiclnfo语法：Jy_spUpdateBasicInfoBasicInfold=BasicInfold,RecordCoun

11、t=RecordCount,GpsIsValid=GpslsValid,GpsLongitude=GpsLongitude,GpsLatitude=GpsLatitude,IsTesting=IsTesting,CurrentParam=CurrentParam,CurrentData=CurrentData参数：BasicInfold=BasicInfold要更新的基本信息的标识，该标识由存储过程型为int,无默认值。Jy_spInsertBasiclnfo输出。BasicInfold的数据类RecordCount=RecordCountGpsIsValid=GpslsValidGpsLon

12、gitude=GpsLongitudeGpsLatitude=GpsLatitudelsTesting=IsTestingCurrentParam=CurrentParamCurrentData=CurrentData以上参数的意义与存储过程Jy_splnsertBasicInfo相同，但各参数的默认值均为NULL。返回代码值：0：成功；50001:试图引用不存在的或非本设备商创建的BasicInfold；其他值：由MicrosoftSQLServer定义的错误号。注释：因为不是每次都需要更新所有的信息，所以如果某个参数的值为NULL,该参数将不会被更新。但是以下情况例外： 如果参数GpsIs

13、Valid为NULL，参数GpslsValid、GpsLongitude和GpsLatitude者E不会被更新，即使参数GpsLongitude和GpsLatitude不为NULL; 如果参数GpsIsValid不为NULL,但是参数GpsLongitude或GpsLatitude中有一个或两个为NULL，参数GpsIsValid、GpsLongitude和GpsLatitude都不会被更新； 如果参数IsTesting为NULL,参数IsTesting、CurrentParam和CurrentData都不会被更新，即使参数CurrentParam和CurrentData不为NULL;3. 插

14、入静载测试每次的采样数据Jy_splnsertDetailsData语法：Jy_spInsertDetailsDataBasicInfold=BasicInfold,SampleTime=SampleTime,LoadDirect=LoadDirect,Grade=Grade,SampleCount=SampleCount,TimeCount=TimeCount,Loading=Loading,RealLoading=ReadLoading,RealPress=叮RealPress,S1=S1,S2=S2,S3=S3,S4=S4,S5=S5,S6=S6,S7=S7,S8=S8,S9=S9,S1

15、0=S10,S11=S11,S12=S12,SAverage=SAverage,U1=:U1,U2=:U2,U3=:U3,U4=:U4,U5=:U5,U6=:U6,U7=:U7,U8=:U8,U9=:U9,U10=U10,U11=U11,U12=U12参数:Basiclnfold=BasiclnfoldJy_splnsertBasicInfo输出。Basiclnfold该次采样数据对应的基本信息的标识，该标识由存储过程的数据类型为int,无默认值。SampleTime=SampleTime该次采样的时间。SampleTime的数据类型为datatime，无默认值。0时表示卸载，其他值表示加载。

16、LoadDirect的数据类型为tinyint，LoadDirect=LoadDirect该次采样时的荷载方向。为无默认值。Grade=Grade该次采样时的测试级别，从0开始计数，对应于初始级（该级的理论荷载为0）。第一次加上荷载的测试级别为1（即使是第一次加两级）。Grade的数据类型为tinyint，无默认值。SampleCount=SampleCount该次采样数据是该级测试的第几次采样，每级均从1开始计数，对应于该级的初始读数（该级荷载尚未施加时的读数，理论上与上一级的最后一次读数相同）。SampleCount的数据类型为smallint，无默认值。TimeCount=TimeCou

17、nt该次采样数据是该级测试的第几分钟的采样，该时间的单位为分钟，是该级测试按规范要求的采样间隔时间累计到该次时的总时间，注意是理论上的该级的累计测试时间，不是实测的该级累计时间。每级都是从0开始累计。TimeCount的数据类型为smallint，无默认值。Loading=Loading该次采样时的理论荷载，单位为kN。Loading的数据类型为real，无默认值。RealLoading=RealLoading该次采样时的实测荷载，单位为kN。RealLoading的数据类型为real，无默认值。RealPress=RealPress该次采样时的实测油压，单位为MPa。如果采用的直接测力的传感

18、器进行试验，该值为NULL。RealPress的数据类型为real，默认值为NULL。S1=S1S2=S2S3=S3S4=S4S5=S5S6=S6S7=S7S8=S8S9=S9S10=S10S11=S11S12=S12该次采样时的各通道的实测位移，单位为mm。如果未使用该位移通道或该通道被用作锚桩监测，该通道对应的值必须设置为NULL。S1.S12的数据类型为real，默认值为NULL。SAverage=SAverage该次采样时的平均位移，单位为mm。SAverage的数据类型为real，默认值为0。U1=U1U2=U2U3=U3U4=U4U5=U5U6=U6U7=U7U8=U8U9=U9U

19、10=U10U11=U11U12=U12该次采样时的各通道的实测上拔位移，单位为mm。如果未使用该位移通道或该通道被用作试桩监测，该通道对应的值必须设置为NULL。U1.U12的数据类型为real，默认值为NULL。返回代码值：0：成功；50001：试图引用不存在的或非本设备商创建的BasicInfoId；其他值：由MicrosoftSQLServer定义的错误号。4插入静载试验的现场日志记录Jy_spInsertTestingLoglnfo语法：Jy_spInsertTestingLoglnfoBasiclnfold=Basiclnfold,EventTime=EventTime,Event

20、lnfo='Eventinfo,Remark=Remark参数:Basiclnfold=BasiclnfoldJy_splnsertBasicInfo输出。BasicInfold的该日志记录对应的基本信息的标识，该标识由存储过程数据类型为int,无默认值。EventTime=EventTime日志事件发生的时间。EventTime的数据类型为datatime，无默认值。Eventlnfo='Eventinfo'日志事件的简短描述，由设备生产商自行填写，比如“修改测试参数”、“人为强制采样”等。对于较复杂的信息，在字段Remark中做详细说明。Eventlnf啲数据类型为

21、nvarchar(16)，无默认值。Remark=Remark日志事件的备注。对于比较简单的日志事件，由EventTime和Eventlnf就可以描述清楚的，可以忽略此参数。Remark的数据类型为xml，默认值为NULL。该值的xml格式见文档后的说明。返回代码值：0:成功；50001:试图引用不存在的或非本设备商创建的Basiclnfold;其他值：由MicrosoftSQLServer定义的错误号。5初始化静载测试仪状态Jy_splnitialize将某设备生产商所有的或指定编号的静载测试仪设置为未测试状态。此存储过程主要用于数据接收程序启动或退出时初始化数据。语法：Jy_spIniti

22、alizeMachineld='Machineld'参数：Machineld=Mhchineld'静载测试仪的编号。如果Machineld不为NULL,则由该静载测试仪测试的所有数据的基本信息中的“正在测试状态(IsTesting)”将会被置为0,如果Machineld为NULL,则该设备生产商的所有静载测试仪的“正在测试状态(IsTesting)”都将会被置为0。'Machinel啲数据类型为nvarchar(16)，默认值为NULL。返回代码值：0：成功；其他值：由MicrosoftSQLServer定义的错误号。四、数据写入的流程接口库内数据的插入和更新都

23、会记录和比对存储过程执行者的登录名，用以辨别该数据属于哪个设备厂商的，同时也避免不同设备厂商之间的干扰。1数据接收程序启动时调用Jy_spInitialize，不带输入参数，目的是让接口库内该设备厂商所有的数据状态为“未测试”（如果数据接收程序意外退出，有可能会有一些测试数据的状态为“正在测试”，如果不进行处理，这些状态有可能不正确）。2当接收到一条现场测试数据时，必须根据数据的相关信息确定该数据是新的试桩数据，还是已有数据的后续部分，这要求数据接收程序要保留已经写入接口库里的数据的BasicInfold和该数据的关键信息，以备比对。1）如果是新的试桩数据，调用Jy_spInsertBasic

24、Info插入一条新的基本信息，该存储过程带有一个OUTPUT参数BasicInfold，代表该试桩数据在基本信息表内的ID号，应用程序必须保留这个ID号和本条数据的关键信息，以备以后比对。用刚得到的ID号作为参数之一，调用Jy_spInsertDetailsData，将数据写入接口库内的详细数据表。ID号，并作为参数之2）如果不是新的试桩数据，从保留的BasicInfold中查找到该数据对应的一，调用Jy_spInsertDetailsData，将数据写入接口库内的详细数据表。3）以ID号为参数之一调用Jy_spUpdateBasiclnfo更新基本信息表中的记录数、测试状态、GPS信息、现场

25、参数或现场即时数据等信息。3当单独接收到GPS言息、现场参数或现场即时数据（即时数据不是采样点，不需要写入详细记录表中）时，查找该数据对应的ID号，并以该ID号为参数之一调用Jy_spUpdateBasiclnfo更新基本信息表中的相关信息。4如果有现场日志记录需要写入，先查找到该数据对应的ID号，并调用Jy_spInsertTestingLoglnfo写入日志内容。5当接收到某个测试已经结束的信息的时候，同样要查找该数据的ID号，并调用Jy_spUpdateBasicInfo更新基本信息表中的测试状态。或者以设备编号为参数调用Jy_spInitialize，该过程会把该设备测试的所有数据的状

26、态设置为“未测试”。6如果收到某台设备下线的信息或是超时的信息，以该设备编号为参数调用Jy_splnitialize把该设备测试的所有数据的状态设置为“未测试”。7数据接收程序退出时调用Jy_splnitialize，不带输入参数。注：所有的信息都以BasicInfold关联，所以数据接收程序必须保留每个新插入的基本信息时输出的BasicInfoId，并和关键信息一起保存。这些关键信息必须足以区分数据是否是同一根桩的同一次测试。这些信息的内容由设备制造厂商自行决定。以上存储过程中共用到4个xml类型的参数：SourceParam、CurrentParam、CurrentData和Remark。

27、每个xml类型都包含多个元素，每个元素表示一项参数或数据，如果该参数或数据由多个数值组成，各数值之间用“，”分隔。1.原始测试参数SourceParamSourceParam的根节点为“原始参数”，可以在根节点之下另建分类标签，也可将所有参数直接归于根节点之下，由设备生产商自行决定。以下例子中，表格内是某静载试验的原始测试参数，后面是对应的xml文本。参数分类参数参数值试验规范试验类型竖向试验试验方法快速维持荷载法最大预估荷载4200kN预分级数10首次加载等级2判稳开关不判稳每级测试时间60分钟加载读数间隔0,5,10,15,15,15,15,15,卸载读数间隔0,15,15,30,30,3

28、0,30,30,每次卸载级数2补载参数加载方式自动补载开关允许允许掉载量40kN千斤顶数量2千斤顶内径250mm最大允许沉降量40mm传感器设置位移传感器用途基桩，基桩，基桩，基桩,位移传感器编号1111,1112,1113,1114,压力传感器类型压力变送器压力传感器编号No5678?xmlversion="1.0"?V原始参数试桩规范V试验类型竖向试验V/试验类型V试验方法桩基快速维持荷载法V/试验方法V最大预估荷载4200kNV/最大预估荷载v预分级载10v/预分级载v首次加载等级2/首次加载等级判稳开关不判稳/判稳开关每级测试时间60分钟/每级测试时间加载读数间隔0

29、,5,10,15,15,15,15,15,/加载读数间隔卸载读数间隔0,15,15,30,30,30,30,30,/卸载读数间隔每次卸载级数2/每次卸载级数/试桩规范V补载参数加载方式全自动/加载方式补载开关允许/补载开关允许掉载量40kNv/允许掉载量千斤顶数量2/千斤顶数量最大允许沉降量/补载参数传感器设置位移传感器用途位移传感器编号压力传感器类型压力传感器编号/传感器设置40mm/最大允许沉降量千斤顶内径250mm/千斤顶内径基桩，基桩，基桩,基桩,/位移传感器用途1111,1112,1113,1114,/位移传感器编号压力变送器/压力传感器类型No5678/压力传感器编号/原始参数2实时的测试参数CurrentParamCurrentParam的根节点为"当前参数设定”，格式与SourceParam相同，但是在根节点之下必须包含标签“时间”，表示该参数对应的时间。在上面的例子中，如果从开始试验后参数未作任何改动，对应的实时测试参数的xml文本如下：?xmlversion="1.0"?当前参数设定时间201009T812:27:11/时间试桩规范试验类型竖向试验/试验类型试验方法桩基快速维持荷载法/试验方法最大预估荷