DB11/T 1287-2015 城市安全运行和应急管理 物联信息接入规范

ICS35.020

L70

DB11

北京市地方标准

DB11/T1287—2015

城市安全运行和应急管理

物联信息接入规范

Safetyoperationandemergencymanagementofcity-

InformationaccessspecificationofInternetofThings

2015-12-30发布2016-04-01实施

北京市质量技术监督局发布

DB11/T1287—2015

目次

前言III

引言IV

1范围1

2规范性引用文件1

3术语和定义1

4缩略语2

5物联信息接入方式2

6物联接入信息属性描述2

6.1中文名称3

6.2定义3

6.3英文名称3

6.4数据类型3

6.5值域3

6.6短名3

6.7最多实例数3

6.8约束3

6.9取值示例3

7数据库接入3

7.1数据库接入信息3

7.2技术要求8

8Web服务接入9

8.1Web服务描述信息9

8.2技术要求13

9Portlet接入16

9.1Portlet描述信息16

9.2技术要求19

10页面链接接入20

10.1页面描述信息20

10.2技术要求22

11系统接入23

11.1系统描述信息23

11.2技术要求26

附录A（资料性附录）数据库接入示例27

I

DB11/T1287—2015

附录B（资料性附录）Web服务消息交互模式29

附录C（资料性附录）Portlet接入示例30

附录D（资料性附录）页面链接接入示例31

附录E（资料性附录）系统接入示例32

附录F（资料性附录）代码表33

附录G（资料性附录）认证授权接口34

附录H（资料性附录）Web服务接入示例42

参考文献49

II

DB11/T1287—2015

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由北京市经济和信息化委员会提出。

本标准由北京市经济和信息化委员会归口。

本标准由北京市经济和信息化委员会组织实施。

本标准的起草单位：北京市经济和信息化委员会、北京市信息资源管理中心、北京市信息化

项目评审中心、太极计算机股份有限公司、北京东方通科技股份有限公司。

本标准主要起草人：高顺尉、贾晓丰、郭家义、高嵩、朱蓉华、李佳、崔建新、刘惠刚、黄晓斌、

李军、穆勇、李存国、何可文、徐燕、黄圆圆、高卫峰、武耀辉、辛桂忠。

III

DB11/T1287—2015

引言

为深化北京市物联网应用，带动物联网产业发展，提升政务和公共服务管理水平，本市制定了《北

京市城市安全运行和应急管理物联网应用建设总体方案》（京政办发[2011]14号），提出了“1+1+8”

十大工程，并提出编制编码赋码、信息接入和共享交换等各类基础标准的工作任务。

制定《城市安全运行和应急管理物联信息接入规范》是为了更好地规范全市城市安全运行和应急

管理领域的物联信息资源与市物联网应用支撑平台对接，充分利用全市各部门已建的物联网基础设施和

已有资源，避免重复建设，保障全市城市安全运行和应急管理领域物联网应用系统互联互通和统筹协调

发展。

IV

DB11/T1287—2015

城市安全运行和应急管理物联信息接入规范

1范围

本标准规定了城市安全运行和应急管理领域物联信息的数据交换、数据库、web服务（WebService，

即网络服务）、Portlet（容器）、页面链接、系统等接入方式。

本标准适用于城市安全运行和应急管理领域各部门物联信息资源与市物联网应用支撑平台的对接

与管理。其他物联网领域应用可参照执行。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB18030信息技术中文编码字符集

GB/T31287全国组织机构代码应用标识规范

GB32100法人和其他组织统一社会信用代码编码规则

DB11/T553.5政务信息资源共享交换平台技术规范第5部分：接口规范

3术语和定义

以下术语和定义适用于本文件。

3.1

服务质量qualityofservice

服务运行性能和可靠性等方面的动态属性特性的集合。

3.2

服务安全策略servicesecuritystrategy

定义服务调用者和提供者之间安全通信的约束。

3.3

前置机front-endprocessor

连接各部门物联网应用业务系统与物联网应用支撑平台，实现数据交换的中间设备。

3.4

政务物联数据专网governmentaffairs'datanetworkofInternetofThings

北京市实现全市政务领域物联信息接入的网络。

3.5

1

DB11/T1287—2015

物联网应用支撑平台theplatformofInternetofThingsapplication

北京市应急指挥平台获取各单位物联网信息，实现各类物联网信息的规范接入、有效整合、资源共

享的平台。

4缩略语

以下缩略语适用于本文件。

API应用程序编程接口（ApplicationProgrammingInterface）

CSS层叠样式表（CascadingStyleSheet）

HTML超文本标记语言（HypertextMarkupLanguage）

HTTP超文本传输协议（HypertextTransferProtocol）

HTTPS安全超文本传输协议（HypertextTransferProtocolSecure）

IOT物联网（InternetOfThings）

JAXRJava平台上的应用程序定义的API（JavaTMAPIforXMLRegistries）

OASIS结构化信息标准促进组织（OrganizationfortheAdvancementofStructuredInformation

Standards）

SOAP简单对象访问协议（SimpleObjectAccessProtocol）

SSL安全套接层（SecureSocketsLayer）

UUID全局唯一标识符（UniversallyUniqueIdentifier）

URI统一资源标识符（UniformResourceIdentifier）

WSDLWeb服务描述语言（WebServicesDescriptionLanguage）

XHTML可扩展超文本置标语言（eXtensibleHyperTextMarkupLanguage）

XML可扩展置标语言（eXtensibleMarkupLanguage）

5物联信息接入方式

按照资源载体不同，物联信息接入方式分为数据交换、数据库、web服务、Portlet、页面链接、系

统等6种方式：

——数据交换方式：物联网应用系统通过前置机与物联网应用支撑平台互联互通，实现物联信息接

入物联网应用支撑平台。数据交换方式符合DB11/T553.5的规定。

——数据库接入方式：物联网应用通过向物联网应用支撑平台开放数据库访问地址、用户名、密码

等信息，实现物联信息接入物联网应用支撑平台（数据库接入示例参见附录A）；

——web服务接入方式：将物联网应用系统的物联信息访问封装成web服务，通过该服务为物联网

应用支撑平台提供共享服务资源(Web服务接入通信模式参见附录B)；

——Portlet接入方式：将物联网应用系统的物联信息访问封装成Portlet，整合接入物联网应用

支撑平台门户，实现物联网应用系统与物联网应用支撑平台的数据互通（Portlet接入示例参

见附录C）；

——页面链接接入方式：将物联网应用系统的物联信息访问页面地址链接到物联网应用支撑平台，

实现信息接入（页面链接接入示例参见附录D）；

——系统接入方式：物联网应用系统根据统一的接口规范，实现与物联网应用支撑平台的物联信息

互联互通（系统接入示例参见附录E）。

6物联接入信息属性描述

2

DB11/T1287—2015

6.1中文名称

赋予物联接入信息属性的标记。

6.2定义

物联接入信息属性的描述，可使物联接入信息属性与其他数据元属性清晰地区别开来。

6.3英文名称

物联接入信息的属性的英文名称，一般用英文全称。所有组成词汇为无空格连写，每个词汇的首字

母采用大写。

6.4数据类型

为表达属性值而规定的特定值集合的描述符。属性值的数据类型示例有：整型、实型、布尔型、字

符串、日期等。

6.5值域

说明物联接入信息属性可以取值的范围。

6.6短名

描述物联接入信息属性的英文缩写名称。短名的命名规则为：在本标准范围内唯一；对存在国际或

行业领域惯用英文缩写的词汇，可直接采用；短名所有组成词汇的缩写为无空格连写，最后一个词汇的

首字母大写，其他小写。

6.7最多实例数

在一个数据元规范中，规定数据元属性可以拥有的最多实例数目的描述符。只出现一次用“1”表示，

多次重复出现用“N”表示，不为1的固定出现次数可用相应的数字表示，如“2”、“3”、“4”等。

6.8约束

显示物联接入信息属性是始终还是有时出现（即含有的值）的描述符。该描述符可以有下列含义：

必选项：该物联接入信息的属性必须出现；

可选项：该物联接入信息的属性可以出现，也可以不出现。已经定义的可选描述XX信息，

可指导部门制定人员充分说明其物联接入信息资源。

6.9取值示例

对于每一个物联接入信息属性，列举一个著录时的填写内容示例。

7数据库接入

7.1数据库接入信息

7.1.1数据库中文名称

定义：数据库的中文名称

英文名称：DatabaseChineseName

3

DB11/T1287—2015

数据类型：字符串

值域：自由文本

短名：dcName

最多实例数：最大出现次数为1

约束：必选项

取值示例：烟花爆竹销售信息数据库

7.1.2数据库英文名称

定义：数据库的英文名称，数据库唯一标识

英文名称：DatabaseEnglishName

数据类型：字符串

值域：自由文本

短名：deName

最多实例数：最大出现次数为1

约束：必选项

取值示例：SALESofFireworksandfirecrackers

7.1.3数据库摘要

定义：数据库功能与作用的简要说明

英文名称：DatabaseAbstract

数据类型：字符串

值域：自由文本

短名：dAbstract

最多实例数：最大出现次数为1

约束：必选项

取值示例：用于记录烟花爆竹定点销售处的实时烟花爆竹库存

7.1.4数据库负责方

数据库负责单位

定义：数据库直接负责单位的名称

英文名称：DatabaseResponsibleDepartment

数据类型：字符串

值域：自由文本

短名：drDepartment

最多实例数：最大出现次数为1

约束：必选项

取值示例：市安全生产监督管理局

数据库负责单位组织机构代码

定义：数据库直接负责单位注册时的组织机构代码

英文名称：DatabaseResponsibleDepartmentCode

数据类型：字符串

4

DB11/T1287—2015

值域：自由文本，应符合GB/T31287

短名：drdCode

最多实例数：最大出现次数为1

约束：必选项

数据库负责单位统一社会信用代码

定义：数据库直接负责单位的统一社会信用代码

英文名称：DatabaseResponsibleDepartmentUnifiedSocialCreditIdentifier

数据类型：字符串

值域：自由文本，应符合GB32100

短名：drduscIdentifier

最多实例数：最大出现次数为1

约束：必选项

数据库负责单位联系人

定义：数据库直接负责单位的联系人姓名

英文名称：DatabaseResponsibleDepartmentLinkman

数据类型：字符串

值域：自由文本

短名：drdLinkman

最多实例数：最大出现次数为1

约束：必选项

数据库负责单位联系电话

定义：与数据库直接负责单位联系人联系时的固定座机号码

英文名称：DatabaseResponsibleDepartmentPhone

数据类型：字符串

值域：自由文本

短名：drdPhone

最多实例数：最大出现次数为1

约束：必选项

数据库负责单位地址

定义：与数据库直接负责单位联系人联系的物理地址

英文名称：DatabaseResponsibleDepartmentAddress

数据类型：字符串

值域：自由文本

短名：drdAddress

最多实例数：最大出现次数为1

约束：可选项

取值示例：中国北京市海淀区花园路XX号

7.1.5数据库类型

5

DB11/T1287—2015

数据库产品的名称

定义：数据库产品的名称

英文名称：DatabaseProductName

数据类型：字符串

值域：自由文本

短名：dpName

最多实例数：最大出现次数为1

约束：必选项

数据库产品的版本号

定义：数据库产品的版本号

英文名称：DatabaseVersion

数据类型：字符串

值域：自由文本

短名：dVersion

最多实例数：最大出现次数为1

约束：必选项

取值示例：第5版本

7.1.6数据库用户名

定义：可访问数据库的用户名称

英文名称：DatabaseUser

数据类型：字符串

值域：自由文本

短名：dUser

最多实例数：最大出现次数为N

约束：必选项

取值示例：shareUser

7.1.7数据库密码

定义：数据库用户访问数据库时需要使用的登录密码

英文名称：Password

数据类型：字符串

值域：自由文本

短名：password

最多实例数：最大出现次数为N

约束：必选项

7.1.8数据库连接方式

定义：访问数据库的连接方式

英文名称：TypeOfDatabaseConnection

数据类型：字符串

6

DB11/T1287—2015

值域：自由文本，取值见附录F.1

短名：todConnection

最多实例数：最大出现次数为1

约束：必选项

取值示例：02JDBC

7.1.9数据库IP地址

定义：获取数据库的网络地址

英文名称：InternetProtocolAddress

数据类型：字符串

值域：自由文本

短名：ipAddress

最多实例数：最大出现次数为1

约束：必选项

7.1.10数据库端口号

定义：数据库通讯的进出口

英文名称：DatabasePort

数据类型：字符串

值域：自由文本

短名：dPort

最多实例数：最大出现次数为1

约束：必选项

7.1.11数据表信息

数据表名

定义：数据表的名称

英文名称：TableName

数据类型：字符串

值域：自由文本

短名：tName

最多实例数：最大出现次数为N

约束：可选项

数据表说明

定义：描述该数据表的字段名、字段描述、字段类型、字段长度、是否主键等字段信息

英文名称：InformationOfField

数据类型：字符串

值域：自由文本

短名：ioField

最多实例数：最大出现次数为N

约束：可选项

7

DB11/T1287—2015

取值示例：字段名name，字段描述人员的姓名，字段类型字符型，字段长度20，是否主键是

7.1.12使用情况信息

最大连接数

定义：数据库的最大连接数

英文名称：MaximumNumberOfConnections

数据类型：整型

值域：自由文本

短名：maxnoCoonnections

最多实例数：最大出现次数为1；单位是个

约束：可选项

最小连接数

定义：数据库的最小连接数

英文名称：MinimumNumberOfConnections

数据类型：整型

值域：自由文本

短名：minnoConnections

最多实例数：最大出现次数为1；单位是个

约束：可选项

超时时间

定义：数据库的超时时间

英文名称：TimeOut

数据类型：整型

值域：自由文本

短名：timeout

最多实例数：最大出现次数为1；单位是秒

约束：可选项

空闲时间最大值

定义：数据库的空闲时间最大值

英文名称：MaximumIdleTime

数据类型：整型

值域：自由文本

短名：maxiTime

最多实例数：最大出现次数为1；单位是秒

约束：可选项

7.2技术要求

7.2.1对接要求

应支持JDBC或ODBC连接方式。

8

DB11/T1287—2015

7.2.2使用要求

响应时间

数据库的响应时间应在秒级。最大响应时间应不超过30秒。

用户数

数据库的最大连接数设置不应低于150，最小连接数不宜低于20。

稳定性

数据库宜支持7*24小时不间断的运行处理。

故障恢复时间

数据库的故障恢复时间不宜超过8小时。

7.2.3安全要求

数据库应开放安全访问策略，包括防火墙的访问端口设置，可访问的IP地址等。应做好数据库本身

的安全维护工作，设置用户权限、访问控制、传输安全等安全策略。

8Web服务接入

8.1Web服务描述信息

8.1.1Web服务中文名称

定义：服务对外展示时显示的名称，便于识别管理

英文名称：ServiceChineseName

数据类型：字符串

值域：自由文本，应按照服务的特性进行中文命名，名称中只包括汉字，不应出现其它字符，

长度为2-256字节

短名：scName

最多实例数：最大出现次数为1

约束：必选项

取值示例：城市应急服务

8.1.2Web服务英文名称

定义：服务调用时需要使用的英文名称

英文名称：ServiceEnglishName

数据类型：字符串

值域：自由文本，应按照服务的特性进行英文命名，名称中只包括英文字母，不应出现其它字

符，长度为1-256字节；当名称中有多个英文单词时，每个单词首字母大写

短名：seName

最多实例数：最大出现次数为1

约束：必选项

取值示例：CityEmergencyService

9

DB11/T1287—2015

8.1.3Web服务地址

定义：服务部署的真实地址

英文名称：ServiceAddress

数据类型：字符串

值域：自由文本,遵循HTTP协议命名规范

短名：sAddress

最多实例数：最大出现次数为1

约束：必选项

取值示例：http://xxx.xxx.xxx.xxx/service?wsdl

8.1.4Web服务类别

定义：对服务进行分类时，该服务所属的类别

英文名称：ServiceCategory

数据类型：字符串

值域：自由文本,，取值参见附录F.3

短名：sCategory

最多实例数：最大出现次数为1

约束：必选项

取值示例：01索引模式

8.1.5Web服务摘要

定义：服务的简要描述信息

英文名称：ServiceAbstract

数据类型：字符串

值域：自由文本

短名：sAbstract

最多实例数：最大出现次数为1

约束：必选项

取值示例：城市应急管理服务

8.1.6Web服务功能说明

定义：描述服务的主要功能及作用

英文名称：ServiceFunctionDescription

数据类型：字符串

值域：自由文本

短名：sfDescription

最多实例数：最大出现次数为1

约束：必选项

取值示例：该服务的主要功能有1、xxx；2、yyy；3、…

8.1.7方法列表

定义：服务对外提供的可以访问的操作列表

10

DB11/T1287—2015

英文名称：MethodList

数据类型：字符串

值域：自由文本

短名：mList

最多实例数：多个方法可用符号“;”分隔；最大出现次数为1

约束：必选项

取值示例：getEmergencyInfo(intid);getEmergencyDealInfo(intid);

8.1.8调用示例说明

定义：调用服务时的示例，以方便使用

英文名称：InvokeExampleDescription

数据类型：字符串

值域：自由文本

短名：ieDescription

最多实例数：最大出现次数为1

约束：必选项

取值示例：参见附录H.4

8.1.9Web服务有效期

定义：服务的有效服务期限天数

英文名称：ServiceEffectiveDays

数据类型：整型

值域：自由文本

短名：seDays

最多实例数：最大出现次数为1；默认始终有效，有效期单位：天

约束：可选项

取值示例：180天

8.1.10Web服务负责方

Web服务负责单位

定义：Web服务直接负责单位的名称

英文名称：WebServiceResponsibleDepartment

数据类型：字符串

值域：自由文本

短名：wsrDepartment

最多实例数：最大出现次数为1

约束：必选项

Web服务负责单位组织机构代码

定义：Web服务直接负责单位注册时的组织机构代码

英文名称：WebServiceResponsibleDepartmentCode

数据类型：字符串

11

DB11/T1287—2015

值域：自由文本，应符合GB/T31287

短名：wsrdCode

最多实例数：最大出现次数为1

约束：必选项

Web服务负责单位统一社会信用代码

定义：Web服务直接负责单位的统一社会信用代码

英文名称：WebServiceResponsibleDepartmentUnifiedSocialCreditIdentifier

数据类型：字符串

值域：自由文本，应符合GB32100

短名：wsrduscIdentifier

最多实例数：最大出现次数为1

约束：必选项

Web服务负责单位联系人

定义：Web服务直接负责单位的联系人姓名

英文名称：WebServiceResponsibleDepartmentLinkman

数据类型：字符串

值域：自由文本

短名：wsrdLinkman

最多实例数：最大出现次数为1

约束：必选项

Web服务负责单位联系电话

定义：与Web服务直接负责单位联系人联系的固定座机号码

英文名称：WebServiceResponsibleDepartmenPhone

数据类型：字符串

值域：自由文本

短名：wsrdPhone

最多实例数：最大出现次数为1

约束：必选项

Web服务负责单位地址

定义：与Web服务直接负责单位联系人联系的物理地址

英文名称：WebServiceResponsibleDepartmentAddress

数据类型：字符串

值域：自由文本

短名：wsrdAddress

最多实例数：最大出现次数为1

约束：可选项

取值示例：中国北京市海淀区花园路XX号

8.1.11版本

12

DB11/T1287—2015

定义：记录服务注册发布变更的标识

英文名称：Version

数据类型：字符串

值域：自由文本，版本号以1.0为起点，每一次服务注册发布的变更，对应修改版本号

短名：Version

最多实例数：最大出现次数为1

约束：必选项

取值示例：V1.0

8.1.12版本说明

定义：记录版本变更原因和变更内容

英文名称：VersionNote

数据类型：字符串

值域：自由文本

短名：vNote

最多实例数：最大出现次数为1

约束：必选项

取值示例：本次变更原因为xxxx；变更内容有xxxxx

8.2技术要求

8.2.1服务协议要求

服务发现协议

a)服务发现协议应采用通用描述、发现与集成服务标准UDDI2.0/3.0、JAXR1.0；

b)服务提供者应采用市物联网应用支撑平台提供的管理界面或接口进行注册；

c)服务调用者应采用市物联网应用支撑平台提供的管理界面或接口进行发现与服务集成。

服务传输协议

服务传输协议应采用HTTP/HTTPS1.0/1.1标准。

服务消息协议

a)服务消息封装协议应采用SOAP1.1/1.2标准；

b)如果消息交换内容超过1024K字节，可采用附件H形式。

8.2.2服务描述要求

总体要求

a)服务描述内容应包含服务调用者使用的具体访问接口内容，主要包括数据类型定义、操作、交

互消息格式和内容、端口类型及绑定等内容，内容格式应按照WSDL1.1的规定进行描述，可参

见附录H.2服务描述模板；

b)一个服务描述中，应包括：一个类型定义，0到多个消息定义，0到多个端口类型，0到多个

绑定，0到多个服务；

c)一个类型定义可有0到多个数据类型定义；

13

DB11/T1287—2015

d)一个消息可以分为0到多个部分，消息中的每个部分使用类型定义的数据类型来定义整个消息

结构；

e)一个端口类型可包含多个操作，每个操作都有0到多个输入、输出和异常信息；

f)一个绑定可包含0到多个端口类型；

g)一个服务可包含多个端口，一个端口包含一个绑定。

类型定义要求

数据类型（Types）定义应符合以下要求：

a)数据类型定义应按照XMLSchema1.0规范的规定使用；

b)可使用输入或内嵌方式，引用其他数据类型定义；

c)可定义传输的附件数据类型，如文件、图片、视频内容等，以支持通过Web服务传输附件内容。

在数据类型定义的语法和数据类型，应避免以下使用情况：

a)使用any元素，用于扩展；

b)使用complexType元素的block属性阻止派生（扩展、限制、替换）；

c)使用group元素的maxOccurs属性，使值大于1；

d)递归引用，造成处理上的死循环。

消息定义要求

a)消息（Message）应采用类型定义整个消息的数据结构；

b)消息类型定义应按照XMLSchema1.0规范的规定使用；

c)消息和其每个部分的名称定义应保证唯一性；

d)不允许使用异步回调的方式。

端口类型要求

a)端口类型（PortType）应定义Web服务的操作，及操作中对应的输入输出参数和消息交互模式；

b)消息交互模式：只提供两种，即单向模式和同步请求/应答模式；

c)输入输出参数：参数应封装良好，输入输出参数的个数允许多个，应避免输入消息为空；

d)端口类型名称，应在接口描述文档中保证唯一性；

e)操作名称，在端口类型定义中，应保证唯一性；

f)一个端口类型，可与多个绑定进行使用。

绑定要求

a)绑定(Binding)应指定端口类型使用的协议、数据格式、消息交互模式及其它属性；

b)绑定形式应使用DocumentLiteral/Wrapped文档风格，应避免使用RPCEncoding及Document

Encoded形式；

c)绑定应使用SOAP版本1.1/1.2标准；

d)通讯应绑定HTTP/HTTPS1.0/1.1协议。

端口要求

a)每个端点（Port）定义内容应包括一个端口类型的绑定和一个网络地址；

b)端口指定的地址应准确无误，如发生变更，应及时更新接口描述文档；

c)网络地址协议应符合HTTP/HTTPS1.0/1.1标准规定。

14

DB11/T1287—2015

服务要求

a)服务(Service)应由一组相关端口的集合组成；

b)一个服务中所有端口都不相互通信，即一个端口的输出不会是另一个端口的输入；

c)一个服务中多个端口可属于同一个端口类型。

其它要求

a)消息字符集和编码应保持一致，应采用GBK或UTF-8；

b)在使用MIME绑定时，应绑定text/xml类型。

8.2.3服务质量特性要求

响应时间

服务响应时间宜不超过10秒。

并发性

服务宜支持50个以上用户并发访问。

稳定性

服务宜支持7*24小时不间断的运行处理。

故障恢复时间

服务的故障恢复时间不宜超过8小时。

8.2.4服务安全策略

概述

服务提供的内容和访问资源涉及保密和敏感信息时，服务提供/调用者