DB21∕T 3097-2018 无线电管理一体化平台 软件开发规范(辽宁省).pdf

I ICS 35.100.70 M 10 DB21 辽宁省地方标准 DB21/T 30972018 无线电管理一体化平台 软件开发规范 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 服务治理系统 .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 DB21/T 30972018 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 跨流程引擎服务列表 .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 DB21/T 30972018 III 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 DB21/T 30972018 IV 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本标准的发布机构不承担识别这些专利的责任。 本文件由辽宁省工业和信息化委员会提出。 本文件由辽宁省工业和信息化委员会归口。 本文件起草单位：辽宁省重大技术装备战略基地建设工程中心。 本文件主要起草人：孟娇、孙宏志、张印、杨旭。 DB21/T 30972018 1 无线电管理一体化平台软件开发规范 1 范围 本标准规定了辽宁省无线电管理一体化平台软件中的服务治理系统、流程管理系统、统一门户、统一身份、统一搜索等的接口约束、接口定义和系统码表等内容。 本标准适用于辽宁省无线电管理一体化平台软件系统的开发。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。 凡是注日期的引用文件， 仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 13622 无线电管理术语 GB/T 34084 超短波频段无线电监测网数据库结构技术要求 3 术语、定义和缩略语 3.1 术语和定义 1 2 3 3.1 3.1.1 面向服务的体系结构 service-oriented architecture 即SOA是包含运行环境、编程模型、架构风格和相关方法论等在内的一整套新的分布式软件系统构造方法和环境，涵盖服务的整个生命周期。SOA以服务为基础来实现的IT系统更灵活、更易于重用、更好（也更快）地应对变化；以服务为基础，通过显式地定义、描述、实现和管理业务层次的粗粒度服务。 3.1.2 服务 service 在SOA架构中，服务是最核心的抽象手段，它具有明确的功能，通常封装着业务功能或者数据。一个服务包括接口（Interface）、契约（Contract）和实现（Implementation）三个部分。服务的接口和契约采用中立、基于标准的方式进行定义，它独立于实现服务的硬件平台、操作系统和编程语言，这使得构建在不同系统中的服务可以以一种统一的和通用的方式进行交互。 DB21/T 30972018 2 3.1.3 网络服务 web service Web Service是一个平台独立的、低耦合的、自包含的、基于可编程的web的应用程序，可使用开放的XML标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。 Web Service是一种跨编程语言和跨操作系统平台的远程调用技术。 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 integration 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 将应用系统内的业务方法发布成Web Service服务，供远程单位和个人调用的应用系统称为服务发布方。 3.1.9 服务消费方 service consumer 调用服务发布方的Web Service服务的应用系统称为服务消费方。 3.1.10 http 基本认证机制 http basic authentication DB21/T 30972018 3 服务消费方通过http协议调用Web Service服务时，服务消费方将用户名及密码以字符串形式放在http request的header Authorization中发送给服务总线，当用户名密码错误时，服务总线会返回401 Unauthozied异常。 3.1.11 业务服务 business service 由业务系统提供的服务，必须由服务总线封装后再提供出去，不应该被其它业务系统直接调用。业务服务元数据由业务系统运维维护。 3.1.12 代理服务 proxy service 由服务总线对业务服务封装后对外提供的服务， 可对业务服务进行协议转换、 格式转换、 路由编排、运行监控等封装操作，是业务系统之间服务集成的桥梁，可被其它业务系统直接调用。代理服务元数据由服务总线运维维护。 3.1.13 交易 ID trading ID 指定本次服务调用的唯一流水号， 用于区分其它调用。 该值由服务消费方生成， 并传递给服务总线，当使用服务治理系统进行日志查询时， 可通过交易ID查询服务调用日志。 注意保证流水号在服务消费方内的唯一性。 3.1.14 元素 element 元素指的是从（且包括）开始标签直到（且包括）结束标签的部分。元素可包含其他元素、文本或者两者的混合物。元素也可以拥有属性。 元素必须遵循以下命名规则： 3.1.15 父元素 parent element 指当前元素开始标签之前和结束标签之后出现的元素为当前元素的父元素。 3.1.16 循环节点 loop note 同一父元素下重复出现的元素属性描述为循环节点。 3.1.17 单节点 single node DB21/T 30972018 4 同一父元素下只允许出现一次的元素属性描述为单节点。 3.1.18 流程管理 process management 流程管理是一种以规范化的构造端到端的业务流程为中心， 以持续的提高组织业务绩效为目的的系统化方法。它是一个操作性的定位描述，指的是流程分析、流程定义与重定义、资源分配、时间安排、流程质量与效率测评、流程优化等。 3.1.19 流程引擎 process engine 流程引擎是指workflow作为应用系统的一部分， 并为之提供有决定作用的根据角色、 分工和不同条件的信息传递路由和内容。流程引擎包括，流程的节点管理、路由管理、流程实例管理等重要功能。 3.1.20 流程模板 process template 流程模板即流程定义或业务流程， 是指为达到特定的价值目标而由不同的人分别共同完成的一系列活动。活动之间不仅有严格的先后顺序限定，而且活动的内容、方式、责任等也都必须有明确的安排和界定， 以使不同活动在不同岗位角色之间进行转手交接成为可能。 活动与活动之间在时间和空间上的转移可以有较大的跨度。 3.1.21 流程节点 process node 当业务流程需若干个不同程序(流程)或分若干个阶段来完成时， 某一程序或某一阶段结束， 另一程序或另一阶段开始时的转接点(类别点或时间点)，称流程节点。 流程节点的自然属性是整个流程的精髓所在， 一个流程从开始到结束会经历一系列的节点， 每个节点由不同的人完成，每个人又分属于不同的角色，使用不同的时间，有些流程每个节点可以流向下一个节点或者返回前面任何一个节点。 从一个节点流向下一个节点需要特定的条件。 制定流程的过程就是设置每个节点的自然属性， 通过这些属性将每一个节点连接起来， 实现所定义流程的流转以及流程控制的目的。 3.1.22 流程实例 process instance 流程实例是指流程模板在运行时特有的执行例程， 一个流程模板被启动后产生一个流程实例， 同一个流程模版可以创建N多个流程实例。 3.1.23 待办任务 pending task DB21/T 30972018 5 启动一个流程模板后，流程实例运行到某一个活动时，对应这个活动会产生一个或多个任务，需要不同的人、角色或者组织去执行，每一个任务被称为待办任务。 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 功能介绍 服务治理系统基于企业总线ESB，利用产品内置功能实现辽宁省无线电管理一体化平台应用系统之间的服务接口集成，同时通过自开发的功能实现对服务总线的监控预警、服务调用信息和SLA信息的收集、服务的全生命周期管理。 服务治理系统主要功能包括： 一、服务接入：通过产品提供的适配器支持多种协议接入、接出，适应众多异构平台，能快速将其服务接入服务总线。 二、访问安全：通过产品提供的认证、授权等安全策略，以及结合服务治理系统提供的服务调用授权增强功能来确保服务访问的安全性。 三、路由转换：通过产品提供的灵活的路由设置、消息转换实现SOA架构的灵活性和易用性。 四、运行管理：通过产品提供的对于服务总线的管理监控功能，确保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 30972018 6 请求报文头字段说明（请求报文字段详细设置请参见4.2.3.2 监控信息头设置）： 表2 服务请求报文头字段说明 请求报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 MonitorHeader 请求报文头 soap:Header 无 单节点 DB21/T 30972018 7 请求报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 2 TransId 交易 ID MonitorHeader 字符串 Varchar2(31) 单节点 必填 3 BizKey 业务关键字 MonitorHeader 字符串 Varchar2(30) 单节点 不必填 4 PSCode 代理服务编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 5 BSCode 业务服务编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 响应报文格式： 表3 服务响应报文 DB21/T 30972018 8 响应报文头字段说明（响应报文字段详细设置说明参见4.2.4.2 业务响应）： 表4 服务响应报文头字段说明 响应报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 ProviderResponse 响应报文 头 soap:Header 无 单节点 2 bizResCd 业务服务 响应码 ProviderResponse 字符串 见码表一 单节点 必填 3 bizResText 业务服务 响应信息 ProviderResponse 字符串 Varchar2(50) 单节点 必填 4.2.2.2 SOAP1.2 请求报文格式: 表5 服务请求报文 DB21/T 30972018 9 请求报文头字段说明（请求报文字段详细设置请参见4.2.3.2 监控信息头设置）： 表6 服务请求报文字段说明 请求报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 DB21/T 30972018 10 请求报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 MonitorHeader 请求报文 头 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 30972018 11 响应报文头字段说明（响应报文字段详细设置说明参见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 业务系统认证 服务消费方调用代理服务时， 需通过HTTP基本认证机制传递用户名及密码完成服务总线业务系统认证，用户名为服务消费方系统编号（系统编号为应用系统在平台注册时生成的唯一标识编号，需记录并保存），密码为服务治理系统设置的服务消费方系统访问密码。 4.2.3.2 监控信息头设置 服务消费方调用代理服务时，需设置监控信息头以完成服务总线对服务消费方授权信息校验。 Soap1.1、Soap1.2监控信息头内容如下： DB21/T 30972018 12 表9 监控信息头 监控信息头属性说明： 表10 监控信息头属性说明 请求报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 MonitorHeader 请求报文 头 soap:Header 无 单节点 2 TransId 交易 ID MonitorHeader 字符串 Varchar2(31) 单节点 必填 3 BizKey 业务关键 字 MonitorHeader 字符串 Varchar2(30) 单节点 不必填 4 PSCode 代理服务 编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 5 BSCode 业务服务 MonitorHeader 字符串 单节点 DB21/T 30972018 13 请求报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 编号 Varchar2(22) 必填 交易ID-TransId： 指定本次服务调用的唯一流水号，该值由服务消费方生成，并传递给服务总线。 交易ID 编码规范：采用2段编码，总长31位。 - 其中，“14位系统编码”为服务消费方系统编号，由一体化平台统一配发，是服务消费方系统的唯一认证编号，不可变更。系统编号可联系平台管理员获取。“16位流水号”为应用系统内本次服务调用的唯一标识，流水号只能为数字，流水号需在服务消费方内保持唯一性。 如：000000-01-0001-0000000000000001 业务关键字-BizKey 指定本次调用具有业务含义的关键信息，如台站编号、单据号、批量数据的批次号等，由服务消费方设置并发送给服务总线。其长度限制为100个字符。 代理服务编号- PSCode 服务消费方在服务治理系统申请代理服务使用时， 需记录下代理服务编号， 调用代理服务时需将代理服务编号作为监控信息头传递给服务总线，完成代理服务授权校验。 业务服务编号- BSCode 服务消费方在服务治理系统申请代理服务使用时， 需记录下代理服务对应的业务服务编号， 调用代理服务时需将业务服务编号作为监控信息头传递给服务总线，完成业务服务路由处理。 4.2.4 服务响应处理 服务调用过程中，服务发布方和服务消费方针对系统异常及业务响应分别进行处理。 系统异常：指服务消费方、服务总线、服务发布方在服务调用过程中产生的运行时异常，系统异常需根据出现场景，由服务消费方、服务总线、服务发布方人工干预处理。 业务响应： 指在服务发布方业务服务正常处理过程产生的返回信息， 服务总线及服务消费方接收响应信息进行处理。 4.2.4.1 系统异常 服务调用过程中，产生的系统异常分以下四种情况： 1、服务消费方内部异常 服务消费方内部异常指在调用代理服务时， 因服务消费方内部因素产生的异常信息。 服务消费方内部异常由服务消费方进行处理。 服务消费方内部异常代码一般为“soap:Client”。 2、服务授权校验异常 DB21/T 30972018 14 服务授权校验异常指在调用代理服务时， 服务总线对服务消费方的监控信息头校验失败时产生的异常。服务授权校验异常由服务消费方根据异常提示信息进行处理。 授权校验提示信息： 表11 服务授权校验提示信息 代码 代码名称 SMP-20001 代理服务编号为空 SMP-20002 业务服务编号为空 SMP-20003 代理服务不存在,错误的代理服务编号 SMP-20004 业务服务不存在,错误的业务服务编号 SMP-20005 无权调用该服务 SMP-20006 业务服务调用地址为空 其他代码 其他校验信息 3、服务总线运行异常 服务总线运行异常指在调用代理服务时， 由于服务总线内部因素产生的异常。 出现服务总线运行异常时，服务消费方需联系平台管理员处理。 4、服务发布方内部异常 服务发布方内部异常指在调用代理服务时， 因服务发布方内部因素产生的异常。 服务发布方内部异常由服务消费方联系平台管理员和服务发布方进行处理。 服务发布方内部异常代码一般为“soap:Server”。 4.2.4.2 业务响应 服务发布方在业务服务处理完成之后， 需要将处理结果通过响应报文头传递给服务消费方， 服务消费方根据不同返回结果，进行相应的处理。 Soap1.1、Soap1.2响应报文头如下： 表12 表格 4-12 服务响应报文头 DB21/T 30972018 15 响应报文头字段说明： 表13 服务响应报文头属性说明 响应报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 ProviderResponse 响应报文 头 soap:Header 无 单节点 2 bizResCd 业务服务 响应码 ProviderResponse 字符串 见 4.4.1 码表一 单节点 必填 3 bizResText 业务服务 响应信息 ProviderResponse 字符串 Varchar2(50) 单节点 必填 1）业务服务响应码- bizResCd 业务服务处理完成需要将服务处理结果返回服务消费方，服务消费方根据不同返回结果进行处理。 2）业务服务响应信息- bizResText 业务服务处理完成需要将服务处理提示信息返回给服务消费方，方便服务调用调试。 4.3 服务治理系统接口 服务治理系统对外提供两个自动化服务接口， 便于服务发布方大批量服务的信息维护 （注册、 变更、启停、注销）和服务消费方大批量服务的调用申请。按照辽宁省无线电管理机构当前实际情况，服务治理系统提供的此类服务接口只对监测设备操作原子服务的信息维护和自动化调用开放， 其它场景仍需通过服务治理系统的页面进行操作。 服务治理系统接口具体内容见附录A。 5 流程管理系统 5.1 功能介绍 流程管理系统为辽宁省无线电管理一体化平台提供统一的流程数据管理。 流程管理系统提供两种模式的流程驱动功能： DB21/T 30972018 16 1）跨流程引擎模式：应用系统使用自有流程引擎实现流程业务驱动。流程管理系统提供流程模板数据汇总服务、流程实例数据汇总服务和待办列表数据汇总服务，应用系统可调用以上服务，实现流程数据的统一管理。 2）单流程引擎模式：应用系统使用流程管理系统提供流程引擎实现流程业务驱动。流程管理系统提供基于ESB业务流程管理流程引擎封装的流程发起服务、待办提交服务、待办撤回服务和待办退回服务，应用系统可调用以上服务，实现流程业务驱动和流程数据的统一管理。 流程管理系统提供功能页面查看和维护流程模板数据、 流程实例数据、 待办列表数据和流程统计数据。 5.2 跨流程引擎服务接口定义及系统码表 跨流程引擎服务接口定义及系统码表具体信息见附录B。 6 统一门户 6.1 功能介绍 辽宁省无线电管理机构人员通过浏览器访问一体化平台， 经过应用安全平台通过后， 登录到统一门户，在统一门户中实现单点登录。在统一门户中可以使用流程中心、统一搜索和其他集成的应用系统功能，并根据权限访问统一门户中集成的各应用系统，实现应用系统之间的自由切换。统一门户中集成的应用系统需要在一体化平台内进行注册和集成。 6.2 系统集成 统一门户集成各应用系统， 为辽宁省无线电管理机构人员统一管理应用系统资源及应用系统访问权限控制提供数据基础。 6.2.1 系统注册 应用系统使用一体化平台内服务注册、服务使用、服务调用、流程汇总等功能时，需在一体化平台内完成系统注册处理，注册需要提供的应用系统属性如下： 表14 应用系统注册属性 属性名称 属性描述 系统名称 应用系统名称 系统链接 访问该应用系统的 URL 所属部门 应用系统所属部门 厂商信息 应用系统厂商信息 DB21/T 30972018 17 访问地址和端口 生产环境访问地址及端口 格式：127.0.0.1:8080，:8080 6.2.2 门户集成 应用系统注册完成之后， 应用系统集成到统一门户需要在一体化平台内完成门户集成操作， 门户集成需上传应用系统图标。应用系统需提供大图标及小图标完成应用系统集成。应用系统图标信息如下： 表15 应用系统图标信息 图标 要求 备注 应用系统大图标 样式一：176*128 像素 图标要求主体为白色，满足黑底显示效果 样式二：70*70 像素 图标根据实际业务场景设置图标配色 应用系统小图标 样式一：55*110 像素 图标为上部主体为白色、下部主体为黑色图标组合，满足鼠标选中切换效果 样式二：55*110 像素 图标为上部主体为蓝色、下部主体为白色图标组合，满足鼠标选中切换效果 DB21/T 30972018 18 图标 要求 备注 应用系统 Logo 图标 样式一：25*25 像素 图标根据实际业务场景设置图标配色 7 统一身份 7.1 功能介绍 统一身份为辽宁省无线电管理机构和各市无线电管理机构提供统一的身份管理，包括人员、部门、角色、应用系统信息和权限信息的统一管理。统一身份提供人员、部门、角色和应用系统的查询接口，其他应用系统通过查询接口获取人员、部门、角色、应用系统信息和权限信息。 7.2 服务接口定义及系统码表 统一身份服务接口定义及系统码表具体内容见附录C。 8 统一搜索 8.1 功能介绍 统一搜索在一体化平台内实现跨平台、 跨系统、 跨业务领域的搜索功能， 并基于统一门户实现集成。统一搜索支持多种格式的搜索内容、支持多数据源搜索，同时能满足搜索功能的安全性、易用性、集成性。 在统一搜索集成的目标系统需准备检索的表结构说明和字段详细说明， 一个功能模块对应一个索引表。索引表和索引字段由一体化平台创建，目标系统提供索引表和索引字段的详细说明。 索引字段类型说明如下（目标系统可参考来设定索引字段的类型）： 字符类型、数值类型和日期类型三大类，数值类型和日期类型主要用于有范围检索和排序的需求。 表16 索引数据类型 分类 类型 字符类型 string 字符串 数值类型 int 整数 long 长整数 float 浮点数 doubule 双精度浮点型 DB21/T 30972018 19 日期类型 date 日期 8.2 服务接口定义及系统码表 统一搜索服务接口定义及系统码表具体内容见附录D。 DB21/T 30972018 20 附 录 A （规范性附录） 服务治理系统接口 A.1 服务治理系统服务列表 表A.1 服务治理系统服务列表 序号 服务名称 服务发布方法 服务说明 1 业务服务信息维护服务 createServiceList 业务服务注册、变更、启停和注销处理 2 代理服务使用申请服务 useServiceWS 代理服务使用申请处理 A.2 业务服务信息维护服务 A.2.1 服务说明 本服务用于服务发布方注册、变更、启停、注销业务服务，申请即时生效，不需要通过人工审批流程。服务注册、变更、启停、注销服务调用参数限制参看服务请求报文体部分内容。 服务调用业务条件：业务服务属性信息。 服务返回业务信息：代理服务与业务服务编号。 服务发布协议：SOAP1.1。 服务发布方法：createServiceList。 A.2.2 服务请求报文 报文结构: 表A.2 业务服务信息维护服务请求报文 DB21/T 30972018 21 DB21/T 30972018 22 ? cid:76539183499 ? cid:1319256657353 ? DB21/T 30972018 23 cid:1329154204466 报文字段说明: 表A.3 业务服务信息维护服务请求报文头信息 请求报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 MonitorHeader 报文头 soap:Header 无 单节点 2 TransId 交易 ID MonitorHeader 字符串 Varchar2(31) 单节点 必填 3 BizKey 业务关键 字 MonitorHeader 字符串 Varchar2(30) 单节点 不必填 4 PSCode 代理服务 编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 5 BSCode 业务服务 编号 MonitorHeader 字符串 Varchar2(22) 单节点 必填 请求报文头信息设置参见“服务请求设置”部分。 表A.4 业务服务信息维护服务请求报文体信息 请求报文体信息（soap:Body） DB21/T 30972018 24 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 requestBody 请求报文 体 soap:Body 无 单节点 2 serviceCode 服务编号 requestBody 字符串 Varchar2(40) 单节点 注册：不填 变更：必填 启停：必填 注销：必填 3 serviceNameCn 服务中文 名称 requestBody 字符串 Varchar2(50) 单节点 注册：必填 变更：可选 启停：不填 注销：不填 4 serviceNameEn 服务英文 名称 requestBody 字符串 Varchar2(50) 单节点 注册：必填 变更：可选 启停：不填 注销：不填 5 serviceDesc 服务描述 requestBody 字符串 Varchar2(100) 单节点 注册：必填 变更：可选 启停：不填 注销：不填 6 appCode 所属系统 编号 requestBody 字符串 Varchar2(40) 单节点 注册：必填 DB21/T 30972018 25 请求报文体信息（soap:Body） 序号 元素代码 参数说明 父元素代码 数据类型 备注 变更：可选 启停：不填 注销：不填 7 serviceState 服务状态 requestBody 字符串 见 4.4.2 码表二 单节点 注册：必填 变更：可选 启停：必填 注销：必填 8 serviceVersion 服务版本 requestBody 字符串 Varchar2(10) 格式：V1.0 V1.1 V2.0 单节点 注册：必填 变更：可选 启停：不填 注销：不填 9 messageType 报文格式 requestBody 字符串 见码表三 单节点 注册：必填 变更：可选 启停：不填 注销：不填 10 serviceEndpoint 服务调用 地址 requestBody 字符串 Varchar2(500) 单节点 注册：必填 变更：可选 启停：不填 DB21/T 30972018 26 请求报文体信息（soap:Body） 序号 元素代码 参数说明 父元素代码 数据类型 备注 注销：不填 11 doc1FileUpVo 服务说明书 对象 requestBody 文件大小限制 10M 以内 单节点 注册：必填 变更：可选 启停：不填 注销：不填 12 fileName 服务说明书名称 doc1FileUpVo 字符串 Varchar2(255) 单节点 注册：必填 变更：可选 启停：不填 注销：不填 13 bytes 服务说明书内容 doc1FileUpVo base64Binary 单节点 注册：必填 变更：可选 启停：不填 注销：不填 14 doc2FileUpVo WSDL 文件 requestBody 文件大小限制 10M 以内 单节点 注册：必填 变更：可选 启停：不填 注销：不填 15 fileName WSDL 文件名称 doc2FileUpVo 字符串 单节点 DB21/T 30972018 27 请求报文体信息（soap:Body） 序号 元素代码 参数说明 父元素代码 数据类型 备注 Varchar2(255) 注册：必填 变更：可选 启停：不填 注销：不填 16 bytes WSDL 文件内容 doc2FileUpVo base64Binary 单节点 注册：必填 变更：可选 启停：不填 注销：不填 17 doc3FileUpVo 测试请求报文 requestBody 文件大小限制 10M 以内 单节点 注册：必填 变更：可选 启停：不填 注销：不填 18 fileName 测试请求报文名称 doc3FileUpVo 字符串 Varchar2(255) 单节点 注册：必填 变更：可选 启停：不填 注销：不填 19 bytes 测试请求报文内容 doc3FileUpVo base64Binary 单节点 注册：必填 变更：可选 DB21/T 30972018 28 请求报文体信息（soap:Body） 序号 元素代码 参数说明 父元素代码 数据类型 备注 启停：不填 注销：不填 A.2.3 服务响应报文 报文结构: 表A.5 业务服务信息维护服务响应报文 DB21/T 30972018 29 报文字段说明: 表A.6 业务服务信息维护服务响应报文头信息 响应报文头信息（soap:Header） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 ProviderResponse 请求报文 头 soap:Header 无 单节点 必填 2 bizResCd 业务服务 响应码 ProviderResponse 字符串 见 4.4.1 码表一 单节点 必填 3 bizResText 业务服务 响应信息 ProviderResponse 字符串 Varchar2(50) 单节点 必填 响应报文头信息设置及处理参见“服务响应处理”部分。 表A.7 业务服务信息维护服务响应报文体信息 响应报文体信息（soap:Body） 序号 元素代码 参数说明 父元素代码 数据类型 备注 1 responseBody 响应报文 体 soap:Body 无 单节点 2 serviceCode 业务服务 编号 responseBody 字符串 Varchar2(40) 单节点 必填 DB21/T 30972018 30 响