1、 I ICS 35.100.70 M 10 DB21 辽 宁 省 地 方 标 准 DB21/T 3097 2018 无线电管理一体化平台 软件开发规范 Software development specification for radio management integrated platform 2018 - 12 - 25 发布 2019 - 01 - 25 实施 辽宁省 市场监督管理 局 发布 DB21/T 30972018 I 目 次 前言 .IV 1 范围 .1 2 规范性引用文件 .1 3 术语、定义和缩略语 .1 3.1 术语和定义 .1 3.2 缩略语 .5 4 服务治理系
2、统 .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 服务说明
3、.20 A.2.2 服务请求报文 .20 A.2.3 服务响应报文 .28 A.2.4 异常处理 .30 A.3 代理服务使用申请服务 .30 A.3.1 服务说明 .30 DB21/T 3097 2018 II 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 跨流程引擎服务列表 .
4、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
5、查询部门信息服务 .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 DB21/T 30972018 III C.2.6 码表六：技术职称 .98 C.2.7 码表七：政治面貌 .99 C.2.8 码表八：工作地点 . 100 附录 D （规范性附录） 统一搜索服务接
6、口定义和数据集成 . 101 D.1 服务接口定义 . 101 D.1.1 统一搜索服务列表 . 101 D.1.2 索引数据推送服务 . 101 D.2 统一搜索数据集成 . 106 D.2.1 数据库集成 . 106 D.2.2 文件集成 . 106 参考文献 . 108 DB21/T 3097 2018 IV 前 言 本标准按照 GB/T 1.1-2009给出的规则起草。 请注意本文件的某些内容可能涉及专 利。本标准的发布机构不承担识别这些专利的责任。 本文件由辽宁省工业和信息化委员会提出。 本文件由辽宁省工业和信息化委员会归口。 本文件起草单位：辽宁省重大技术装备战略基地建设工程中心。
7、 本文件主要起草人：孟娇、孙宏志、张印、杨旭。 DB21/T 3097 2018 1 无线电管理一体化平台软件开发规范 1 范围 本标准规定了辽宁省无线电管理一体化平台软件中的服务治理系统、流程管理系统、统一门户、统 一身份、统一搜索等的接口约束、接口定义和系统码表等内容。 本标准适用于辽宁省无线电管理一体化平台软件系统的开发。 2 规范性引用文件 下列文件对于本文件的 应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 13622 无线电管理术语 GB/T 34084 超短波频段无线电监测网数
8、据库结构技术要求 3 术语、定义和缩略语 3.1 术语和定义 1 2 3 3.1 3.1.1 面向服务的体系结构 service-oriented architecture 即 SOA是包含运行环境、编程模型、架构风格和相关方法论等在内的一整套新的分布式软件系统构 造方法和环境，涵盖服务的整个生命周期。 SOA以服务为基础来实 现的 IT系统更灵活、更易于重用、更 好（也更快）地应对变化；以服务为基础，通过显式地定义、描述、实现和管理业务层次的粗粒度服务。 3.1.2 服务 service 在 SOA架构中，服务是最核心的抽象手段，它具有明确的功能，通常封装着业务功能或者数据。一 个服务包括接
9、口（ Interface）、契约（ Contract）和实现（ Implementation）三个部分。服务的接口 和契约采用中立、基于标准的方式进行定义，它独立于实现服务的硬件平台、操作系统和编程语言，这 使得构建在不同系统中的服务可以以一种统一的和通用的方式进行交互 。 DB21/T 3097 2018 2 3.1.3 网络服务 web service Web Service是一个 平台 独立的、低耦合的、自包含的、基于可 编程 的 web的应用程序，可使用开放 的 XML标准 来 描述 、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的 应用程序 。 Web Service是
10、一种跨编程语言和跨操作系统平台的远程调用技术。 3.1.4 SOAP 协议 simple object access protocol SOAP协议即 简单对象访问协议 （ Simple Object Access Protocol），它是用于交换 XML编码信息的 轻量 级协议。 SOAP协议定义了 SOAP消息的格式， SOAP协议是基于 HTTP协议的， SOAP也是基于 XML和 XSD的， XML是 SOAP的数据编码方式。 SOAP协议 = HTTP协议 + XML数据格式。 3.1.5 UDDI universal description,discovery, and integ
11、ration UDDI 是一种 目录服务 ，应用系统可以使用它对 Web Service进行注册和搜索。 3.1.6 WSDL web dervice description language WSDL是一个基于 XML的语言，用于描述 Web Service及其函数、参数和返回值的标准格式。 3.1.7 企业服务总线 enterprise service bus 企业服务总线，以下简称 ESB,是一种在松散耦合的服务和应用之间标准的集成方式，提供简单、快 速、基于标准的多点集成，类似硬件中的总线结构。 3.1.8 服务发布方 service publisher 将应用系统 内的业务方法发布成
12、 Web Service服务，供远程单位和个人调用的应用系统称为服务发 布方。 3.1.9 服务消费方 service consumer 调用服务发布方的 Web Service服务的应用系统称为服务消费方。 3.1.10 http 基本认证机制 http basic authentication DB21/T 3097 2018 3 服务消费方通过 http协议调用 Web Service服务时，服务消费方将用户名及密码以字符串形式放在 http request的 header Authorization中发送给服务总线，当用户名密码错误时，服务总线会返回 401 Unauthozied异常
13、。 3.1.11 业务服务 business service 由业务系统提供的服务，必须由服务总线封装后再提供出去，不应该被其它业务系统直接调用。业 务服务元数据由业务系统运维维护。 3.1.12 代理服务 proxy service 由服务总线对业务服务封装后对外提供的服务，可对业务服务进行协议转换、格式转换、路由编排、 运行监控等封装操作，是业务系统之间服务集成的桥梁，可被其它业务系统直接调用。代理服务元数据 由服务总线运维维护。 3.1.13 交易 ID trading ID 指定本次服务调用的唯一流水号，用于区分其 它调用。该值由服务消费方生成，并传递给服务总线， 当使用服务治理系统进
14、行日志查询时，可通过交易 ID查询服务调用日志。注意保证流水号在服务消费方 内的唯一性。 3.1.14 元素 element 元素指的是从（且包括）开始标签直到（且包括）结束标签的部分。元素可包含其他元素、文本或 者两者的混合物。元素也可以拥有属性。 元素必须遵循以下命名规则： 3.1.15 父元素 parent element 指当前元素开始标签之前和结束标签之后出现的元素为当前元素的父元素。 3.1.16 循环节点 loop note 同一父元素下重复出现的元素属性描述为循环节 点。 3.1.17 单节点 single node DB21/T 3097 2018 4 同一父元 素下只允许出
15、现一次的元素属性描述为单节点。 3.1.18 流程管理 process management 流程管理是一种以规范化的构造端到端的业务流程为中心，以持续的提高组织业务绩效为目的的系 统化方法。它是一个操作性的定位描述，指的是流程分析、流程定义与重定义、资源分配、时间安排、 流程质量与效率测评、流程优化等。 3.1.19 流程引擎 process engine 流程引擎是指 workflow作为应用系统的一部分，并为之提供有决定作用的根据角色、分工和不同条 件的信息传递路由和内容。流程引擎包括，流程的节点管理、路由管理、流程实例 管理等重要功能。 3.1.20 流程模板 process temp
16、late 流程模板即流程定义或业务流程，是指为达到特定的价值目标而由不同的人分别共同完成的一系列 活动。活动之间不仅有严格的先后顺序限定，而且活动的内容、方式、责任等也都必须有明确的安排和 界定，以使不同活动在不同岗位角色之间进行转手交接成为可能。活动与活动之间在时间和空间上的转 移可以有较大的跨度。 3.1.21 流程节点 process node 当业务流程需若干个不同程序 (流程 )或分若干个阶段来完成时，某一程序或某一阶段结束，另一程 序或另一阶段开始时的转接点 (类别点 或时间点 )，称流程节点。 流程节点的自然属性是整个流程的精髓所在，一个流程从开始到结束会经历一系列的节点，每个节
17、 点由不同的人完成，每个人又分属于不同的角色，使用不同的时间，有些流程每个节点可以流向下一个 节点或者返回前面任何一个节点。从一个节点流向下一个节点 需要 特定的条件。制定流程的过程就是设 置每个节点的自然属性，通过这些属性将每一个节点连接起来，实现所定义流程的流转以及 流程控制的 目的。 3.1.22 流程实例 process instance 流程实例是指流程模板在运行时特有的执行例程，一个流程模板被启动后产生一个流程实例，同一 个流程模版可以创建 N多个流程实例。 3.1.23 待办任务 pending task DB21/T 3097 2018 5 启动一个流程模板后，流程实例运行到某
18、一个活动时，对应这个活动会产生一个或多个任务，需要 不同的人、角色或者组织去执行，每一个任务被称为待办任务。 3.2 缩略语 下列缩略语适用于本文件： SOA 面向服务的体系结构 Service-Oriented Architecture SLA Service-Level agreement 服务等级协议 XML eXtensible Markup Language 可扩展标记语言 WSDL Web Services Description Language Web 服务描述语言 SOAP Simple Object Access Protocol 简单对象访问协议 4 服务治理系统 4.1
19、 功能介绍 服务治理系统基于企业总线 ESB，利用产品内置功能实现辽宁省无线电管理一体化平台应用系统之 间的服务接口集成，同时通过自开发的功能实现对服务总线的监控预警、服务调用信息 和 SLA信息的收 集、服务的全生命周期管理。 服务治理系统主要功能包括： 一、服务接入：通过产品提供的适配器支持多种协议接入、接出，适应众多异构平台，能快速将其 服务接入服务总线。 二、访问安全：通过产品提供的认证、授权等安全策略，以及结合服务治理系统提供的服务调用授 权增强功能来确保服务访问的安全性。 三、路由转换：通过产品提供的灵活的路由设置、消息转换实现 SOA架构的灵活性和易用性。 四、运行管理：通过产品
20、提供的对于服务总线的管理监控功能，确保 SOA基础架构稳定、可靠运行。 4.2 服务接口约束 4.2.1 传输协议 服务治理系 统允许服务发布方 SOAP协议 Web Service服务接入。 4.2.2 传输格式 服务治理系统允许 Web Service服务使用 SOAP1.1、 SOAP1.2格式报文传输。 4.2.2.1 SOAP1.1 请求报文格式： 表 1 服务请求报文 DB21/T 3097 2018 6 请求报文头字段说明（请求报文字段详细设置请参见 4.2.3.2 监控信息头设置）： 表 2 服务请求报文头字段说明 请求报文头信息（ soap:Header） 序号 元素代码 参
21、数说明 父元素代码 数据类型 备注 1 MonitorHeader 请求报文头 soap:Header 无 单节点 DB21/T 3097 2018 7 请求报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 2 TransId 交易 ID MonitorHeader 字符串 Varchar2(31) 单节点 必填 3 BizKey 业务关键字 MonitorHeader 字符串 Varchar2(30) 单节点 不必填 4 PSCode 代理服务编号 MonitorHeader 字 符串 Varchar2(22) 单节点 必填 5 BSCode 业务
22、服务编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 响应报文格式： 表 3 服务响应报文 DB21/T 3097 2018 8 响应报文头字段说明（响应报文字段详细设置说明参见 4.2.4.2 业务响应 ）： 表 4 服务响应报文头字段说明 响应报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 ProviderResponse 响应报文 头 soap:Header 无 单节点 2 bizResCd 业务服务 响应码 ProviderResponse 字符串 见 码表一 单节点 必填 3 bizResText 业务
23、服务 响应信息 ProviderResponse 字符串 Varchar2(50) 单节点 必填 4.2.2.2 SOAP1.2 请求报文格式 : 表 5 服务请求报文 DB21/T 3097 2018 9 请求报文头字段说明（请求报文字段详细设置请参见 4.2.3.2 监控信息头设置 ）： 表 6 服务请求报文字段说明 请求报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 DB21/T 3097 2018 10 请求报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 MonitorHeader 请求报文
24、 头 soap:Header 无 单节点 2 TransId 交易 ID MonitorHeader 字符串 Varchar2(31) 单节点 必填 3 BizKey 业务关键 字 MonitorHeader 字符串 Varchar2(30) 单节点 不必填 4 PSCode 代理服务 编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 5 BSCode 业务服务 编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 响应报文格式 : 表 7 服务响应报文 DB21/T 3097 2018 11 响应报文头字段说明（响应报文字段详细设置
25、说明参见 4.2.4.2 业务响应 ）： 表 8 服务响应报文头字段说明 响应报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 ProviderResponse 响应报文 头 soap:Header 无 单节点 2 bizResCd 业务服务 响应码 ProviderResponse 字符串 见 4.4.1 码 表一 单节点 必填 3 bizResText 业务服务 响应信息 ProviderResponse 字符串 Varchar2(50) 单节点 必填 4.2.3 服务请求设置 4.2.3.1 业务系统认证 服务消费方调用代理服务时，需通过
26、HTTP基本认证机制传递用户名及密码完成服务总线业务系统认 证，用户名为服务消费方系统编号（系统编号为应用系统在平台注册时生成的唯一标识编号，需记录并 保存），密码为服务治理系统设置的服务消费方系统访问密码。 4.2.3.2 监控信息头设置 服务消费方调用代理服务时，需设置监控信息头以完成服务总线对服务消费方授权信 息校验。 Soap1.1、 Soap1.2监控信息头内容如下： DB21/T 3097 2018 12 表 9 监控信息头 监控信息头属性说明： 表 10 监控信息头属性说明 请求报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 Mo
27、nitorHeader 请求报文 头 soap:Header 无 单节点 2 TransId 交易 ID MonitorHeader 字符串 Varchar2(31) 单节点 必填 3 BizKey 业务关键 字 MonitorHeader 字符串 Varchar2(30) 单节点 不必填 4 PSCode 代理服务 编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 5 BSCode 业 务服务 MonitorHeader 字符串 单节点 DB21/T 3097 2018 13 请求报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数
28、据类型 备注 编号 Varchar2(22) 必填 交易 ID-TransId： 指定本次服务调用的唯一流水号，该值由服务消费方生成，并传递给服务总线。 交易 ID 编码规范：采用 2段编码，总长 31位。 - 其中，“ 14位系统编码”为服务消费方系统编号，由一体化平台统一配发，是服务消费方系统的唯 一认证编号，不可变更。系统编号可联系平台管理员获取。“ 16位流水号”为应用系统内本次服务调用 的唯一标识，流水号只能为数字，流水号需在服务消费方内 保持唯一性。 如： 000000-01-0001-0000000000000001 业务关键字 -BizKey 指定本次调用具有业务含义的关键信息
29、，如台站编号、单据号、批量数据的批次号等，由服务消费 方设置并发送给服务总线。其长度限制为 100个字符。 代理服务编号 - PSCode 服务消费方在服务治理系统申请代理服务使用时，需记录下代理服务编号，调用代理服务时需将代 理服务编号作为监控信息头传递给服务总线，完成代理服务授权校验。 业务服务编号 - BSCode 服务消费方在服务治理系统申请代理服务使用时，需记录下代理 服务对应的业务服务编号，调用代 理服务时需将业务服务编号作为监控信息头传递给服务总线，完成业务服务路由处理。 4.2.4 服务响应处理 服务调用过程中，服务发布方和服务消费方针对系统异常及业务响应分别进行处理。 系统异
30、常：指服务消费方、服务总线、服务发布方在服务调用过程中产生的运行时异常，系统异常 需根据出现场景，由服务消费方、服务总线、服务发布方人工干预处理。 业务响应：指在服务发布方业务服务正常处理过程产生的返回信息，服务总线及服务消费方接收响 应信息进行处理。 4.2.4.1 系统异常 服务调用过程中，产生的系统异常分以下四种情况： 1、服务消费方内部异常 服务消费方内部异常指在调用代理服务时，因服务消费方内部因素产生的异常信息。服务消费方内 部异常由服务消费方进行处理。 服务消费方内部异常代码一般为“ soap:Client”。 2、服务授权校验异常 DB21/T 3097 2018 14 服务授权
31、校验异常指在调用代理服务时，服务总线对服务消费方的监控信息头校验失败时产生的异 常。服务授权校验异常由服务消费方根据异常提示信息进行处理。 授权校验提示信息： 表 11 服务授权校验提示信息 代码 代码名称 SMP-20001 代理服务编号 为空 SMP-20002 业务服务编号 为空 SMP-20003 代理服务不存在 ,错误的代理服务编号 SMP-20004 业务服务不存在 ,错误的业务服务编号 SMP-20005 无权调用该服务 SMP-20006 业务服务调用地址 为空 其他代码 其他校验信息 3、服务总线运行异常 服务总线运行异常指在调用代理服务时，由于服务总线内部因素产生的异常。出
32、现服务总线运行异 常时，服务消费方需联系平台管理员处理。 4、服务发布方内部异常 服务发布方内部异常指在调用代理服务时，因服务发布方内部因素产生的异常。服务发布方内部异 常由服务消费方联系平台 管理员和服务发布方进行处理。 服务发布方内部异常代码一般为“ soap:Server”。 4.2.4.2 业务响应 服务发布方在业务服务处理完成之后，需要将处理结果通过响应报文头传递给服务消费方，服务消 费方根据不同返回结果，进行相应的处理。 Soap1.1、 Soap1.2响应报文头如下： 表 12 表格 4-12 服务响应报文头 DB21/T 3097 2018 15 响应报文头字段说明： 表 13 服务响应报文头属性说明 响应报文头信息（ soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 ProviderResponse 响应报文 头 soap:Header 无 单节点 2 bizResCd 业务服务 响应码 ProviderResponse 字符串 见 4.4.1 码表
