DB21/T 3097-2018 无线电管理一体化平台 软件开发规范

ICS35.100.70

M10DB21

辽宁省地方标准

DB21/T3097—2018

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

Softwaredevelopmentspecificationforradiomanagementintegratedplatform

2018-12-25发布2019-01-25实施

辽宁省市场监督管理局发布

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>

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