DB61T 1344.3-2020 智慧統(tǒng)戰(zhàn)綜合服務平臺技術(shù)規(guī)范 第3部分：數(shù)據(jù)共享與交換

DB61/T1344.3DB61/T1344.3—2020DB61/T1344.3DB61/T1344.3—2020目 次前言 II112范引文件 13語定義 14據(jù)換體15戶一理證26據(jù)換27于表交換 38于件交換 49于口交換 4附錄A（規(guī)性錄數(shù)據(jù)錄 6附錄B（規(guī)性錄數(shù)據(jù)口 7附錄C（規(guī)性錄接口議式 12I前 言DB61/T1344《智慧統(tǒng)戰(zhàn)綜合服務平臺技術(shù)規(guī)范》分為三個部分：12——第3部分：數(shù)據(jù)共享與交換。本部分為DB61/T1344的第3部分。本部分按照GB/T1.1—2009給出的規(guī)則起草。本部分由中共陜西省委統(tǒng)一戰(zhàn)線工作部提出并歸口。本部分起草單位：中共陜西省委統(tǒng)一戰(zhàn)線工作部、中共咸陽市委網(wǎng)絡安全和信息化委員會辦公室、陜西未來數(shù)據(jù)信息科技有限公司。本部分主要起草人：虞浩桂、張鵬、田少娟、朱年奇、趙軍、劉瑞娜、崔鵬飛。本部分由中共陜西省委統(tǒng)一戰(zhàn)線工作部負責解釋。本部分首次發(fā)布。聯(lián)系信息如下：單位：中共陜西省委統(tǒng)一戰(zhàn)線工作部電話址：陜西省西安市雁塔區(qū)雁塔路南段10號郵編：710054II智慧統(tǒng)戰(zhàn)綜合服務平臺技術(shù)規(guī)范第3部分：數(shù)據(jù)共享與交換范圍DB61/T1344的本部分規(guī)定了省級智慧統(tǒng)戰(zhàn)綜合服務平臺數(shù)據(jù)共享與交換的相關(guān)技術(shù)要求。DB61/T1344.2—2020 2下列術(shù)語和定義適用于本文件。3.1數(shù)據(jù)享交參方 participantsindatashareandexchange是指全省各級統(tǒng)戰(zhàn)部門和成員單位的信息系統(tǒng)3.2交換置統(tǒng) exchangepre-system1說明：數(shù)據(jù)共享與交換參與方可通過智慧統(tǒng)戰(zhàn)綜合服務平臺進行數(shù)據(jù)共享與交換。每個參與方既可以提供數(shù)據(jù)資源（此時稱為數(shù)據(jù)提供方），又可以通過智慧統(tǒng)戰(zhàn)綜合服務平臺共享其它參與方的數(shù)據(jù)資源（此時稱為數(shù)據(jù)接收方）；交換前置系統(tǒng)可部署在參與方端或智慧統(tǒng)戰(zhàn)綜合服務平臺端，優(yōu)先部署在智慧統(tǒng)戰(zhàn)綜合服務平臺端。圖1 智慧戰(zhàn)合務臺據(jù)共與換體構(gòu)區(qū)各級統(tǒng)戰(zhàn)部門及成員單位信息系統(tǒng)之間實時、周期性、結(jié)構(gòu)化的數(shù)據(jù)共享與交換。支持MySQL、Oracle、達夢、人大金倉等主流數(shù)據(jù)庫之間的數(shù)據(jù)交換。2SFTP22。文件目錄命名規(guī)則：根據(jù)DB61/T1344.2-2020中第3章數(shù)據(jù)編碼規(guī)定，數(shù)據(jù)編碼一段/數(shù)據(jù)編碼二段/文件上傳日期。SFTPrarzipJSONB各級統(tǒng)戰(zhàn)部門及成員單位信息系統(tǒng)之間實時、周期性、數(shù)據(jù)包、結(jié)構(gòu)化的數(shù)據(jù)交換。采用基于HTTPS協(xié)議的RESTful接口形式。服務接口的發(fā)布格式規(guī)范見附錄C。IPADB61/1344.2-2020IP3SFTP文SFTPADB61/T1344.2-202045.2.3。5.2.4。SFTPSFTPIPSFTPSFTPSFTPSFTPSFTP4.3.3A4.3.3AuthorizationCode。SecretKeyAuthorizationCode。455RESTfulJSONSecretKeyAuthorizationCodeHTTPC。附 錄 A（規(guī)范性附錄）數(shù)據(jù)目錄數(shù)據(jù)目錄表見表A.1。表A.1 數(shù)據(jù)錄表編號目錄數(shù)據(jù)項說明1數(shù)據(jù)目錄編碼應符合DB61/T1344.2-2020中第3章數(shù)據(jù)編碼規(guī)定2名稱數(shù)據(jù)的名稱3數(shù)據(jù)提供部門數(shù)據(jù)目錄來源部門4發(fā)布時間數(shù)據(jù)目錄首次發(fā)布的具體時間5更新時間數(shù)據(jù)目錄更新的具體時間6共享方式支持共享數(shù)據(jù)的方式，基于庫表交換、基于文件交換、基于接口交換三種方式7更新周期數(shù)據(jù)目錄更新周期，如年、月、周、日等。共享方式為基于接口交換方式時，該內(nèi)容不填寫7支持格式數(shù)據(jù)格式，基于庫表交換為數(shù)據(jù)庫類型，基于文件交換為文件后綴名，基于接口交換為JSON格式9資源狀態(tài)數(shù)據(jù)目錄所指數(shù)據(jù)資源的狀態(tài)，如活躍、廢棄等10來源系統(tǒng)數(shù)據(jù)來源所屬的信息系統(tǒng)名稱6附 錄 B（規(guī)范性附錄）數(shù)據(jù)接口數(shù)據(jù)接口模型由數(shù)據(jù)結(jié)構(gòu)、數(shù)據(jù)集、附件集，如圖B.1所示，其中：圖B.1 數(shù)據(jù)口型EnvelopInfo；約束/約束/Attachments；約束/B.2所示7圖B.2 數(shù)據(jù)構(gòu)MessageId；(yyyyMMddHHmmss)+MessageType；DB61/T1344.2-20203/MessageTime；yyyy-MM-ddHH:mm:ss；MessageSender；MessageReceiver；Count；8數(shù)據(jù)集B.3圖B.3 數(shù)據(jù)集DataNode；約束/數(shù)據(jù)項應符合DB61/T1344.2-20204附件集PDFWordB.4圖B.4 附件集9AttachmentID；(yyyyMMddHHmmss)++約束/AttachmentName；約束/AttachmentDescription；約束/AttachmentType；約束/AttachmentContent；Base64約束/JSON{"EnvelopInfo":{"MessageId":"報文編號","MessageType":"報文業(yè)務編號","MessageTime":"報文發(fā)送時間","MessageSender":"報文發(fā)送者","MessageReceive":"報文接受者","Count":"業(yè)務記錄數(shù)"[{"peopleType":"統(tǒng)戰(zhàn)對象類型","personName":"姓名","sex":"性別","nation":"民族","idNumber":"身份證號碼","certificateType":"有效證件類型","certificateNum":"有效證件號碼",10"birthday":"出生日期","nationality":"國籍","homeDomicile":"常住地","political":"政治面貌","nativePlace":"戶籍所在地","fullTimeDegree":"全日制學歷","academicDegree":"全日制學位","onJobEducation":"在職教育學歷","onJobDegree":"在職教育學位","email":"電子郵件","telephone":"移動電話"},{"peopleType":"統(tǒng)戰(zhàn)對象類型","personName":"姓名","sex":"性別","nation":"民族","idNumber":"身份證號碼"}],[{"AttachmentID":"附件標識","AttachmentName":"附件名稱","AttachmentDescription":"附件描述","AttachmentType":"附件類型","AttachmentContent":"附件內(nèi)容"}]}11附 錄 C（規(guī)范性附錄）接口協(xié)議格式表C.1 發(fā)布務口議式表接口名稱交換數(shù)據(jù)描述，按照數(shù)據(jù)分類編碼-數(shù)據(jù)來源部門格式命名請求路徑HTTPS://XXX/API/請求方式GET請求參數(shù)依據(jù)DB61/T1344.2-2020中第4章數(shù)據(jù)結(jié)構(gòu)成功State狀態(tài)碼見附錄C.2message請求狀態(tài)說明dataset服務接口返回對象見附錄C.3失敗State狀態(tài)碼見附錄C.2Error錯誤信息表C.2 服務口求態(tài)表狀態(tài)碼含義200請求已成功400請求信息不完整或無法解析401訪問令牌沒有提供，或者無效403訪問令牌有效，但沒有權(quán)限4