DB21-T 3097-2018遼寧省無(wú)線電管理一體化平臺(tái)系統(tǒng)集成規(guī)范

ICS35.100.70

M10

備案號(hào)：62054-2019DB21

遼寧省地方標(biāo)準(zhǔn)

DB21/T3097—2018

無(wú)線電管理一體化平臺(tái)軟件開(kāi)發(fā)規(guī)范

Softwaredevelopmentspecificationforradiomanagementintegratedplatform

I

DB21/T3097—2018

目次

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

1范圍.................................................................................1

2規(guī)范性引用文件.......................................................................1

3術(shù)語(yǔ)、定義和縮略語(yǔ)...................................................................1

3.1術(shù)語(yǔ)和定義.......................................................................1

3.2縮略語(yǔ)...........................................................................5

4服務(wù)治理系統(tǒng).........................................................................5

4.1功能介紹.........................................................................5

4.2服務(wù)接口約束.....................................................................5

4.3服務(wù)治理系統(tǒng)接口................................................................15

5流程管理系統(tǒng)........................................................................15

5.1功能介紹........................................................................15

5.2跨流程引擎服務(wù)接口定義及系統(tǒng)碼表................................................16

6統(tǒng)一門戶............................................................................16

6.1功能介紹........................................................................16

6.2系統(tǒng)集成........................................................................16

7統(tǒng)一身份............................................................................18

7.1功能介紹........................................................................18

7.2服務(wù)接口定義及系統(tǒng)碼表..........................................................18

8統(tǒng)一搜索............................................................................18

8.1功能介紹........................................................................18

8.2服務(wù)接口定義及系統(tǒng)碼表..........................................................19

附錄A（規(guī)范性附錄）服務(wù)治理系統(tǒng)接口.................................................20

A.1服務(wù)治理系統(tǒng)服務(wù)列表............................................................20

A.2業(yè)務(wù)服務(wù)信息維護(hù)服務(wù)............................................................20

A.2.1服務(wù)說(shuō)明....................................................................20

A.2.2服務(wù)請(qǐng)求報(bào)文................................................................20

A.2.3服務(wù)響應(yīng)報(bào)文................................................................28

A.2.4異常處理....................................................................30

A.3代理服務(wù)使用申請(qǐng)服務(wù)............................................................30

A.3.1服務(wù)說(shuō)明....................................................................30

I

DB21/T3097—2018

A.3.2服務(wù)請(qǐng)求報(bào)文................................................................30

A.3.3服務(wù)響應(yīng)報(bào)文................................................................33

A.3.4異常處理....................................................................34

A.4系統(tǒng)碼表........................................................................34

A.4.1碼表一：業(yè)務(wù)服務(wù)響應(yīng)碼......................................................34

A.4.2碼表二：服務(wù)狀態(tài)............................................................35

A.4.3碼表三：報(bào)文格式............................................................35

附錄B（規(guī)范性附錄）跨流程引擎服務(wù)接口定義及系統(tǒng)碼表..................................36

B.1跨流程引擎服務(wù)接口定義..........................................................36

B.1.1跨流程引擎服務(wù)列表..........................................................36

B.1.2流程模板數(shù)據(jù)匯總服務(wù)........................................................36

B.1.3流程實(shí)例數(shù)據(jù)匯總服務(wù)........................................................44

B.1.4待辦列表數(shù)據(jù)匯總服務(wù)........................................................50

B.2系統(tǒng)碼表........................................................................57

B.2.1碼表一：流程類型............................................................57

B.2.2碼表二：流程啟用狀態(tài)........................................................57

B.2.3碼表三：緊急狀態(tài)............................................................58

B.2.4碼表四：業(yè)務(wù)服務(wù)響應(yīng)碼......................................................58

B.2.5碼表五：節(jié)點(diǎn)類型............................................................58

B.2.6碼表六：待辦狀態(tài)............................................................59

附錄C（規(guī)范性附錄）統(tǒng)一身份服務(wù)接口定義及系統(tǒng)碼表....................................60

C.1統(tǒng)一身份服務(wù)接口定義............................................................60

C.1.1統(tǒng)一身份服務(wù)列表............................................................60

C.1.2查詢部門更新時(shí)間服務(wù)........................................................60

C.1.3查詢部門信息服務(wù)............................................................64

C.1.4查詢?nèi)藛T更新時(shí)間服務(wù)........................................................71

C.1.5查詢?nèi)藛T信息服務(wù)............................................................75

C.1.6查詢角色信息服務(wù)............................................................82

C.1.7查詢應(yīng)用系統(tǒng)和權(quán)限服務(wù)......................................................87

C.2系統(tǒng)碼表........................................................................92

C.2.1碼表一：業(yè)務(wù)服務(wù)響應(yīng)碼......................................................93

C.2.2碼表二：學(xué)歷................................................................93

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

C.2.4碼表四：人員類型............................................................97

C.2.5碼表五：行政職級(jí)............................................................97

II

DB21/T3097—2018

C.2.6碼表六：技術(shù)職稱............................................................98

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

C.2.8碼表八：工作地點(diǎn)...........................................................100

附錄D（規(guī)范性附錄）統(tǒng)一搜索服務(wù)接口定義和數(shù)據(jù)集成...................................101

D.1服務(wù)接口定義...................................................................101

D.1.1統(tǒng)一搜索服務(wù)列表...........................................................101

D.1.2索引數(shù)據(jù)推送服務(wù)...........................................................101

D.2統(tǒng)一搜索數(shù)據(jù)集成...............................................................106

D.2.1數(shù)據(jù)庫(kù)集成.................................................................106

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

參考文獻(xiàn).............................................................................108

III

DB21/T3097—2018

前言

本標(biāo)準(zhǔn)按照GB/T1.1-2009給出的規(guī)則起草。

請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本標(biāo)準(zhǔn)的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別這些專利的責(zé)任。

本文件由遼寧省工業(yè)和信息化委員會(huì)提出。

本文件由遼寧省工業(yè)和信息化委員會(huì)歸口。

本文件起草單位：遼寧省重大技術(shù)裝備戰(zhàn)略基地建設(shè)工程中心。

本文件主要起草人：孟嬌、孫宏志、張印、楊旭。

IV

DB21/T3097—2018

無(wú)線電管理一體化平臺(tái)軟件開(kāi)發(fā)規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了遼寧省無(wú)線電管理一體化平臺(tái)軟件中的服務(wù)治理系統(tǒng)、流程管理系統(tǒng)、統(tǒng)一門戶、統(tǒng)

一身份、統(tǒng)一搜索等的接口約束、接口定義和系統(tǒng)碼表等內(nèi)容。

本標(biāo)準(zhǔn)適用于遼寧省無(wú)線電管理一體化平臺(tái)軟件系統(tǒng)的開(kāi)發(fā)。

2規(guī)范性引用文件

下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

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

GB/T13622無(wú)線電管理術(shù)語(yǔ)

GB/T34084超短波頻段無(wú)線電監(jiān)測(cè)網(wǎng)數(shù)據(jù)庫(kù)結(jié)構(gòu)技術(shù)要求

3術(shù)語(yǔ)、定義和縮略語(yǔ)

3.1術(shù)語(yǔ)和定義

1

2

3

3.1

3.1.1

面向服務(wù)的體系結(jié)構(gòu)service-orientedarchitecture

即SOA是包含運(yùn)行環(huán)境、編程模型、架構(gòu)風(fēng)格和相關(guān)方法論等在內(nèi)的一整套新的分布式軟件系統(tǒng)構(gòu)

造方法和環(huán)境，涵蓋服務(wù)的整個(gè)生命周期。SOA以服務(wù)為基礎(chǔ)來(lái)實(shí)現(xiàn)的IT系統(tǒng)更靈活、更易于重用、更

好（也更快）地應(yīng)對(duì)變化；以服務(wù)為基礎(chǔ)，通過(guò)顯式地定義、描述、實(shí)現(xiàn)和管理業(yè)務(wù)層次的粗粒度服務(wù)。

3.1.2

服務(wù)service

在SOA架構(gòu)中，服務(wù)是最核心的抽象手段，它具有明確的功能，通常封裝著業(yè)務(wù)功能或者數(shù)據(jù)。一

個(gè)服務(wù)包括接口（Interface）、契約（Contract）和實(shí)現(xiàn)（Implementation）三個(gè)部分。服務(wù)的接口

和契約采用中立、基于標(biāo)準(zhǔn)的方式進(jìn)行定義，它獨(dú)立于實(shí)現(xiàn)服務(wù)的硬件平臺(tái)、操作系統(tǒng)和編程語(yǔ)言，這

使得構(gòu)建在不同系統(tǒng)中的服務(wù)可以以一種統(tǒng)一的和通用的方式進(jìn)行交互。

1

DB21/T3097—2018

3.1.3網(wǎng)絡(luò)服務(wù)webservice

WebService是一個(gè)平臺(tái)獨(dú)立的、低耦合的、自包含的、基于可編程的web的應(yīng)用程序，可使用開(kāi)放

的XML標(biāo)準(zhǔn)來(lái)描述、發(fā)布、發(fā)現(xiàn)、協(xié)調(diào)和配置這些應(yīng)用程序，用于開(kāi)發(fā)分布式的互操作的應(yīng)用程序。

WebService是一種跨編程語(yǔ)言和跨操作系統(tǒng)平臺(tái)的遠(yuǎn)程調(diào)用技術(shù)。

3.1.4

SOAP協(xié)議simpleobjectaccessprotocol

SOAP協(xié)議即簡(jiǎn)單對(duì)象訪問(wèn)協(xié)議（SimpleObjectAccessProtocol），它是用于交換XML編碼信息的

輕量級(jí)協(xié)議。

SOAP協(xié)議定義了SOAP消息的格式，SOAP協(xié)議是基于HTTP協(xié)議的，SOAP也是基于XML和XSD的，XML是

SOAP的數(shù)據(jù)編碼方式。

SOAP協(xié)議=HTTP協(xié)議+XML數(shù)據(jù)格式。

3.1.5

UDDIuniversaldescription,discovery,andintegration

UDDI是一種目錄服務(wù)，應(yīng)用系統(tǒng)可以使用它對(duì)WebService進(jìn)行注冊(cè)和搜索。

3.1.6

WSDLwebdervicedescriptionlanguage

WSDL是一個(gè)基于XML的語(yǔ)言，用于描述WebService及其函數(shù)、參數(shù)和返回值的標(biāo)準(zhǔn)格式。

3.1.7

企業(yè)服務(wù)總線enterpriseservicebus

企業(yè)服務(wù)總線，以下簡(jiǎn)稱ESB,是一種在松散耦合的服務(wù)和應(yīng)用之間標(biāo)準(zhǔn)的集成方式，提供簡(jiǎn)單、快

速、基于標(biāo)準(zhǔn)的多點(diǎn)集成，類似硬件中的總線結(jié)構(gòu)。

3.1.8

服務(wù)發(fā)布方servicepublisher

將應(yīng)用系統(tǒng)內(nèi)的業(yè)務(wù)方法發(fā)布成WebService服務(wù)，供遠(yuǎn)程單位和個(gè)人調(diào)用的應(yīng)用系統(tǒng)稱為服務(wù)發(fā)

布方。

3.1.9

服務(wù)消費(fèi)方serviceconsumer

調(diào)用服務(wù)發(fā)布方的WebService服務(wù)的應(yīng)用系統(tǒng)稱為服務(wù)消費(fèi)方。

3.1.10

http基本認(rèn)證機(jī)制httpbasicauthentication

2

DB21/T3097—2018

服務(wù)消費(fèi)方通過(guò)http協(xié)議調(diào)用WebService服務(wù)時(shí)，服務(wù)消費(fèi)方將用戶名及密碼以字符串形式放在

httprequest的headerAuthorization中發(fā)送給服務(wù)總線，當(dāng)用戶名密碼錯(cuò)誤時(shí)，服務(wù)總線會(huì)返回401

Unauthozied異常。

3.1.11

業(yè)務(wù)服務(wù)businessservice

由業(yè)務(wù)系統(tǒng)提供的服務(wù)，必須由服務(wù)總線封裝后再提供出去，不應(yīng)該被其它業(yè)務(wù)系統(tǒng)直接調(diào)用。業(yè)

務(wù)服務(wù)元數(shù)據(jù)由業(yè)務(wù)系統(tǒng)運(yùn)維維護(hù)。

3.1.12

代理服務(wù)proxyservice

由服務(wù)總線對(duì)業(yè)務(wù)服務(wù)封裝后對(duì)外提供的服務(wù)，可對(duì)業(yè)務(wù)服務(wù)進(jìn)行協(xié)議轉(zhuǎn)換、格式轉(zhuǎn)換、路由編排、

運(yùn)行監(jiān)控等封裝操作，是業(yè)務(wù)系統(tǒng)之間服務(wù)集成的橋梁，可被其它業(yè)務(wù)系統(tǒng)直接調(diào)用。代理服務(wù)元數(shù)據(jù)

由服務(wù)總線運(yùn)維維護(hù)。

3.1.13

交易IDtradingID

指定本次服務(wù)調(diào)用的唯一流水號(hào)，用于區(qū)分其它調(diào)用。該值由服務(wù)消費(fèi)方生成，并傳遞給服務(wù)總線，

當(dāng)使用服務(wù)治理系統(tǒng)進(jìn)行日志查詢時(shí)，可通過(guò)交易ID查詢服務(wù)調(diào)用日志。注意保證流水號(hào)在服務(wù)消費(fèi)方

內(nèi)的唯一性。

3.1.14

元素element

元素指的是從（且包括）開(kāi)始標(biāo)簽直到（且包括）結(jié)束標(biāo)簽的部分。元素可包含其他元素、文本或

者兩者的混合物。元素也可以擁有屬性。

元素必須遵循以下命名規(guī)則：

3.1.15

父元素parentelement

指當(dāng)前元素開(kāi)始標(biāo)簽之前和結(jié)束標(biāo)簽之后出現(xiàn)的元素為當(dāng)前元素的父元素。

3.1.16

循環(huán)節(jié)點(diǎn)loopnote

同一父元素下重復(fù)出現(xiàn)的元素屬性描述為循環(huán)節(jié)點(diǎn)。

3.1.17

單節(jié)點(diǎn)singlenode

3

DB21/T3097—2018

同一父元素下只允許出現(xiàn)一次的元素屬性描述為單節(jié)點(diǎn)。

3.1.18

流程管理processmanagement

流程管理是一種以規(guī)范化的構(gòu)造端到端的業(yè)務(wù)流程為中心，以持續(xù)的提高組織業(yè)務(wù)績(jī)效為目的的系

統(tǒng)化方法。它是一個(gè)操作性的定位描述，指的是流程分析、流程定義與重定義、資源分配、時(shí)間安排、

流程質(zhì)量與效率測(cè)評(píng)、流程優(yōu)化等。

3.1.19

流程引擎processengine

流程引擎是指workflow作為應(yīng)用系統(tǒng)的一部分，并為之提供有決定作用的根據(jù)角色、分工和不同條

件的信息傳遞路由和內(nèi)容。流程引擎包括，流程的節(jié)點(diǎn)管理、路由管理、流程實(shí)例管理等重要功能。

3.1.20

流程模板processtemplate

流程模板即流程定義或業(yè)務(wù)流程，是指為達(dá)到特定的價(jià)值目標(biāo)而由不同的人分別共同完成的一系列

活動(dòng)?；顒?dòng)之間不僅有嚴(yán)格的先后順序限定，而且活動(dòng)的內(nèi)容、方式、責(zé)任等也都必須有明確的安排和

界定，以使不同活動(dòng)在不同崗位角色之間進(jìn)行轉(zhuǎn)手交接成為可能?；顒?dòng)與活動(dòng)之間在時(shí)間和空間上的轉(zhuǎn)

移可以有較大的跨度。

3.1.21

流程節(jié)點(diǎn)processnode

當(dāng)業(yè)務(wù)流程需若干個(gè)不同程序(流程)或分若干個(gè)階段來(lái)完成時(shí)，某一程序或某一階段結(jié)束，另一程

序或另一階段開(kāi)始時(shí)的轉(zhuǎn)接點(diǎn)(類別點(diǎn)或時(shí)間點(diǎn))，稱流程節(jié)點(diǎn)。

流程節(jié)點(diǎn)的自然屬性是整個(gè)流程的精髓所在，一個(gè)流程從開(kāi)始到結(jié)束會(huì)經(jīng)歷一系列的節(jié)點(diǎn)，每個(gè)節(jié)

點(diǎn)由不同的人完成，每個(gè)人又分屬于不同的角色，使用不同的時(shí)間，有些流程每個(gè)節(jié)點(diǎn)可以流向下一個(gè)

節(jié)點(diǎn)或者返回前面任何一個(gè)節(jié)點(diǎn)。從一個(gè)節(jié)點(diǎn)流向下一個(gè)節(jié)點(diǎn)需要特定的條件。制定流程的過(guò)程就是設(shè)

置每個(gè)節(jié)點(diǎn)的自然屬性，通過(guò)這些屬性將每一個(gè)節(jié)點(diǎn)連接起來(lái)，實(shí)現(xiàn)所定義流程的流轉(zhuǎn)以及流程控制的

目的。

3.1.22

流程實(shí)例processinstance

流程實(shí)例是指流程模板在運(yùn)行時(shí)特有的執(zhí)行例程，一個(gè)流程模板被啟動(dòng)后產(chǎn)生一個(gè)流程實(shí)例，同一

個(gè)流程模版可以創(chuàng)建N多個(gè)流程實(shí)例。

3.1.23

待辦任務(wù)pendingtask

4

DB21/T3097—2018

啟動(dòng)一個(gè)流程模板后，流程實(shí)例運(yùn)行到某一個(gè)活動(dòng)時(shí)，對(duì)應(yīng)這個(gè)活動(dòng)會(huì)產(chǎn)生一個(gè)或多個(gè)任務(wù)，需要

不同的人、角色或者組織去執(zhí)行，每一個(gè)任務(wù)被稱為待辦任務(wù)。

3.2縮略語(yǔ)

下列縮略語(yǔ)適用于本文件：

SOA面向服務(wù)的體系結(jié)構(gòu)Service-OrientedArchitecture

SLAService-Levelagreement服務(wù)等級(jí)協(xié)議

XMLeXtensibleMarkupLanguage可擴(kuò)展標(biāo)記語(yǔ)言

WSDLWebServicesDescriptionLanguageWeb服務(wù)描述語(yǔ)言

SOAPSimpleObjectAccessProtocol簡(jiǎn)單對(duì)象訪問(wèn)協(xié)議

4服務(wù)治理系統(tǒng)

4.1功能介紹

服務(wù)治理系統(tǒng)基于企業(yè)總線ESB，利用產(chǎn)品內(nèi)置功能實(shí)現(xiàn)遼寧省無(wú)線電管理一體化平臺(tái)應(yīng)用系統(tǒng)之

間的服務(wù)接口集成，同時(shí)通過(guò)自開(kāi)發(fā)的功能實(shí)現(xiàn)對(duì)服務(wù)總線的監(jiān)控預(yù)警、服務(wù)調(diào)用信息和SLA信息的收

集、服務(wù)的全生命周期管理。

服務(wù)治理系統(tǒng)主要功能包括：

一、服務(wù)接入：通過(guò)產(chǎn)品提供的適配器支持多種協(xié)議接入、接出，適應(yīng)眾多異構(gòu)平臺(tái)，能快速將其

服務(wù)接入服務(wù)總線。

二、訪問(wèn)安全：通過(guò)產(chǎn)品提供的認(rèn)證、授權(quán)等安全策略，以及結(jié)合服務(wù)治理系統(tǒng)提供的服務(wù)調(diào)用授

權(quán)增強(qiáng)功能來(lái)確保服務(wù)訪問(wèn)的安全性。

三、路由轉(zhuǎn)換：通過(guò)產(chǎn)品提供的靈活的路由設(shè)置、消息轉(zhuǎn)換實(shí)現(xiàn)SOA架構(gòu)的靈活性和易用性。

四、運(yùn)行管理：通過(guò)產(chǎn)品提供的對(duì)于服務(wù)總線的管理監(jiān)控功能，確保SOA基礎(chǔ)架構(gòu)穩(wěn)定、可靠運(yùn)行。

4.2服務(wù)接口約束

4.2.1傳輸協(xié)議

服務(wù)治理系統(tǒng)允許服務(wù)發(fā)布方SOAP協(xié)議WebService服務(wù)接入。

4.2.2傳輸格式

服務(wù)治理系統(tǒng)允許WebService服務(wù)使用SOAP1.1、SOAP1.2格式報(bào)文傳輸。

SOAP1.1

請(qǐng)求報(bào)文格式：

表1服務(wù)請(qǐng)求報(bào)文

5

DB21/T3097—2018

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

<!--請(qǐng)求報(bào)文頭-->

<soap:Header>

<MonitorHeader>

<!--交易ID-->

<TransId></TransId>

<!--業(yè)務(wù)關(guān)鍵字-->

<BizKey></BizKey>

<!--代理服務(wù)編號(hào)-->

<PSCode></PSCode>

<!--業(yè)務(wù)服務(wù)編號(hào)-->

<BSCode></BSCode>

</MonitorHeader>

</soap:Header>

<!--請(qǐng)求報(bào)文體-->

<soap:Body>

<!--請(qǐng)求業(yè)務(wù)參數(shù)-->

</soap:Body>

</soap:Envelope>

請(qǐng)求報(bào)文頭字段說(shuō)明（請(qǐng)求報(bào)文字段詳細(xì)設(shè)置請(qǐng)參見(jiàn)監(jiān)控信息頭設(shè)置）：

表2服務(wù)請(qǐng)求報(bào)文頭字段說(shuō)明

請(qǐng)求報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

1MonitorHeader請(qǐng)求報(bào)文頭soap:Header無(wú)單節(jié)點(diǎn)

6

DB21/T3097—2018

請(qǐng)求報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

字符串單節(jié)點(diǎn)

2TransId交易IDMonitorHeader

Varchar2(31)必填

字符串單節(jié)點(diǎn)

3BizKey業(yè)務(wù)關(guān)鍵字MonitorHeader

Varchar2(30)不必填

字符串單節(jié)點(diǎn)

4PSCode代理服務(wù)編號(hào)MonitorHeader

Varchar2(22)必填

字符串單節(jié)點(diǎn)

5BSCode業(yè)務(wù)服務(wù)編號(hào)MonitorHeader

Varchar2(22)必填

響應(yīng)報(bào)文格式：

表3服務(wù)響應(yīng)報(bào)文

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

<!--響應(yīng)報(bào)文頭-->

<soap:Header>

<ProviderResponse>

<!--業(yè)務(wù)服務(wù)響應(yīng)碼-->

<bizResCd></bizResCd>

<!--業(yè)務(wù)服務(wù)響應(yīng)信息-->

<bizResText></bizResText>

</ProviderResponse>

</soap:Header>

<!--響應(yīng)報(bào)文體-->

<soap:Body>

7

DB21/T3097—2018

<!--響應(yīng)業(yè)務(wù)參數(shù)-->

</soap:Body>

</soap:Envelope>

響應(yīng)報(bào)文頭字段說(shuō)明（響應(yīng)報(bào)文字段詳細(xì)設(shè)置說(shuō)明參見(jiàn)業(yè)務(wù)響應(yīng)）：

表4服務(wù)響應(yīng)報(bào)文頭字段說(shuō)明

響應(yīng)報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

響應(yīng)報(bào)文

1ProviderResponsesoap:Header無(wú)單節(jié)點(diǎn)

頭

業(yè)務(wù)服務(wù)字符串單節(jié)點(diǎn)

2bizResCdProviderResponse

響應(yīng)碼見(jiàn)碼表一必填

業(yè)務(wù)服務(wù)字符串單節(jié)點(diǎn)

3bizResTextProviderResponse

響應(yīng)信息Varchar2(50)必填

SOAP1.2

請(qǐng)求報(bào)文格式:

表5服務(wù)請(qǐng)求報(bào)文

8

DB21/T3097—2018

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

<!--請(qǐng)求報(bào)文頭-->

<soap:Header>

<MonitorHeader>

<!--交易ID-->

<TransId></TransId>

<!--業(yè)務(wù)關(guān)鍵字-->

<BizKey></BizKey>

<!--代理服務(wù)編號(hào)-->

<PSCode></PSCode>

<!--業(yè)務(wù)服務(wù)編號(hào)-->

<BSCode></BSCode>

</MonitorHeader>

</soap:Header>

<!--請(qǐng)求報(bào)文體-->

<soap:Body>

<!--請(qǐng)求業(yè)務(wù)參數(shù)-->

</soap:Body>

</soap:Envelope>

請(qǐng)求報(bào)文頭字段說(shuō)明（請(qǐng)求報(bào)文字段詳細(xì)設(shè)置請(qǐng)參見(jiàn)監(jiān)控信息頭設(shè)置）：

表6服務(wù)請(qǐng)求報(bào)文字段說(shuō)明

請(qǐng)求報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

9

DB21/T3097—2018

請(qǐng)求報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

請(qǐng)求報(bào)文

1MonitorHeadersoap:Header無(wú)單節(jié)點(diǎn)

頭

字符串單節(jié)點(diǎn)

2TransId交易IDMonitorHeader

Varchar2(31)必填

業(yè)務(wù)關(guān)鍵字符串單節(jié)點(diǎn)

3BizKeyMonitorHeader

字Varchar2(30)不必填

代理服務(wù)字符串單節(jié)點(diǎn)

4PSCodeMonitorHeader

編號(hào)Varchar2(22)必填

業(yè)務(wù)服務(wù)字符串單節(jié)點(diǎn)

5BSCodeMonitorHeader

編號(hào)Varchar2(22)必填

響應(yīng)報(bào)文格式:

表7服務(wù)響應(yīng)報(bào)文

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

<!--響應(yīng)報(bào)文頭-->

<soap:Header>

<ProviderResponse>

<!--業(yè)務(wù)服務(wù)響應(yīng)碼-->

<bizResCd></bizResCd>

<!--業(yè)務(wù)服務(wù)響應(yīng)信息-->

<bizResText></bizResText>

</ProviderResponse>

10

DB21/T3097—2018

</soap:Header>

<!--響應(yīng)報(bào)文體-->

<soap:Body>

<!--響應(yīng)業(yè)務(wù)參數(shù)-->

</soap:Body>

</soap:Envelope>

響應(yīng)報(bào)文頭字段說(shuō)明（響應(yīng)報(bào)文字段詳細(xì)設(shè)置說(shuō)明參見(jiàn)業(yè)務(wù)響應(yīng)）：

表8服務(wù)響應(yīng)報(bào)文頭字段說(shuō)明

響應(yīng)報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

響應(yīng)報(bào)文

1ProviderResponsesoap:Header無(wú)單節(jié)點(diǎn)

頭

業(yè)務(wù)服務(wù)字符串單節(jié)點(diǎn)

2bizResCdProviderResponse

響應(yīng)碼見(jiàn)4.4.1碼表一必填

業(yè)務(wù)服務(wù)字符串單節(jié)點(diǎn)

3bizResTextProviderResponse

響應(yīng)信息Varchar2(50)必填

4.2.3服務(wù)請(qǐng)求設(shè)置

業(yè)務(wù)系統(tǒng)認(rèn)證

服務(wù)消費(fèi)方調(diào)用代理服務(wù)時(shí)，需通過(guò)HTTP基本認(rèn)證機(jī)制傳遞用戶名及密碼完成服務(wù)總線業(yè)務(wù)系統(tǒng)認(rèn)

證，用戶名為服務(wù)消費(fèi)方系統(tǒng)編號(hào)（系統(tǒng)編號(hào)為應(yīng)用系統(tǒng)在平臺(tái)注冊(cè)時(shí)生成的唯一標(biāo)識(shí)編號(hào)，需記錄并

保存），密碼為服務(wù)治理系統(tǒng)設(shè)置的服務(wù)消費(fèi)方系統(tǒng)訪問(wèn)密碼。

監(jiān)控信息頭設(shè)置

服務(wù)消費(fèi)方調(diào)用代理服務(wù)時(shí)，需設(shè)置監(jiān)控信息頭以完成服務(wù)總線對(duì)服務(wù)消費(fèi)方授權(quán)信息校驗(yàn)。

Soap1.1、Soap1.2監(jiān)控信息頭內(nèi)容如下：

11

DB21/T3097—2018

表9監(jiān)控信息頭

<MonitorHeader>

<!--交易ID-->

<TransId></TransId>

<!--業(yè)務(wù)關(guān)鍵字-->

<BizKey></BizKey>

<!--代理服務(wù)編號(hào)-->

<PSCode></PSCode>

<!--業(yè)務(wù)服務(wù)編號(hào)-->

<BSCode></BSCode>

</MonitorHeader>

監(jiān)控信息頭屬性說(shuō)明：

表10監(jiān)控信息頭屬性說(shuō)明

請(qǐng)求報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

請(qǐng)求報(bào)文

1MonitorHeadersoap:Header無(wú)單節(jié)點(diǎn)

頭

字符串單節(jié)點(diǎn)

2TransId交易IDMonitorHeader

Varchar2(31)必填

業(yè)務(wù)關(guān)鍵字符串單節(jié)點(diǎn)

3BizKeyMonitorHeader

字Varchar2(30)不必填

代理服務(wù)字符串單節(jié)點(diǎn)

4PSCodeMonitorHeader

編號(hào)Varchar2(22)必填

5BSCode業(yè)務(wù)服務(wù)MonitorHeader字符串單節(jié)點(diǎn)

12

DB21/T3097—2018

請(qǐng)求報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

編號(hào)Varchar2(22)必填

交易ID-TransId：

指定本次服務(wù)調(diào)用的唯一流水號(hào)，該值由服務(wù)消費(fèi)方生成，并傳遞給服務(wù)總線。

交易ID編碼規(guī)范：采用2段編碼，總長(zhǎng)31位。

<14位系統(tǒng)編碼>-<16位流水號(hào)>

其中，“14位系統(tǒng)編碼”為服務(wù)消費(fèi)方系統(tǒng)編號(hào)，由一體化平臺(tái)統(tǒng)一配發(fā)，是服務(wù)消費(fèi)方系統(tǒng)的唯

一認(rèn)證編號(hào)，不可變更。系統(tǒng)編號(hào)可聯(lián)系平臺(tái)管理員獲取?！?6位流水號(hào)”為應(yīng)用系統(tǒng)內(nèi)本次服務(wù)調(diào)用

的唯一標(biāo)識(shí)，流水號(hào)只能為數(shù)字，流水號(hào)需在服務(wù)消費(fèi)方內(nèi)保持唯一性。

如：000000-01-0001-0000000000000001

業(yè)務(wù)關(guān)鍵字-BizKey

指定本次調(diào)用具有業(yè)務(wù)含義的關(guān)鍵信息，如臺(tái)站編號(hào)、單據(jù)號(hào)、批量數(shù)據(jù)的批次號(hào)等，由服務(wù)消費(fèi)

方設(shè)置并發(fā)送給服務(wù)總線。其長(zhǎng)度限制為100個(gè)字符。

代理服務(wù)編號(hào)-PSCode

服務(wù)消費(fèi)方在服務(wù)治理系統(tǒng)申請(qǐng)代理服務(wù)使用時(shí)，需記錄下代理服務(wù)編號(hào)，調(diào)用代理服務(wù)時(shí)需將代

理服務(wù)編號(hào)作為監(jiān)控信息頭傳遞給服務(wù)總線，完成代理服務(wù)授權(quán)校驗(yàn)。

業(yè)務(wù)服務(wù)編號(hào)-BSCode

服務(wù)消費(fèi)方在服務(wù)治理系統(tǒng)申請(qǐng)代理服務(wù)使用時(shí)，需記錄下代理服務(wù)對(duì)應(yīng)的業(yè)務(wù)服務(wù)編號(hào)，調(diào)用代

理服務(wù)時(shí)需將業(yè)務(wù)服務(wù)編號(hào)作為監(jiān)控信息頭傳遞給服務(wù)總線，完成業(yè)務(wù)服務(wù)路由處理。

4.2.4服務(wù)響應(yīng)處理

服務(wù)調(diào)用過(guò)程中，服務(wù)發(fā)布方和服務(wù)消費(fèi)方針對(duì)系統(tǒng)異常及業(yè)務(wù)響應(yīng)分別進(jìn)行處理。

系統(tǒng)異常：指服務(wù)消費(fèi)方、服務(wù)總線、服務(wù)發(fā)布方在服務(wù)調(diào)用過(guò)程中產(chǎn)生的運(yùn)行時(shí)異常，系統(tǒng)異常

需根據(jù)出現(xiàn)場(chǎng)景，由服務(wù)消費(fèi)方、服務(wù)總線、服務(wù)發(fā)布方人工干預(yù)處理。

業(yè)務(wù)響應(yīng)：指在服務(wù)發(fā)布方業(yè)務(wù)服務(wù)正常處理過(guò)程產(chǎn)生的返回信息，服務(wù)總線及服務(wù)消費(fèi)方接收響

應(yīng)信息進(jìn)行處理。

系統(tǒng)異常

服務(wù)調(diào)用過(guò)程中，產(chǎn)生的系統(tǒng)異常分以下四種情況：

1、服務(wù)消費(fèi)方內(nèi)部異常

服務(wù)消費(fèi)方內(nèi)部異常指在調(diào)用代理服務(wù)時(shí)，因服務(wù)消費(fèi)方內(nèi)部因素產(chǎn)生的異常信息。服務(wù)消費(fèi)方內(nèi)

部異常由服務(wù)消費(fèi)方進(jìn)行處理。

服務(wù)消費(fèi)方內(nèi)部異常代碼一般為“soap:Client”。

2、服務(wù)授權(quán)校驗(yàn)異常

13

DB21/T3097—2018

服務(wù)授權(quán)校驗(yàn)異常指在調(diào)用代理服務(wù)時(shí)，服務(wù)總線對(duì)服務(wù)消費(fèi)方的監(jiān)控信息頭校驗(yàn)失敗時(shí)產(chǎn)生的異

常。服務(wù)授權(quán)校驗(yàn)異常由服務(wù)消費(fèi)方根據(jù)異常提示信息進(jìn)行處理。

授權(quán)校驗(yàn)提示信息：

表11服務(wù)授權(quán)校驗(yàn)提示信息

代碼代碼名稱

SMP-20001'代理服務(wù)編號(hào)'為空

SMP-20002'業(yè)務(wù)服務(wù)編號(hào)'為空

SMP-20003代理服務(wù)不存在,錯(cuò)誤的代理服務(wù)編號(hào)

SMP-20004業(yè)務(wù)服務(wù)不存在,錯(cuò)誤的業(yè)務(wù)服務(wù)編號(hào)

SMP-20005無(wú)權(quán)調(diào)用該服務(wù)

SMP-20006'業(yè)務(wù)服務(wù)調(diào)用地址'為空

其他代碼其他校驗(yàn)信息

3、服務(wù)總線運(yùn)行異常

服務(wù)總線運(yùn)行異常指在調(diào)用代理服務(wù)時(shí)，由于服務(wù)總線內(nèi)部因素產(chǎn)生的異常。出現(xiàn)服務(wù)總線運(yùn)行異

常時(shí)，服務(wù)消費(fèi)方需聯(lián)系平臺(tái)管理員處理。

4、服務(wù)發(fā)布方內(nèi)部異常

服務(wù)發(fā)布方內(nèi)部異常指在調(diào)用代理服務(wù)時(shí)，因服務(wù)發(fā)布方內(nèi)部因素產(chǎn)生的異常。服務(wù)發(fā)布方內(nèi)部異

常由服務(wù)消費(fèi)方聯(lián)系平臺(tái)管理員和服務(wù)發(fā)布方進(jìn)行處理。

服務(wù)發(fā)布方內(nèi)部異常代碼一般為“soap:Server”。

業(yè)務(wù)響應(yīng)

服務(wù)發(fā)布方在業(yè)務(wù)服務(wù)處理完成之后，需要將處理結(jié)果通過(guò)響應(yīng)報(bào)文頭傳遞給服務(wù)消費(fèi)方，服務(wù)消

費(fèi)方根據(jù)不同返回結(jié)果，進(jìn)行相應(yīng)的處理。

Soap1.1、Soap1.2響應(yīng)報(bào)文頭如下：

表12表格4-12服務(wù)響應(yīng)報(bào)文頭

<ProviderResponse>

<!--業(yè)務(wù)服務(wù)響應(yīng)碼-->

<bizResCd></bizResCd>

<!--業(yè)務(wù)服務(wù)響應(yīng)信息-->

<bizResText></bizResText>

14

DB21/T3097—2018

</ProviderResponse>

響應(yīng)報(bào)文頭字段說(shuō)明：

表13服務(wù)響應(yīng)報(bào)文頭屬性說(shuō)明

響應(yīng)報(bào)文頭信息（soap:Header）

序號(hào)元素代碼參數(shù)說(shuō)明父元素代碼數(shù)據(jù)類型備注

響應(yīng)報(bào)文

1ProviderResponsesoap:Header無(wú)單節(jié)點(diǎn)

頭

業(yè)務(wù)服務(wù)字符串單節(jié)點(diǎn)

2bizResCdProviderResponse

響應(yīng)碼見(jiàn)4.4.1碼表一必填

業(yè)務(wù)服務(wù)字符串單節(jié)點(diǎn)

3b