档案库房智能化建设配置表、管理系统标准通信接口协议.docx

（资料性附录）档案库房智能化建设配置表表A.1给出了档案库房智能化建设涉及到的管理系统、子系统、智能模块等的建设配置。表A.1档案库房智能化建设配置表档案库房智能化建设机关、团体、企业事业单位和其他组织档案室乙级甲级特级档案馆档案馆档案馆管理系统OOO实体档案智能存储与管理子系统库区智能管控子系统0环境管控智能模块O防水监测智能模块OO防光智能模块OOO防有害生物智能模块OO安全技术防范子系统火灾自动报警子系统按国家现行有关标准进行配置基础设施与安全管理要求基础信创0O全栈信创OO数据存储与备份OO应急供电OO电气安全信息安全O0工控安全OOO注:一应配置；O宜配置；O一可配置。附录B（规范性附录）管理系统标准通信接口协议管理系统接口规定了管理系统以及包含的子系统与外部系统间的通信要求，并规定接口名称、参数格式。B.1管理系统基础接口管理系统基础接口规定了管理系统与外部系统间的通信要求，并规定接口名称、参数格式。（见表B.1.1、表B.1.2、表B.1.3、表B.1.4）。B.1.1获取库房状态接口表B.1.1获取库房状态接口方法名称KetRepTenStateInfo()调用方法http:服务器IP:端口/archiveRepositoryService功能描述通过调用该接口获取库房的状态输入项参数名称类型长度允许为空说明备注无返回值参数名称类型长度允许为空说明备注ResultString否返回库房状态结果，包含防火、防盗、防水、防尘、防有害气体以及温湿度调控(fireproof:0,antitheft:0,waterproof:Ozdustproof:0,harmfulgases:Oztemperature:0,humidity:0注：。-不报警：I-报警异常B.1.2获取库房实时运行故障接口表B.12获取库房实时运行故障接口方法名称KetRepRunFaultInfoO调用方法http:服务器IP:端口/archiveRepositoryService功能描述通过调用该接II获取库房实时运行故障信息输入项参数名称类型长度允许为空说明备注无返回值参数名称类型长度允许为空说明备注ResultString否返回库房实时运行报警信息，包含运行温度、电压、电流、(oeratiHgTemperature:0,operatingVo1tage:0,operatingCurrent:0,注：0不报警，报警,OPeratingT。InPeratUre一运行温度，OPeratiHgVo11age-运行电压，OPeralingCUrrenl-运行电流异常B.1.3获取库房的电气信息接口表B.13获取库房的电气信息接口方法名称getSpecificRepE1.EInfo(StringrepositoryNo)调用方法http:服务器IP:端口archiVeRepositoryService/功能描述通过该接口获取库房的电气数据信息输入项参数名称类型长度允许为空说明备注repos1.toryNoString6否库房编码参见DA/T65-2017附录C-C.4返回值参数名称类型长度允许为空说明备注ResultString否返回库房电气信息，包含电压、电流、功率(operatingTemperature:26,operatingVoltage:200,operatingCurrent:1,OperatingPower:200注：operatingTemperature一运行温度，operatingVoltage-运行电压，OperatingCurrent一运行电流,operatingPowcr-功率异常B.1.4库房电气信息上报接口表B.1.4库房电气信息主动上报接口方法名称uplOadRepositoryE1.EInfo(StringrepositoryNo,Stringdatalnfo)调用方法h11p:服务器IP:端口/archiveRepositoryService功能描述通过该接口上报电气信息数据输入项参数名称类型长度允许为空说明备注repositoryNoString6否库房编码参见DA/T65-2017附录C-C.4datalnfoString否电气信息，包含电压、电流、功率(operatingTemperature:26,operatingVo1tage:200,operatingCurrent:1,OperatingPower:200)注：OPeratingTelnPeralUre-运行温支，operatingVoltage-运行电压，OPeratingCUrrent一运行电流，OPeratingPg,er-功率返回值参数名称类型长度允许为空说明备注ResultString否返回库房电气信息上报成功/失败Iresultitrue/result:false异常B.2实体档案智能存储与管理子系统接口实体档案智能存储与管理子系统接口规定了实体档案智能存储、管理系统与外部系统间的通信要求，并规定接口名称、参数格式（见表B.2.2、表B.2.3、表B.2.4、表B.2.5）。B.2.1密集架智能管理系统接口该接口通信协议满足DA/T65-2017档案密集架智能管理系统技术要求中附录A密集架控制系统总线通信要求。B.2.2获取库房出入库信息接口表B.22获取库房出入库信息接口方法名称getSpecIficRepIOInfo(StringrepositoryNo)调用方法http:服务器IP:端口/archiveRepositoryService功能描述通过该接口获取指定库房的出入库信息输入项参数名称类型长度允许为空说明备注repositoryNoString6否库房编码参见DA/T65-2017附录C-C.4返回值参数名称类型长度允许为空说明备注ResultString返回库房出入库信息(档案或盒号：1,档案或盒号：2,注：I-在库，2-非法出入库，3-借出，异常B.2.3库房出入库信息上报接口表B.23库房出入库信息上报接口方法名称UploadRepositoryIOInfo(StringrepositoryNo,Stringdatalnfo)调用方法http:服务器IP:端口/archiveReositoryService功能描述通过该接口接收库房出入库信息输入项参数名称类型长度允许为空说明备注FepositoryNoString6否库房编码参见DA/T65-2017附录C-C.4datalnfoString否出入库信息(档案或盒号：1,档案或盒号：2,注：I-在库，2-非法出入库，3-借出，返回值参数名称类型长度允许为空说明备注ResultString否返回库房出入库信息上报成功/失败result:true/result:false异常B.2.4库房盘点结果上报接口表B.24库房盘点结果上报接口方法名称UploadDeviceINVInfo(StringpositionNo,Stringdatalnfo)调用方法http:/服务器IP:端口archiVeRepositoryService功能描述通过该接口接收盘点结果数据输入项参数名称类型长度允许为空说明备注positionNoString否库房位置编码参见DA/T65-2017附录C-C.1datalnfoString否盘点结果(total:12,Inventory1.ist:档案1,档案2,档案3,noInventory1.ist:档案1,档案2,档案3)注：total-盘点总数，inventOry1.iSt-盘到集合，noInventOry1.iSt-未盘到集合返回值参数名称类型长度允许为空说明备注ResultString否返回盘点结果上报成功/失败result:true/resultfalse异常B.2.5启动库房设备报警接口表B.25启动库房设备报警接口方法名称StartDeviceAlarm(StringrepositoryNo)调用方法htt:服务器IP:端口/archiveRepositoryService功能描述通过调用该接口启动库房设备报警输入项参数名称类型长度允许为空说明备注reposItoryNoString6否库房编码参见DA/T65-2017附录C-C.4返回值参数名称类型长度允许为空说明备注ResultString否返回库房设备启动报警成功/失败result:true/result:false异常B.3库区智能管控子系统接口库区智能管控子系统接口包含环境管控智能模块、防水监测智能模块、防光智能模块、防有害生物智能模块，规定了库区智能管控子系统与外部系统间的通信要求，并规定接口名称、参数格式（见表B.3.1）B.3.1库房设备模式切换接口表B.3.1库房设备模式切换接口方法名称SetDeviceRunModel(StringrepositoryNo,StringmodeNo)调用方法http:服务器IP:端口archiveRepositoryService功能描述通过调用该接口设置库房设备的运行模式输入项参数名称类型长度允许为空说明备注repositoryNoString6否库房编码参见DT65-2017附录C-C.4modeNoString3否模式编码1：手动模式2:自动模式返回值参数名称类型长度允许为空说明备注ResultString否返回结果，模式切换成功/失败result:true/result:false异常B.3.2环境管控智能模块接口环境管控智能模块接口规定了环境管控智能模块与外部系统间的通信要求，并规定接口名称、参数格式（见表B.3.2.1）。B.3.2.1获取口库房的环境信息接口表B.3.2.1获取库房的环境信息接口方法名称KetRepEnvInfo(StringrepositoryNo)调用方法http:服务器IP:端口/archiveRepositoryService功能描述通过调用该接口获取库房的综合环境指标信息输入项参数名称类型长度允许为空说明备注repositoryNoString6否库房编码参见DA/T65-2017附录C-C.4返回值参数名称类型长度允许为空说明备注ResultString否返回库房环境指标，包含温度、湿度、甲醛、PM2.5、PMlO.CO2、TVOC.SO2、N02(temperature:21,humidity:43,CH20:O,PM2.5:2,PMlO:10,C02:430,TVOC:0,S02:0,N02:0)异常B.3.3防水监测智能模块接口防水监测智能模块接口规定了防水监测智能模块与外部系统间的通信要求，并规定接口名称、参数格式（见表B.3.3.1、表B.3.3.2）。B.3.3.1库房防水监测报警状态上报接口表B.3.3.1库房防水监测报警状态上报接口方法名称UploacI1.eakWaterStatus(StringrepositoryNo,Stringis1.eakage)调用方法http:服务器IP:端口/archiveRepositoryService功能描述通过该接口上报库房防水报警状态输入项参数名称类型长度允许为空说明备注repos1.toryNoString6否库房编码参见DA/T65-2017附录C-C.4is1.eakageSting否漏水状态1：不漏水0：漏水返回值参数名称类型长度允许为空说明备注ResultString否返回漏水状态上报成功/失败(result:true/(result:false异常B.3.3.2获取库房防水监测报警状态接口表B.332获取库房防水监测报警状态接口方法名称Ket1.eakWaterStatus(StringrepositoryNo)调用方法http:服务器IP:端口/archiveRepositoryService输入项参数名称类型长度允许为空说明备注reposItoryNoString6否库房编码参见DA/T65-2017附录C-C.4返回值参数名称类型长度允许为空说明备注ResultString否返回库房漏水报警状态信息(IeakageState:0)注：0不湖水，I-漏水异常功能描述通过该接口获取库房防水监测报警状态B.3.4防光智能模块接口B.3.4.1获取库房光照报警状态接口表B.3.4.1获取库房光照报警状态接口方法名称getRep1.ightStatelnfo()调用方法http:服务器IP:端口/archiveRepositoryService功能描述通过调用该接II获取库房的光照报警状态输入项参数名称类型长度允许为空说明备注无返回值参数名称类型长度允许为空说明备注ResultString否返回库房光照报警状态(antilight:0注：。不报警：1报警异常B.3.5防有害生物智能模块接口B.3.5.1获取库房有害生物报警状态接口表B.3.5.1获取库房有害生物报警状态接口方法名称getRepHfStateInfo()调用方法http:服务器IP:端口archiveReposiSryService功能描述通过调用该接11获取库房的有害生物报警状态输入项参数名称类型长度允许为空说明备注无返回值参数名称类型长度允许为空说明备注ResultString否返回库房有害生物报警状态(harmfulorganisms:0注：0不报警；1报警异常B.4安全技术防范子系统接口安全技术防范子系统接口规定了安全技术防范子系统与外部系统间的通信要求，并规定接口名称、参数格式（见表B.4.1、表B.4.2、表B.4.3、表B.4.4、表B.4.5）。B.4.1库房布防开启、关闭切换接口表B4.1库房布防开启、关闭切换接口方法名称SetDeployDefence(StringrepositoryNo,StringisDeploy)调用方法http:服务器IP:端口archiVeRepositoryService功能描述通过该接口库房布防状态进行切换输入项参数名称类型长度允许为空说明备注repos1.toryNoString6否库房编码参见DA/T65-2017附录C-C.4isDeployString3否布防状态码1:开启布防2:撤销布防返回值参数名称类型长度允许为空说明备注ResultString否返回布防切换成功/失败(result:true/result:false异常B.4.2库房报警信息上传接口表B.4.2库房报警信息上传接口方法名称UploadAlarinInfo(StringrepositoryNo,Stringdatalnfo)调用方法http:服务器IP:端口/archiveRepositoryService功能描述通过该接口接收库房报警信息输入项参数名称类型长度允许为空说明备注repositoryNoString6否库房编码参见DA/T65-2017附录C-C.4datalnfoString否报警内容,包含入侵报警、烟雾报警、门禁报警，(intrusionAlarm:0,SmokeAlarm:0,accessControlAlarmiO,)注：。未报警，报警,intrusionAlarm-入侵报警，SlnOkeAIarm-烟雾报警，accessControlAlarm门禁报返回值参数名称类型长度允许为空说明备注ResultString否返回库房报警信息上传成功/失败Iresultitrue/result:false异常B.4.3获取库房报警记录接口表B.43获取库房报警记录接口方法名称getAlarmlnfo(StringrepositoryNo)调用方法http:服务器IP:端口/archiveReositoryService功能描述通过该接口获取库房的报警记录输入项参数名称类型长度允许为空说明备注repositoryNoString6否库房编码参见DA/T65-2017附录C-C.4返回值参数名称类型长度允许为空说明备注ResultString否返回报警内容，包含入侵报警、烟雾报警、门禁报警，(intrusionAlarm:0,SmokeAlarm:0,accessControlAlarm:0,)注：O-耒报警.I-报警，intrusionAlarm-入侵报警,SmokeAlann-烟雾报警，accessControIAIarmI'1禁报警异常B.4.4库房用户信息上报接口表B.4.4用户信息上报接口方法名称UploadUserInfo(Stringuserinfo)调用方法http:服务器IP:端口archiVeRepositoryService功能描述用户身份信息上报，用于实现库房权限统一认证输入项参数名称类型长度允许为空说明备注userInfoString无否用户信息(UserNameiadmin,password:123456,trueName:管理员)注：USerName-登录名，PaSSWOIl-登录密码，trueName-用户名，123456-初始密码明文返回值参数名称类型长度允许为空说明备注ResultString否返回上报结果成功/失败Iresultitrue/result:false异常B.4.5库房用户信息分发接口表B.4.5库房用户信息分发接口方法名称getUserlnfo(StringrepositoryNo)调用方法http:服务器IP:端口/archiveRepositoryService功能描述用户身份信息分发到库房，用于实现库房权限统认证输入项参数名称类型长度允许为空说明备注repositoryNoString6否库房编码参见DA/T65-2017附录C-C4返回值参数名称类型长度允许为空说明备注ResultString否返回用户信息(USerNameiadmin,password:123456,trueName:管理员)注：USerName-登录名，passwOrd登录密码，trueName-用户名,123456-初始密码明文异常B.5火灾自动报警子系统接口火灾自动报警子系统接口规定了火灾自动报警子系统与外部系统间的通信要求，并规定接口名称、参数格式(见表B.5.1)。B.5.1库房消防设备主动上报报警状态接口表B.5.1库房消防设备主动上报报警状态接口方法名称UploadDeviceInfo(StringrepositoryNo,StringdataInfo)调用方法http:服务器IP:端口archiveRepositoryService功能描述通过该接口消防设备上报设备状态输入项参数名称类型长度允许为空说明备注reposItoryNoString6否库房编码参见DT65-2017附录C-C.4datalnfoString否上报消防报警状态(fireAlarm:0)注：O-不报警：I-报警返回值参数名称类型长度允许为空说明备注ResultString否返回上报报警成功/失败(result:true/result:false异常