DB11-T1391-3-2017网格化社会服务管理信息系统技术规范第3部分：通用数据接口

1、170-2017北 京 市DB 11地 方 标 准DBT2017 raldatainterface北京市质量技术监督局 发 布IDBT.32017 HYPERLINK l _bookmark2 HYPERLINK l _bookmark3 HYPERLINK l _bookmark4 HYPERLINK l _bookmark5 HYPERLINK l _bookmark6 HYPERLINK l _bookmark1 HYPERLINK l _bookmark1 HYPERLINK l _bookmark1 HYPERLINK l _bookmark7 HYPERLINK l _bookma

2、rk8 HYPERLINK l _bookmark9 HYPERLINK l _bookmark10 HYPERLINK l _bookmark11 HYPERLINK l _bookmark12 HYPERLINK l _bookmark13 HYPERLINK l _bookmark14 HYPERLINK l _bookmark15 DBT1.32017前 言GBT口。京市社会建设工作办公室组织实施。 ) 。 1DBT1.32017网格化社会服务管理信息系统技术规范 第 3 部分：通用数据接口 缩略语SOAP议 (Simple Object Access Protocol)WSDL We

3、b Service描述语言(Web Services Description Language)XML标记语言(Extensible Markup Language)XSD XML结构定义 (XML Schema Definition )体框架实现机制如图1。SOAP协议的Web Service技术来实现不同系统之间的信息传输；进行 各子系统应通过发布Web Service服务，提供数据交换接口，从而实现数据、业务的交互。 用流程2Service服务DBT1.32017Service服务Web返回结果服务请求简单请求应答模式，即一次请求对应一次应答或者没有应答；多次应答模式，即一次请求对应多次

4、应答；送， 网格化社会服务管理信息系 把完整数据提供给服务请求方；信息系统发布的主题， 当与订购 的事件发生时，网格化社会服务管理信息系统通知服务请求方。术要求求包括： 接口调用信息结构4.1 请求信息结构XMLXSD请求信息分成两个部分：第一部分是控制信息，包括协议版本、服务请求系统ID 、服务请求ID、 方案、请求者身份等；第二部分是请求信息的具体内容。请求信息的扩展方法可参考附录A。3DBT.32017XML格式见图4，请求信息XML标签含义见表1。RequestVersionSystemIDSystemIDSessionIDSessionIDEncryptionSchemeAuthen

5、ticationUserNamePasswordPasswordAuthenticationRequestDataRequestDataCenterXML4DBT1.320171taCenterXML2est签3ersion4D5nID6yptionScheme 7uthentication标签8erName9sword后续控制信息后续控制信息estData签，可以根据需要进一步扩展4.2 返回信息结构XMLXSD请求信息包括两个部分：第一部分是控制信息，包括服务请求ID和加密方案；第二部分是返回信回数据。返回数据的扩展方法可参考附录A。XML图6，返回信息XML标签含义见表2。5DBT.32

6、017esponseSessionIDSessionIDEncryptionSchemeReturnMessageCodeMessage/ReturnMessageResponseDataResponseDataCenterXML1taCenterXML2nse3nID4yptionScheme 5rnMessage67Message8nseData可以根据需要进一步扩展 异常处理.1 重试机制.2 事务机制数据操作时，应提供事务处理机制。求用户认证6DBT1.32017 b) 宜为不同的服务调用者分配不同权限；c时，宜针对每次操 式。信息加密a密处理；c用对称加密和非对称加密相结合的方法。3

7、 备份7DBT1.32017(资料性附录)口使用示例 接口的设计和使用方法。A.1 功能息。A.2 接口扩展设计 义、请求信息的RequestData标签扩展定义和返回信息的ResponseData标签扩展定义。本示例交互模式选择简单请求应答模式， RequestData标签和ResponseData标签的扩展定义见表A.1。1tType etStreeInfotCommunityInfo2D3ame4Address5用的服务不存在有查到符合条件的信息A.3 请求信息XML见图A.1。8DBT1.32017xml version=1.0 encoding=UTF-8?RequestSystem

8、IDSystemID SessionID3465324 EncryptionScheme 0 AuthenticationUserNameuser/UserName Passwordpsd/Password AuthenticationRequestDataReqestTypegetStreetInfoReqestType 123456789 /RequestDataRequestDataCenterXMLA.4 返回结果A4.1 请求成功回结果的XML格式见图A.2。esponsessionID EncryptionScheme ReturnMessageCode0 Message/ReturnMessageResponseDataStreetID StreetNameStreetName!- 街道名称 -StreetAddressXXStreetAddress /ResponseDataResponse/DataCenterXMLA4.2