设备维护平台接口技术规范说明书

《设备维护平台接口技术规范说明书》由会员上传分享，免费在线阅读，更多相关内容在学术论文-天天文库。

1、设备维护平台接口技术规范说明书（版本号V1.0）杭州天梦科技有限公司二〇一〇年五月更改履历版本号修改编号更改时间更改的图表和章节更改简要描述更改人批准人V1.02013-05-13创建，形成初稿叶庆国V1.12014-06-09维修业务操作接口调整，仅开放维保单位相关操作接口叶庆国注：更改人除形成初稿，以后每次修改在未批准确认前均需采用修订的方式进行修改。设备维护平台接口技术规范说明书目录1概述21.1编写目的21.2预期读者21.3参考文献22接口平台设计22.1技术架构22.1.1接口架构图22.1.2业务流图32.2部署方式42.3接口标准42.3.1技

2、术标准42.3.2数据规约52.3.3示例63WEBSERVICE服务73.1设备维护平台提供的服务73.1.1接口服务清单73.1.2接口服务设计8I设备维护平台接口技术规范说明书1概述1.1编写目的为设备维护平台的信息同步和共享，制定了统一的接口规范，用来指导各系统的接口设计、开发、联调及迁移工作。范围：本文档主要是对设备维护平台与外围业务系统的数据交互需求进行说明。1.2调试要求强烈要求第三方调用者，先做测试库的接口调试，确保接口及参数调用正确，否则将对正式库可能出现的系统故障承担主要责任。1.3预期读者项目组人员、各交互系统涉及到的开发厂家。1.4参考

3、文献《智能交通设备维护管理系统设备接入标准》杭州天梦科技有限公司2接口平台设计2.1技术架构2.1.1接口架构图（暂缺）17设备维护平台接口技术规范说明书1.1.1业务流图说明：用户通过接口。17设备维护平台接口技术规范说明书1.1部署方式接口服务层包括Webservice服务、展现集成服务。1、Webservice服务各系统提供的接口服务统一部署在设备维护平台接口服务层上，各系统客户端和接口服务层用SOAP协议通过HTTP来交互，客户端根据WSDL描述文档生成SOAP请求消息发送到服务端，服务端解析收到的SOAP请求，调用Webservice，然后再生成相应

4、的SOAP应答送回到客户端。2、展现集成服务展现集成服务主要是应用界面集成服务，由服务提供方提供详细的URL及相关参数说明，调用方传入参数，调用服务方提供的页面进行展现。3、平台Service组件服务平台Service组件服务统一部署在设备维护平台接口服务层上，通过平台接口服务层进行查询操作。1.2接口标准1.2.1技术标准1.2.1.1简述客户端和服务器用SOAP协议通过HTTP来交互，客户端根据WSDL描述文档生成SOAP请求消息发送到服务端，服务端解析收到的SOAP请求，调用Webservice，然后再生成相应的SOAP应答送回到客户端。1.2.1.2认

5、证机制设备维护平台提供的所有WebService服务均需要认证授权才能被调用，Webservice服务接收到请求后从传入参数中获取用户名和密码，进行认证，认证通过后再调用具体服务。17设备维护平台接口技术规范说明书1.1.1数据规约1.1.1.1简述客户端和服务端采用XML格式的字符串来交互业务数据，客户端将业务数据组织成XML格式的字符串作为最后一个入参调用服务端接口，服务端解析XML格式的字符串得到业务数据处理业务并把结果组织成XML格式的字符串返回给客户端。接口调用的结果，自动序列化后，以XML格式的字符串返回，其中包含了接口调用中出现的错误描述。1.1

6、.1.2格式约定若是业务接口调用，将以DataItem_Rsp类实例序列化，表示单一数据项，内容包括操作结果、错误描述，无数据集。若是查询接口调用，将以EntSetSerialize_Rsp类实例序列化，表示查询结果，其中包括错误描述，有数据集。XML字符串中，若是节点取值为null，则是，在节点中存在属性xsi:nil="true"；若是节点取值为空字符串，则是。XML编码格式为“UTF-8”；字段为日期的遵循以下约定：1.年月日格式统一为“YYYY-MM-DD

7、”，如“2006-06-22”。2.年月格式为“YYYYMM”，如“200606”。3.包含时间的日期格式统一为“YYYY-MM-DDTHH:MI:SS”，如“2006-06-22T14:00:00”。4.如果未约定日期格式，则DATE类型的默认为“YYYY-MM-DD”，如“2006-06-22”。1.1.1.3格式DTD暂缺17设备维护平台接口技术规范说明书1.1.1示例1.1.1.1示例：查询接口，包含数据集

8、ARYxmlns:xsi="http: