DB21-T 3097-2018辽宁省无线电管理一体化平台系统集成规范

ICS35.100.70

M10

备案号：62054-2019DB21

辽宁省地方标准

DB21/T3097—2018

无线电管理一体化平台软件开发规范

Softwaredevelopmentspecificationforradiomanagementintegratedplatform

I

DB21/T3097—2018

目次

前言..................................................................................IV

1范围.................................................................................1

2规范性引用文件.......................................................................1

3术语、定义和缩略语...................................................................1

3.1术语和定义.......................................................................1

3.2缩略语...........................................................................5

4服务治理系统.........................................................................5

4.1功能介绍.........................................................................5

4.2服务接口约束.....................................................................5

4.3服务治理系统接口................................................................15

5流程管理系统........................................................................15

5.1功能介绍........................................................................15

5.2跨流程引擎服务接口定义及系统码表................................................16

6统一门户............................................................................16

6.1功能介绍........................................................................16

6.2系统集成........................................................................16

7统一身份............................................................................18

7.1功能介绍........................................................................18

7.2服务接口定义及系统码表..........................................................18

8统一搜索............................................................................18

8.1功能介绍........................................................................18

8.2服务接口定义及系统码表..........................................................19

附录A（规范性附录）服务治理系统接口.................................................20

A.1服务治理系统服务列表............................................................20

A.2业务服务信息维护服务............................................................20

A.2.1服务说明....................................................................20

A.2.2服务请求报文................................................................20

A.2.3服务响应报文................................................................28

A.2.4异常处理....................................................................30

A.3代理服务使用申请服务............................................................30

A.3.1服务说明....................................................................30

I

DB21/T3097—2018

A.3.2服务请求报文................................................................30

A.3.3服务响应报文................................................................33

A.3.4异常处理....................................................................34

A.4系统码表........................................................................34

A.4.1码表一：业务服务响应码......................................................34

A.4.2码表二：服务状态............................................................35

A.4.3码表三：报文格式............................................................35

附录B（规范性附录）跨流程引擎服务接口定义及系统码表..................................36

B.1跨流程引擎服务接口定义..........................................................36

B.1.1跨流程引擎服务列表..........................................................36

B.1.2流程模板数据汇总服务........................................................36

B.1.3流程实例数据汇总服务........................................................44

B.1.4待办列表数据汇总服务........................................................50

B.2系统码表........................................................................57

B.2.1码表一：流程类型............................................................57

B.2.2码表二：流程启用状态........................................................57

B.2.3码表三：紧急状态............................................................58

B.2.4码表四：业务服务响应码......................................................58

B.2.5码表五：节点类型............................................................58

B.2.6码表六：待办状态............................................................59

附录C（规范性附录）统一身份服务接口定义及系统码表....................................60

C.1统一身份服务接口定义............................................................60

C.1.1统一身份服务列表............................................................60

C.1.2查询部门更新时间服务........................................................60

C.1.3查询部门信息服务............................................................64

C.1.4查询人员更新时间服务........................................................71

C.1.5查询人员信息服务............................................................75

C.1.6查询角色信息服务............................................................82

C.1.7查询应用系统和权限服务......................................................87

C.2系统码表........................................................................92

C.2.1码表一：业务服务响应码......................................................93

C.2.2码表二：学历................................................................93

C.2.3码表三：民族................................................................94

C.2.4码表四：人员类型............................................................97

C.2.5码表五：行政职级............................................................97

II

DB21/T3097—2018

C.2.6码表六：技术职称............................................................98

C.2.7码表七：政治面貌............................................................99

C.2.8码表八：工作地点...........................................................100

附录D（规范性附录）统一搜索服务接口定义和数据集成...................................101

D.1服务接口定义...................................................................101

D.1.1统一搜索服务列表...........................................................101

D.1.2索引数据推送服务...........................................................101

D.2统一搜索数据集成...............................................................106

D.2.1数据库集成.................................................................106

D.2.2文件集成...................................................................106

参考文献.............................................................................108

III

DB21/T3097—2018

前言

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

请注意本文件的某些内容可能涉及专利。本标准的发布机构不承担识别这些专利的责任。

本文件由辽宁省工业和信息化委员会提出。

本文件由辽宁省工业和信息化委员会归口。

本文件起草单位：辽宁省重大技术装备战略基地建设工程中心。

本文件主要起草人：孟娇、孙宏志、张印、杨旭。

IV

DB21/T3097—2018

无线电管理一体化平台软件开发规范

1范围

本标准规定了辽宁省无线电管理一体化平台软件中的服务治理系统、流程管理系统、统一门户、统

一身份、统一搜索等的接口约束、接口定义和系统码表等内容。

本标准适用于辽宁省无线电管理一体化平台软件系统的开发。

2规范性引用文件

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

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

GB/T13622无线电管理术语

GB/T34084超短波频段无线电监测网数据库结构技术要求

3术语、定义和缩略语

3.1术语和定义

1

2

3

3.1

3.1.1

面向服务的体系结构service-orientedarchitecture

即SOA是包含运行环境、编程模型、架构风格和相关方法论等在内的一整套新的分布式软件系统构

造方法和环境，涵盖服务的整个生命周期。SOA以服务为基础来实现的IT系统更灵活、更易于重用、更

好（也更快）地应对变化；以服务为基础，通过显式地定义、描述、实现和管理业务层次的粗粒度服务。

3.1.2

服务service

在SOA架构中，服务是最核心的抽象手段，它具有明确的功能，通常封装着业务功能或者数据。一

个服务包括接口（Interface）、契约（Contract）和实现（Implementation）三个部分。服务的接口

和契约采用中立、基于标准的方式进行定义，它独立于实现服务的硬件平台、操作系统和编程语言，这

使得构建在不同系统中的服务可以以一种统一的和通用的方式进行交互。

1

DB21/T3097—2018

3.1.3网络服务webservice

WebService是一个平台独立的、低耦合的、自包含的、基于可编程的web的应用程序，可使用开放

的XML标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。

WebService是一种跨编程语言和跨操作系统平台的远程调用技术。

3.1.4

SOAP协议simpleobjectaccessprotocol

SOAP协议即简单对象访问协议（SimpleObjectAccessProtocol），它是用于交换XML编码信息的

轻量级协议。

SOAP协议定义了SOAP消息的格式，SOAP协议是基于HTTP协议的，SOAP也是基于XML和XSD的，XML是

SOAP的数据编码方式。

SOAP协议=HTTP协议+XML数据格式。

3.1.5

UDDIuniversaldescription,discovery,andintegration

UDDI是一种目录服务，应用系统可以使用它对WebService进行注册和搜索。

3.1.6

WSDLwebdervicedescriptionlanguage

WSDL是一个基于XML的语言，用于描述WebService及其函数、参数和返回值的标准格式。

3.1.7

企业服务总线enterpriseservicebus

企业服务总线，以下简称ESB,是一种在松散耦合的服务和应用之间标准的集成方式，提供简单、快

速、基于标准的多点集成，类似硬件中的总线结构。

3.1.8

服务发布方servicepublisher

将应用系统内的业务方法发布成WebService服务，供远程单位和个人调用的应用系统称为服务发

布方。

3.1.9

服务消费方serviceconsumer

调用服务发布方的WebService服务的应用系统称为服务消费方。

3.1.10

http基本认证机制httpbasicauthentication

2

DB21/T3097—2018

服务消费方通过http协议调用WebService服务时，服务消费方将用户名及密码以字符串形式放在

httprequest的headerAuthorization中发送给服务总线，当用户名密码错误时，服务总线会返回401

Unauthozied异常。

3.1.11

业务服务businessservice

由业务系统提供的服务，必须由服务总线封装后再提供出去，不应该被其它业务系统直接调用。业

务服务元数据由业务系统运维维护。

3.1.12

代理服务proxyservice

由服务总线对业务服务封装后对外提供的服务，可对业务服务进行协议转换、格式转换、路由编排、

运行监控等封装操作，是业务系统之间服务集成的桥梁，可被其它业务系统直接调用。代理服务元数据

由服务总线运维维护。

3.1.13

交易IDtradingID

指定本次服务调用的唯一流水号，用于区分其它调用。该值由服务消费方生成，并传递给服务总线，

当使用服务治理系统进行日志查询时，可通过交易ID查询服务调用日志。注意保证流水号在服务消费方

内的唯一性。

3.1.14

元素element

元素指的是从（且包括）开始标签直到（且包括）结束标签的部分。元素可包含其他元素、文本或

者两者的混合物。元素也可以拥有属性。

元素必须遵循以下命名规则：

3.1.15

父元素parentelement

指当前元素开始标签之前和结束标签之后出现的元素为当前元素的父元素。

3.1.16

循环节点loopnote

同一父元素下重复出现的元素属性描述为循环节点。

3.1.17

单节点singlenode

3

DB21/T3097—2018

同一父元素下只允许出现一次的元素属性描述为单节点。

3.1.18

流程管理processmanagement

流程管理是一种以规范化的构造端到端的业务流程为中心，以持续的提高组织业务绩效为目的的系

统化方法。它是一个操作性的定位描述，指的是流程分析、流程定义与重定义、资源分配、时间安排、

流程质量与效率测评、流程优化等。

3.1.19

流程引擎processengine

流程引擎是指workflow作为应用系统的一部分，并为之提供有决定作用的根据角色、分工和不同条

件的信息传递路由和内容。流程引擎包括，流程的节点管理、路由管理、流程实例管理等重要功能。

3.1.20

流程模板processtemplate

流程模板即流程定义或业务流程，是指为达到特定的价值目标而由不同的人分别共同完成的一系列

活动。活动之间不仅有严格的先后顺序限定，而且活动的内容、方式、责任等也都必须有明确的安排和

界定，以使不同活动在不同岗位角色之间进行转手交接成为可能。活动与活动之间在时间和空间上的转

移可以有较大的跨度。

3.1.21

流程节点processnode

当业务流程需若干个不同程序(流程)或分若干个阶段来完成时，某一程序或某一阶段结束，另一程

序或另一阶段开始时的转接点(类别点或时间点)，称流程节点。

流程节点的自然属性是整个流程的精髓所在，一个流程从开始到结束会经历一系列的节点，每个节

点由不同的人完成，每个人又分属于不同的角色，使用不同的时间，有些流程每个节点可以流向下一个

节点或者返回前面任何一个节点。从一个节点流向下一个节点需要特定的条件。制定流程的过程就是设

置每个节点的自然属性，通过这些属性将每一个节点连接起来，实现所定义流程的流转以及流程控制的

目的。

3.1.22

流程实例processinstance

流程实例是指流程模板在运行时特有的执行例程，一个流程模板被启动后产生一个流程实例，同一

个流程模版可以创建N多个流程实例。

3.1.23

待办任务pendingtask

4

DB21/T3097—2018

启动一个流程模板后，流程实例运行到某一个活动时，对应这个活动会产生一个或多个任务，需要

不同的人、角色或者组织去执行，每一个任务被称为待办任务。

3.2缩略语

下列缩略语适用于本文件：

SOA面向服务的体系结构Service-OrientedArchitecture

SLAService-Levelagreement服务等级协议

XMLeXtensibleMarkupLanguage可扩展标记语言

WSDLWebServicesDescriptionLanguageWeb服务描述语言

SOAPSimpleObjectAccessProtocol简单对象访问协议

4服务治理系统

4.1功能介绍

服务治理系统基于企业总线ESB，利用产品内置功能实现辽宁省无线电管理一体化平台应用系统之

间的服务接口集成，同时通过自开发的功能实现对服务总线的监控预警、服务调用信息和SLA信息的收

集、服务的全生命周期管理。

服务治理系统主要功能包括：

一、服务接入：通过产品提供的适配器支持多种协议接入、接出，适应众多异构平台，能快速将其

服务接入服务总线。

二、访问安全：通过产品提供的认证、授权等安全策略，以及结合服务治理系统提供的服务调用授

权增强功能来确保服务访问的安全性。

三、路由转换：通过产品提供的灵活的路由设置、消息转换实现SOA架构的灵活性和易用性。

四、运行管理：通过产品提供的对于服务总线的管理监控功能，确保SOA基础架构稳定、可靠运行。

4.2服务接口约束

4.2.1传输协议

服务治理系统允许服务发布方SOAP协议WebService服务接入。

4.2.2传输格式

服务治理系统允许WebService服务使用SOAP1.1、SOAP1.2格式报文传输。

SOAP1.1

请求报文格式：

表1服务请求报文

5

DB21/T3097—2018

<soap:Envelopexmlns:soap="/soap/envelope/">

<!--请求报文头-->

<soap:Header>

<MonitorHeader>

<!--交易ID-->

<TransId></TransId>

<!--业务关键字-->

<BizKey></BizKey>

<!--代理服务编号-->

<PSCode></PSCode>

<!--业务服务编号-->

<BSCode></BSCode>

</MonitorHeader>

</soap:Header>

<!--请求报文体-->

<soap:Body>

<!--请求业务参数-->

</soap:Body>

</soap:Envelope>

请求报文头字段说明（请求报文字段详细设置请参见监控信息头设置）：

表2服务请求报文头字段说明

请求报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

1MonitorHeader请求报文头soap:Header无单节点

6

DB21/T3097—2018

请求报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

字符串单节点

2TransId交易IDMonitorHeader

Varchar2(31)必填

字符串单节点

3BizKey业务关键字MonitorHeader

Varchar2(30)不必填

字符串单节点

4PSCode代理服务编号MonitorHeader

Varchar2(22)必填

字符串单节点

5BSCode业务服务编号MonitorHeader

Varchar2(22)必填

响应报文格式：

表3服务响应报文

<soap:Envelopexmlns:soap="/soap/envelope/">

<!--响应报文头-->

<soap:Header>

<ProviderResponse>

<!--业务服务响应码-->

<bizResCd></bizResCd>

<!--业务服务响应信息-->

<bizResText></bizResText>

</ProviderResponse>

</soap:Header>

<!--响应报文体-->

<soap:Body>

7

DB21/T3097—2018

<!--响应业务参数-->

</soap:Body>

</soap:Envelope>

响应报文头字段说明（响应报文字段详细设置说明参见业务响应）：

表4服务响应报文头字段说明

响应报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

响应报文

1ProviderResponsesoap:Header无单节点

头

业务服务字符串单节点

2bizResCdProviderResponse

响应码见码表一必填

业务服务字符串单节点

3bizResTextProviderResponse

响应信息Varchar2(50)必填

SOAP1.2

请求报文格式:

表5服务请求报文

8

DB21/T3097—2018

<soap:Envelopexmlns:soap="/2001/12/soap-envelope">

<!--请求报文头-->

<soap:Header>

<MonitorHeader>

<!--交易ID-->

<TransId></TransId>

<!--业务关键字-->

<BizKey></BizKey>

<!--代理服务编号-->

<PSCode></PSCode>

<!--业务服务编号-->

<BSCode></BSCode>

</MonitorHeader>

</soap:Header>

<!--请求报文体-->

<soap:Body>

<!--请求业务参数-->

</soap:Body>

</soap:Envelope>

请求报文头字段说明（请求报文字段详细设置请参见监控信息头设置）：

表6服务请求报文字段说明

请求报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

9

DB21/T3097—2018

请求报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

请求报文

1MonitorHeadersoap:Header无单节点

头

字符串单节点

2TransId交易IDMonitorHeader

Varchar2(31)必填

业务关键字符串单节点

3BizKeyMonitorHeader

字Varchar2(30)不必填

代理服务字符串单节点

4PSCodeMonitorHeader

编号Varchar2(22)必填

业务服务字符串单节点

5BSCodeMonitorHeader

编号Varchar2(22)必填

响应报文格式:

表7服务响应报文

<soap:Envelopexmlns:soap="/2001/12/soap-envelope">

<!--响应报文头-->

<soap:Header>

<ProviderResponse>

<!--业务服务响应码-->

<bizResCd></bizResCd>

<!--业务服务响应信息-->

<bizResText></bizResText>

</ProviderResponse>

10

DB21/T3097—2018

</soap:Header>

<!--响应报文体-->

<soap:Body>

<!--响应业务参数-->

</soap:Body>

</soap:Envelope>

响应报文头字段说明（响应报文字段详细设置说明参见业务响应）：

表8服务响应报文头字段说明

响应报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

响应报文

1ProviderResponsesoap:Header无单节点

头

业务服务字符串单节点

2bizResCdProviderResponse

响应码见4.4.1码表一必填

业务服务字符串单节点

3bizResTextProviderResponse

响应信息Varchar2(50)必填

4.2.3服务请求设置

业务系统认证

服务消费方调用代理服务时，需通过HTTP基本认证机制传递用户名及密码完成服务总线业务系统认

证，用户名为服务消费方系统编号（系统编号为应用系统在平台注册时生成的唯一标识编号，需记录并

保存），密码为服务治理系统设置的服务消费方系统访问密码。

监控信息头设置

服务消费方调用代理服务时，需设置监控信息头以完成服务总线对服务消费方授权信息校验。

Soap1.1、Soap1.2监控信息头内容如下：

11

DB21/T3097—2018

表9监控信息头

<MonitorHeader>

<!--交易ID-->

<TransId></TransId>

<!--业务关键字-->

<BizKey></BizKey>

<!--代理服务编号-->

<PSCode></PSCode>

<!--业务服务编号-->

<BSCode></BSCode>

</MonitorHeader>

监控信息头属性说明：

表10监控信息头属性说明

请求报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

请求报文

1MonitorHeadersoap:Header无单节点

头

字符串单节点

2TransId交易IDMonitorHeader

Varchar2(31)必填

业务关键字符串单节点

3BizKeyMonitorHeader

字Varchar2(30)不必填

代理服务字符串单节点

4PSCodeMonitorHeader

编号Varchar2(22)必填

5BSCode业务服务MonitorHeader字符串单节点

12

DB21/T3097—2018

请求报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

编号Varchar2(22)必填

交易ID-TransId：

指定本次服务调用的唯一流水号，该值由服务消费方生成，并传递给服务总线。

交易ID编码规范：采用2段编码，总长31位。

<14位系统编码>-<16位流水号>

其中，“14位系统编码”为服务消费方系统编号，由一体化平台统一配发，是服务消费方系统的唯

一认证编号，不可变更。系统编号可联系平台管理员获取。“16位流水号”为应用系统内本次服务调用

的唯一标识，流水号只能为数字，流水号需在服务消费方内保持唯一性。

如：000000-01-0001-0000000000000001

业务关键字-BizKey

指定本次调用具有业务含义的关键信息，如台站编号、单据号、批量数据的批次号等，由服务消费

方设置并发送给服务总线。其长度限制为100个字符。

代理服务编号-PSCode

服务消费方在服务治理系统申请代理服务使用时，需记录下代理服务编号，调用代理服务时需将代

理服务编号作为监控信息头传递给服务总线，完成代理服务授权校验。

业务服务编号-BSCode

服务消费方在服务治理系统申请代理服务使用时，需记录下代理服务对应的业务服务编号，调用代

理服务时需将业务服务编号作为监控信息头传递给服务总线，完成业务服务路由处理。

4.2.4服务响应处理

服务调用过程中，服务发布方和服务消费方针对系统异常及业务响应分别进行处理。

系统异常：指服务消费方、服务总线、服务发布方在服务调用过程中产生的运行时异常，系统异常

需根据出现场景，由服务消费方、服务总线、服务发布方人工干预处理。

业务响应：指在服务发布方业务服务正常处理过程产生的返回信息，服务总线及服务消费方接收响

应信息进行处理。

系统异常

服务调用过程中，产生的系统异常分以下四种情况：

1、服务消费方内部异常

服务消费方内部异常指在调用代理服务时，因服务消费方内部因素产生的异常信息。服务消费方内

部异常由服务消费方进行处理。

服务消费方内部异常代码一般为“soap:Client”。

2、服务授权校验异常

13

DB21/T3097—2018

服务授权校验异常指在调用代理服务时，服务总线对服务消费方的监控信息头校验失败时产生的异

常。服务授权校验异常由服务消费方根据异常提示信息进行处理。

授权校验提示信息：

表11服务授权校验提示信息

代码代码名称

SMP-20001'代理服务编号'为空

SMP-20002'业务服务编号'为空

SMP-20003代理服务不存在,错误的代理服务编号

SMP-20004业务服务不存在,错误的业务服务编号

SMP-20005无权调用该服务

SMP-20006'业务服务调用地址'为空

其他代码其他校验信息

3、服务总线运行异常

服务总线运行异常指在调用代理服务时，由于服务总线内部因素产生的异常。出现服务总线运行异

常时，服务消费方需联系平台管理员处理。

4、服务发布方内部异常

服务发布方内部异常指在调用代理服务时，因服务发布方内部因素产生的异常。服务发布方内部异

常由服务消费方联系平台管理员和服务发布方进行处理。

服务发布方内部异常代码一般为“soap:Server”。

业务响应

服务发布方在业务服务处理完成之后，需要将处理结果通过响应报文头传递给服务消费方，服务消

费方根据不同返回结果，进行相应的处理。

Soap1.1、Soap1.2响应报文头如下：

表12表格4-12服务响应报文头

<ProviderResponse>

<!--业务服务响应码-->

<bizResCd></bizResCd>

<!--业务服务响应信息-->

<bizResText></bizResText>

14

DB21/T3097—2018

</ProviderResponse>

响应报文头字段说明：

表13服务响应报文头属性说明

响应报文头信息（soap:Header）

序号元素代码参数说明父元素代码数据类型备注

响应报文

1ProviderResponsesoap:Header无单节点

头

业务服务字符串单节点

2bizResCdProviderResponse

响应码见4.4.1码表一必填

业务服务字符串单节点

3b