DBJ50-T-141-2012城鄉(xiāng)建設數(shù)據(jù)交換接口標準

城鄉(xiāng)建設數(shù)據(jù)交換接口標準主編單位：重慶市建設信息中心施行日期：2019年4月1日性標準，編號為DBJ50/T-311-2019,自20192019年1月10日根據(jù)《重慶市城鄉(xiāng)建設委員會關于下達2018年度重慶市工程建設標準制訂修訂項目計劃(第一批)的通知》(渝建〔20180447號)文件要求，標準編制組經(jīng)廣泛調查研究，認真總結工程實踐經(jīng)驗，參考有關國家標準，并在廣泛充分征求意見的基礎上，制定本標準。本標準共7章，主要內容包括：1.總則；2.術語；3.數(shù)據(jù)交換體系；4.數(shù)據(jù)標準及資源目錄；5.數(shù)據(jù)交換方式及技術要求；6.數(shù)據(jù)交換安全規(guī)范；7.數(shù)據(jù)接口服務規(guī)范。本標準由重慶市住房和城鄉(xiāng)建設委員會負責管理，重慶市建設信息中心負責具體技術內容的解釋。在本標準執(zhí)行過程中，請各單位注意收集資料，總結經(jīng)驗，并將有關意見和建議反饋給重慶市建設信息中心(地址：重慶市渝中區(qū)長江一路58號，郵編：400014電話真,以便以后修訂時參考。本標準主編單位、參編單位、主要起草人和審查專家： 12術語 23數(shù)據(jù)交換體系 43.1體系構成 43.2數(shù)據(jù)交換平臺 5 7……64數(shù)據(jù)標準及資源目錄 74.1數(shù)據(jù)標準及編碼規(guī)范 74.2數(shù)據(jù)資源目錄 75數(shù)據(jù)交換方式及技術要求 95.1一般規(guī)定 95.2數(shù)據(jù)交換技術要求 5.3數(shù)據(jù)傳輸技術要求 6數(shù)據(jù)交換安全規(guī)范 6.1一般規(guī)定 6.2共享數(shù)據(jù)權限管理 6.3數(shù)據(jù)接口使用權限認證 6.4前置機安全管理 137數(shù)據(jù)接口服務規(guī)范 7.1一般規(guī)定 7.2權限管理接口 7.3資源目錄接口 7.4數(shù)據(jù)內容接口 18附錄A示例代碼 21附錄B數(shù)據(jù)資源目錄示例 26 27引用標準目錄 28條文說明 29 1 2 4 4 5 6 7 74.2DataResourceDirectory 7 9 9 95.3TechnicalRequiremen 11 12 6.4SafetyManagementofFro 7.2AccessPermissionInterf 7.3ResourceDire 15 21 ExplanationofWording 27NormartiveStandards 28ExplanationofProvisions 291.0.1為實現(xiàn)重慶市城鄉(xiāng)建設領域基礎數(shù)據(jù)的標準化和規(guī)范化，滿足未來大數(shù)據(jù)智能化和城鄉(xiāng)建設領域基礎信息交換與資源共享的需要，支持重慶市共享交換平臺的接入規(guī)范和技術標準，特制定本標準以指導和促進重慶市城鄉(xiāng)建設領域信息系統(tǒng)的建設。1.0.2本標準適用于城鄉(xiāng)建設領域進行數(shù)據(jù)交換時的數(shù)據(jù)編碼規(guī)范、交換方式、交換安全和接口服務規(guī)范等處理工作。1.0.3本標準規(guī)定的數(shù)據(jù)交換接口應遵循系統(tǒng)性、實用性、可擴展性和科學性的原則。1.0.4本標準不限制用戶擴展相應的信息內容，但在擴展內容時不應與本標準相矛盾。1.0.5重慶市城鄉(xiāng)建設領域數(shù)據(jù)交換除應遵守本標準外，尚應符合國家及重慶市現(xiàn)行有關標準的規(guī)定。22.0.1數(shù)據(jù)資源DataResource相關單位在依法履行職責過程中生成或采集的，以一定形式記錄、保存的文件、資料、圖表、音視頻、建筑模型等各類數(shù)字化的數(shù)據(jù)，包括直接或間接通過第三方依法采集的、依法授權管理的和依托政務信息系統(tǒng)形成的數(shù)據(jù)等。2.0.2數(shù)據(jù)交換Dataexchange信息資源在互相之間的兩個或兩個以上不同系統(tǒng)之間發(fā)送、傳輸、接收的過程。2.0.3數(shù)據(jù)交換體系DataExchangeArchitecture數(shù)據(jù)交換體系由數(shù)據(jù)提供者、數(shù)據(jù)使用者、數(shù)據(jù)管理者、信息庫、數(shù)據(jù)交換平臺和數(shù)據(jù)交換模式組成。2.0.4交換流程Exchangeprocess遵循特定規(guī)則，并完成特定數(shù)據(jù)交換任務的工作程序。2.0.5資源目錄ResourceDirectory通過對信息資源依據(jù)規(guī)范的元數(shù)據(jù)描述，按照一定的分類方法進行排序和編碼的一組信息，用以描述各個信息資源的特征，以便于對信息資源的檢索、定位與獲取。2.0.6數(shù)據(jù)提供者/Dataprovider數(shù)據(jù)資源的提供方，對外提供本單位的數(shù)據(jù)資源供他人使用。2.0.7數(shù)據(jù)使用者DataConsumer數(shù)據(jù)資源的使用方，一般應通過調用提供者提供的數(shù)據(jù)開展業(yè)務系統(tǒng)建設。2.0.8數(shù)據(jù)交換平臺Dataexchangeplatform數(shù)據(jù)交換平臺將分散建設的若干應用信息系統(tǒng)進行整合，通3過計算機網(wǎng)絡構建的信息交換平臺，它使若干個應用子系統(tǒng)進行信息/數(shù)據(jù)的傳輸及共享，提高信息資源的利用率，成為進行信息2.0.9超文本傳輸協(xié)議HyperTextTransferProtocol(HT-TP)超文本傳輸協(xié)議(HTTP,HyperTextTransferProtocol)是互聯(lián)網(wǎng)上應用最為廣泛的一種網(wǎng)絡協(xié)議。2.0.10超文本傳輸安全協(xié)議HyperTextTransferProtocoloverSecureSocketLayer(HTTPS)超文本傳輸安全協(xié)議(HTTPS,HyperTextTransferProto-coloverSecureSocketLayer),是以安全為目標的HTTP通道。句法類同HTTP體系，用于安全的HTTP數(shù)據(jù)傳輸。2.0.11可擴展標記語言ExtensibleMarkupLanguage(XML)可擴展標記語言，定義了用于定義其它與特定領域有關的、語義的、結構化的標記語言的句法語言。2.0.12簡單對象訪問協(xié)議SimpleObjectAccessProtocol(SOAP)簡單對象訪問協(xié)議(SOAP,SimpleObjectAccessProtocol)2.0.13WebServices基于XMI進行數(shù)據(jù)交換的一種跨平臺的系統(tǒng)通信方式。WebServices/主要利用HTTP和SOAP協(xié)議使業(yè)務數(shù)據(jù)在Web上傳輸，SOAP通過HTTP調用業(yè)務對象執(zhí)行遠程功能調用，Web用戶能夠使用SOAP和HTTP通過Web調用的方法來調用遠程對象。2.0.14JSONJSON(JavaScriptObjectNotation)是一種輕量級的數(shù)據(jù)交換格式。43數(shù)據(jù)交換體系3.1體系構成3.1.1數(shù)據(jù)交換體系應以數(shù)據(jù)為主體構建，包括數(shù)據(jù)提供者、數(shù)據(jù)使用者、數(shù)據(jù)管理者、信息庫、數(shù)據(jù)交換平臺和數(shù)據(jù)交換模式。數(shù)據(jù)交換體系框架如圖3.1.1所示。數(shù)據(jù)管理者數(shù)據(jù)管理者數(shù)據(jù)交換模式數(shù)據(jù)數(shù)據(jù)使用者信息庫數(shù)據(jù)交換平臺數(shù)據(jù)提供者數(shù)據(jù)3.1.2數(shù)據(jù)提供者應負責本單位資源目錄編制、數(shù)據(jù)資源發(fā)布、數(shù)據(jù)維護管理、數(shù)據(jù)更新等工作。3.1.3數(shù)據(jù)使用者應根據(jù)應用需要負責查找數(shù)據(jù)資源目錄、申請數(shù)據(jù)等工作。3.1.4數(shù)據(jù)管理者應負責對數(shù)據(jù)交換平臺進行管理與運維，承擔數(shù)據(jù)交換流轉過程的定義、用戶身份識別與管理權限控制等工作。3.1.5信息庫宜包含共享信息庫和前置交換信息庫。3.1.6數(shù)據(jù)交換平臺應支撐數(shù)據(jù)提供者和數(shù)據(jù)使用者開展數(shù)據(jù)交換活動。3.1.7數(shù)據(jù)交換模式應滿足信息交換過程中信息實時交換、信5息適配和信息安全的要求。3.2數(shù)據(jù)交換平臺3.2.1數(shù)據(jù)交換應通過數(shù)據(jù)交換平臺進行，平臺宜包括數(shù)據(jù)標準及目錄、中心交換服務、傳輸交換服務、前置交換服務、交換接口服務、安全與交換管理服務等功能。數(shù)據(jù)交換平臺框架如圖3.2.1所示。數(shù)據(jù)交換平臺中心交換服務數(shù)據(jù)標準及目錄服務安全及交換管理服務數(shù)據(jù)標準及目錄服務安全及交換管理服務交換傳輸服務前置交換服務數(shù)據(jù)接口服務安全管理安全管理接口圖3.2.1數(shù)據(jù)交換平臺框架3.2.2數(shù)據(jù)交換平臺應符合以下規(guī)定：1數(shù)據(jù)標準及目錄服務應規(guī)定數(shù)據(jù)標準及目錄規(guī)范，提供資源目錄上傳(目錄維護等服務；2中心交換服務應集中存儲共享信息庫，數(shù)據(jù)提供者或使用者通過訪問共享信息庫實現(xiàn)信息資源交換；3交換傳輸服務應提供前置交換信息庫之間的信息處理和穩(wěn)定可靠、不間斷的信息傳輸；4前置交換服務應提供數(shù)據(jù)提供者、數(shù)據(jù)使用者業(yè)務系統(tǒng)與交換平臺的隔離，保證數(shù)據(jù)提供者、數(shù)據(jù)使用者業(yè)務系統(tǒng)的獨立性；5數(shù)據(jù)接口服務應提供數(shù)據(jù)庫、數(shù)據(jù)文件的自動服務化，以6及數(shù)據(jù)接口的封裝代理，為數(shù)據(jù)交換提供服務接口；6安全與交換管理服務應提供對整個數(shù)據(jù)交換過程的流程3.2.3重慶市住房和城鄉(xiāng)建設委員會應建設數(shù)據(jù)交換平臺，為城鄉(xiāng)建設領域各單位提供數(shù)據(jù)交換服務；數(shù)據(jù)交換平臺應具備與部級、市級等上級數(shù)據(jù)共享交換平臺進行對接功能。3.2.4城鄉(xiāng)建設領域各單位應通過重慶市住房和城鄉(xiāng)建設委員會數(shù)據(jù)交換平臺開展數(shù)據(jù)交換活動；具備條件的單位可遵照本標準建設自己的數(shù)據(jù)交換平臺，但應與重慶市住房和城鄉(xiāng)建設委員會的數(shù)據(jù)交換平臺實現(xiàn)對接。3.3數(shù)據(jù)交換模式3.3.1數(shù)據(jù)交換模式宜提供集中式交換和分布式交換兩種模式。3.3.2集中式交換模式應提供通過應用終端訪問共享信息實現(xiàn)數(shù)據(jù)交換。3.3.3分布式交換模式應符合以下規(guī)定：1應實現(xiàn)所有前置交換服務對外交換的信息均可由中心交換服務進行數(shù)據(jù)傳輸；2應實現(xiàn)數(shù)據(jù)提供者和數(shù)據(jù)使用者可通過前置交換服務之間不通過中心交換服務點到點直接交換信息。74數(shù)據(jù)標準及資源目錄4.1數(shù)據(jù)標準及編碼規(guī)范4.1.1數(shù)據(jù)交換應統(tǒng)一數(shù)據(jù)標準和編碼規(guī)范。4.1.2數(shù)據(jù)標準及編碼規(guī)范應符合《重慶市城鄉(xiāng)建設領域基礎數(shù)據(jù)標準》DBJ50/T-196的有關規(guī)定。4.2數(shù)據(jù)資源目錄4.2.1數(shù)據(jù)資源應實行資源目錄管理，并提供資源目錄服務。4.2.2數(shù)據(jù)資源目錄編制、維護應符合以下規(guī)定：1數(shù)據(jù)資源分類必填項，參照相關國家標準規(guī)定的基本原則和方法，對政務2數(shù)據(jù)資源名稱必填項，描述數(shù)據(jù)資源內容的標題。3數(shù)據(jù)資源代碼選填項，數(shù)據(jù)資源唯一不變的標識代碼。4數(shù)據(jù)資源提供方必填項，提供該數(shù)據(jù)資源的單位。5數(shù)據(jù)資源提供方代碼選填項，提供該數(shù)據(jù)資源的單位代碼。6數(shù)據(jù)資源摘要必填項，對數(shù)據(jù)資源內容(或關鍵字段)的概要描述。7數(shù)據(jù)資源格式必填項，對數(shù)據(jù)存在方式的描述。88數(shù)據(jù)資源項信息對結構化數(shù)據(jù)資源的細化描述，包括數(shù)據(jù)項名稱、數(shù)據(jù)類型、數(shù)據(jù)長度。9共享條件必填項，數(shù)據(jù)共享條件分為三類：無條件共享、有條件共享和不予共享。10開放屬性必填項，對數(shù)據(jù)資源向社會開放，以及開放條件的描述，包括是否向社會開放、開放條件。11更新周期必填項，數(shù)據(jù)資源更新的頻度，分為實時、每日、每周、每月、每季度、每年等。屬于結構化數(shù)據(jù)資源的，按更新頻度較快的數(shù)據(jù)項進行描述；屬于非結構化數(shù)據(jù)資源的，則對數(shù)據(jù)資源整體進行描述。12發(fā)布日期必填項，提供方發(fā)布共享數(shù)據(jù)資源的日期，格式為CCYY-MM-DD。13關聯(lián)資源代碼選填項，提供的任一政務信息資源確需在目錄中重復出現(xiàn)時的關聯(lián)性標注，在本元數(shù)據(jù)中標注重復出現(xiàn)的關聯(lián)信息資源代碼。4.2.3數(shù)據(jù)資源目錄編制格式可按照“附錄B數(shù)據(jù)資源目錄示95數(shù)據(jù)交換方式及技術要求5.1一般規(guī)定5.1.1數(shù)據(jù)提供者宜通過接口服務開發(fā)主動推送數(shù)據(jù)到數(shù)據(jù)交換平臺的數(shù)據(jù)推送交換方式，條件不具備的也可采用將業(yè)務系統(tǒng)數(shù)據(jù)直接注冊到數(shù)據(jù)交換平臺由數(shù)據(jù)交換平臺直接抓取業(yè)務系統(tǒng)數(shù)據(jù)的數(shù)據(jù)抓取交換方式。5.1.2數(shù)據(jù)推送交換方式應符合以下規(guī)定：1數(shù)據(jù)提供者應將業(yè)務系統(tǒng)數(shù)據(jù)資源推送到前置服務系統(tǒng)，再通過前置服務系統(tǒng)將數(shù)據(jù)注冊或上傳到數(shù)據(jù)交換平臺；2數(shù)據(jù)使用者宜根據(jù)需要搭建前置服務系統(tǒng)，接收存儲數(shù)據(jù)交換平臺推送的數(shù)據(jù)。5.1.3數(shù)據(jù)抓取交換方式應符合以下規(guī)定：1數(shù)據(jù)提供者應將在線運行的業(yè)務系統(tǒng)數(shù)據(jù)資源直接注冊到數(shù)據(jù)交換平臺；2數(shù)據(jù)提供者應確保業(yè)務系統(tǒng)與數(shù)據(jù)交換平臺間的網(wǎng)絡連通3數(shù)據(jù)使用者宜利用數(shù)據(jù)交換平臺提供的服務接口使用數(shù)據(jù)。5.2數(shù)據(jù)交換技術要求5.2.1數(shù)據(jù)交換技術宜支持數(shù)據(jù)庫交換、數(shù)據(jù)接口交換、數(shù)據(jù)文件交換。5.2.2數(shù)據(jù)庫交換技術應符合以下規(guī)定：1數(shù)據(jù)提供者應將數(shù)據(jù)庫注冊到數(shù)據(jù)交換平臺實現(xiàn)數(shù)據(jù)共享；2數(shù)據(jù)庫宜支持主流關系型數(shù)據(jù)庫；3宜支持非關系型主流商業(yè)、開源大數(shù)據(jù)平臺；4數(shù)據(jù)提供者應提供數(shù)據(jù)庫類型、數(shù)據(jù)庫連接信息、用戶信息；5數(shù)據(jù)提供者應確保共享的數(shù)據(jù)表、數(shù)據(jù)字段并與數(shù)據(jù)資源目錄中數(shù)據(jù)資源、數(shù)據(jù)項一致；6數(shù)據(jù)提供者提供的數(shù)據(jù)類型應支持在主流數(shù)據(jù)庫之間進行數(shù)據(jù)類型的轉換。5.2.3數(shù)據(jù)接口交換技術應符合以下規(guī)定：1數(shù)據(jù)提供者應將數(shù)據(jù)接口注冊到數(shù)據(jù)交換平臺實現(xiàn)數(shù)據(jù)共享，數(shù)據(jù)交換平臺應兼容主流接口類型；2應支持WebService、Http、Rest等多種類型服務接口；3宜支持OGC、ArcGIS等主流地理信息數(shù)據(jù)接口；4數(shù)據(jù)提供者應注冊數(shù)據(jù)接口地址；5數(shù)據(jù)提供者應發(fā)布接口使用說明；6數(shù)據(jù)提供者應建立接口返回值與數(shù)據(jù)資源目錄中數(shù)據(jù)項的對應關系。5.2.4數(shù)據(jù)文件交換技術應符合以下規(guī)定：1數(shù)據(jù)提供者應將數(shù)據(jù)文件上傳至數(shù)據(jù)交換平臺或提供方式供數(shù)據(jù)交換平臺抓取實現(xiàn)數(shù)據(jù)共享；2應支持建筑圖紙及BIM類格式的文件類型：dwg、dws、3應支持電子公文類格式的文件類型：ofd、wps、xml、txt、4應支持電子表格類格式的文件類型：et、xls、xlsx等；5應支持數(shù)據(jù)庫類格式的文件類型：符合常用數(shù)據(jù)庫格式，如Access,Sybase、Oracle,SQLServer、DB2、DM、KingbaseES等數(shù)據(jù)庫系統(tǒng)。同時應明確具體的數(shù)據(jù)庫表結構定義(可細化至“數(shù)據(jù)資源項信息”元數(shù)據(jù)中);6應支持圖形圖像類格式的文件類型：jpg、gif、bmp、png、tiff等；7應支持流媒體類格式的文件類型：swf、m、mpg、mp4等；8應支持地理信息類：shp、gdb、mdb、sdb等；9宜支持其它更多非結構化數(shù)據(jù)文件；10數(shù)據(jù)提供者應建立數(shù)據(jù)文件與數(shù)據(jù)資源目錄中數(shù)據(jù)資源的對應關系。5.3數(shù)據(jù)傳輸技術要求5.3.1數(shù)據(jù)傳輸協(xié)議應支持HTTP/HTTPS傳輸，支持消息傳輸與文件傳輸。5.3.2數(shù)據(jù)傳輸消息基礎協(xié)議應支持國家政務信息資源交換體系標準規(guī)定的消息格式。5.3.3數(shù)據(jù)傳輸消息路由應包括基于消息內容的路由和基于消息頭的路由。5.3.4數(shù)據(jù)傳輸消息交換模式應支持消息主動推送、請求/應答、訂閱/發(fā)布三種消息交換模式。5.3.5數(shù)據(jù)傳輸應具有可靠傳輸保障機制，宜通過斷點續(xù)傳、消息確認和消息重發(fā)機制實現(xiàn)傳輸異常情況下數(shù)據(jù)交換“不丟、不5.3.6數(shù)據(jù)傳輸應支持大文件傳輸。6數(shù)據(jù)交換安全規(guī)范6.1一般規(guī)定6.1.1數(shù)據(jù)交換平臺應提供對數(shù)據(jù)交換過程中數(shù)據(jù)安全保護措施。6.1.2數(shù)據(jù)提供者應提供數(shù)據(jù)在進入交換流程前的數(shù)據(jù)安全保護措施。6.1.3數(shù)據(jù)使用者應提供數(shù)據(jù)交換后應用過程中的數(shù)據(jù)安全保護措施，在獲得數(shù)據(jù)后，不得對外傳播、拷貝數(shù)據(jù)造成數(shù)據(jù)泄露、外傳。6.1.4數(shù)據(jù)在網(wǎng)絡傳輸過程中宜采用國產(chǎn)密碼算法或措施防篡6.2共享數(shù)據(jù)權限管理6.2.1數(shù)據(jù)應按照無條件共享、有條件共享和不予共享進行共享數(shù)據(jù)權限管理，嚴禁將不予共享的數(shù)據(jù)納入共享交換平臺進行數(shù)據(jù)共享交換。6.2.2無條件共享數(shù)據(jù)應對所有用戶開放。6.2.3有條件共享數(shù)據(jù)應提供共享條件并應設置權限控制只對符合條件用戶開放。6.2.4用戶申請有條件共享數(shù)據(jù)時，應提出明確的應用需求、使用場景、支撐文件等，由數(shù)據(jù)提供者審核通過后方可使用。6.3數(shù)據(jù)接口使用權限認證6.3.1數(shù)據(jù)交換平臺應能對接口使用鑒權確認使用者身份，確保接口服務的合法調用。6.3.2數(shù)據(jù)交換平臺應記錄數(shù)據(jù)使用者信息、使用時間、使用痕跡等信息。6.4前置機安全管理6.4.1數(shù)據(jù)提供者和數(shù)據(jù)使用者應采取安全措施確保前置機的系統(tǒng)安全。6.4.2前置機服務系統(tǒng)應記錄每次交換的數(shù)據(jù)資源、時間、數(shù)量等信息，并定期與數(shù)據(jù)使用者進行核對。7數(shù)據(jù)接口服務規(guī)范7.1.1數(shù)據(jù)接口服務應包括權限管理、資源目錄、數(shù)據(jù)內容等接7.1.2數(shù)據(jù)提供者和數(shù)據(jù)使用者應遵循本接口服務規(guī)范提供或者使用數(shù)據(jù)。7.2權限管理接口7.2.1權限管理接口應根據(jù)用戶名和密碼生成token驗證數(shù)據(jù)使用者和提供者權限。token生成算法中應增加token有效時7.2.2權限管理接口定義應符合以下規(guī)定：1接口描述：通過用戶名密碼獲取用戶認證令牌(token);7.2.3權限管理接口消息定義應符合以下規(guī)定：1getToken請求參數(shù)應符合表7.2.3-1規(guī)定；字段名約束類型長度說明userName必選String用戶名(由重慶市住房和城鄉(xiāng)建設委員會平臺統(tǒng)一分配，每個區(qū)縣設一名平臺用戶帳戶)passWord必選String密碼(由重慶市住房和城鄉(xiāng)建設委員會平臺統(tǒng)一分配，每個區(qū)縣設一名平臺用戶帳戶)2getToken返回參數(shù)應符合表7.2.3-2規(guī)定；表7.2.3-2getToken返回參數(shù)字段名說明3getToken調用代碼可按照“附錄A示例代碼”。7.3資源目錄接口7.3.1目錄接口Schema定義應符合以下規(guī)定：1目錄分類信息Schema應符合表7.3.1-1規(guī)定；字段名說明父級目錄分類catalogId,頂層目是否有為父級目錄分類(true代表有子目錄沒有子目錄分類)2數(shù)據(jù)資源信息Schema應符合表7.3.1-2規(guī)定；字段名說明數(shù)據(jù)資源代碼(信息資源的名稱拼音首字母)字段名說明發(fā)布日期(如；2018-04-02)3數(shù)據(jù)項信息Schema應符合表7.3.1-3規(guī)定。字段名說明7.3.2目錄分類列表接口應實現(xiàn)通過token獲取所有目錄分類列表。7.3.3目錄分類列表接口定義應符合以下規(guī)定：1接口描述：通過token獲取所有目錄分類列表；3調用方式：POST、GET;4支持協(xié)議：SOAP、REST;5數(shù)據(jù)格式：JSON、XML。7.3.4目錄分類列表接口消息定義應符合以下規(guī)定：1findCatalogList請求參數(shù)應符合表7.3.4-1規(guī)定；字段名說明2findCatalogList返回參數(shù)應符合表7.3.4-2規(guī)定；表7,3.4-2findCatal字段名說明catalog_schemaList<catalog>3findCatalogList調用代碼可按照“附錄A示例代碼”。7.3.5目錄分類對應信息資源列表接口應通過目錄分類id獲取當前目錄分類下所有信息資源列表。7.3.6目錄分類對應信息資源列表接口定義應符合以下規(guī)定：1接口描述：通過目錄分類id獲取當前目錄分類下所有信息資源列表；2接口定義：/interface/findDataItemByCatalogId.do;4支持協(xié)議：SOAP、REST;7.3.7目錄分類對應信息資源列表接口消息定義應符合以下規(guī)定：1findDataItemByCatalogId請求參數(shù)應符合表7.3.7-1規(guī)定；字段名約束類型長度說明token必選String授權令牌catalogId必選String目錄分類id2findDataItemByCatalogId返回參數(shù)應符合表7.3.7-2規(guī)定；字段名說明3findDataItemByCatalogId調用代碼可按照“附錄A示例7.3.8信息資源下數(shù)據(jù)項列表接口應根據(jù)信息資源id查詢信息資源詳情及數(shù)據(jù)項列表。7.3.9信息資源下數(shù)據(jù)項列表接口定義應符合以下規(guī)定：1接口描述：根據(jù)信息資源id查詢信息資源詳情及數(shù)據(jù)項列表；2接口定義：/interface/getDataitemInfo;3調用方式：POST、GET;4支持協(xié)議：SOAP、REST;5數(shù)據(jù)格式：JSON、XML。7.3.10信息資源下數(shù)據(jù)項列表接口消息定義應符合以下規(guī)定：1getDataitemInfo請求參數(shù)應符合表7.3.10-1規(guī)定；字段名說明2getDataitemInfo返回參數(shù)應符合表7.3.10-2規(guī)定；字段名說明3getDataitemInfo調用代碼可按照“附錄A示例代碼”。7.4數(shù)據(jù)內容接口7.4.1數(shù)據(jù)內容查詢接口應實現(xiàn)通過調用接口方式查詢數(shù)據(jù)7.4.2數(shù)據(jù)內容查詢接口定義應符合以下規(guī)定：1接口描述：通過調用接口方式查詢數(shù)據(jù)內容；7.4.3數(shù)據(jù)內容查詢接口消息定義應符合以下規(guī)定：1getData請求參數(shù)應符合表7.4.3-1規(guī)定；參數(shù)名是是是數(shù)據(jù)查詢條件，Json字符串無條件傳空字符串2search可根據(jù)不同數(shù)據(jù)資源所含數(shù)據(jù)項不同，參數(shù)有所不同?？筛鶕?jù)字段支持的查詢運算符進行查詢，支持簡單查詢、組合查詢。其中，查詢邏輯運算符應符合表7.4.3-2規(guī)定；邏輯運算符描述0q等于neq不等于大于gte大于等于小于小于等于模糊匹配(LIKE操作，支持通配符)包含(IN操作)為空舉例：{"xm,isNull";""}isNotNul不為空舉例：{"xm,isNotNull":""}3連接運算符應符合表7.4.3-3規(guī)定；20且或4getData返回參數(shù)根據(jù)請求的數(shù)據(jù)資源類不同有所不同，其數(shù)據(jù)結構與資源目錄中數(shù)據(jù)類結構一致；5getData調用代碼可按照“附錄A示例代碼”。21附錄A示例代碼A.0.1獲取用戶認證令牌接口請求參數(shù)示例。"userName":"jsxxzx","password":"cxjwjsXxzx123456'A.0.2獲取用戶認證令牌接口返回參數(shù)示例。"code":"20000""message":"處理成功","data":"mFUXd7sIhQx47QyhfQ"A.0.3查詢目錄分類列表接口請求參數(shù)示例。"token":"mFUXd7sIhQx47QyhfQA.0.4查詢目錄分類列表接口返回參數(shù)示例。"code":"20000",ilmessage":"處理成功","data":"["isParent":false,"children":nul,"description":"","itemOrder":0,"name":"市內勘察設計企業(yè)","superId":"""isParent":true,"children":["isParent":false,"children":hull,"catalogId":"1222""code":"cstjml","description":8888""itemOrder":01,"hamne":"安管人員","superId":"1162""catalogId";1162","description":"","itemOrder":0,"hame":"本地工程招標代理機構""superId":""23A.0.5查詢目錄分類對應信息資源列表接口請求參數(shù)示例。"token":"mFUXd7sIhQx47QyhfQ""catalogId":"11244326"A.0.6查詢目錄分類對應信息資源列表接口返回參數(shù)示例。"code":"20000",message":"處理成功","data":[{"catalogId":"11244326","categoryName":hull,"code":"ztmlxdxzycs","dataitemCode":"RES_WZT","dataitemId":"32887271""dataitemSource/1,"dataKind":3,"dataKindDes":null,"dataSource":hull,"dataSourceCode":null,"dataType":307,"description:"市內勘察設計企業(yè)清單""hitFrequency":8,"innerCode":null,"innerOrg":null"name":"市內勘察設計企業(yè)","stanCompDate":null,"shareWay":1,24A.0.7查詢信息資源下數(shù)據(jù)項列表接口請求參數(shù)示例。"token":"mFUXd7sIhQx47QyhfQl"dataitemId":"3222355"A.0.8查詢信息資源下數(shù)據(jù)項列表接口返回參數(shù)示例。"code":"20000","message":"處理成功","data":{"dataItem":{"catalogId":"12223344""categoryName":/hull,"code":"ztjmLxdxzycs","dataitemCode":"RES_WZT","dataitemId":"32887271","dataitemSource":h,"dataKind":3,"dataKindDes":null,"dataSource":"重慶市住房城鄉(xiāng)建委","dataSourceCode":"115000000092768473""dataType":307,"description":"市內勘察設計企業(yè)清單","hitFrequency":8;"innerCode":null,25"name":"市內勘察設計企業(yè)","stanCompDate":null,"shareWay":1,"shareWayType":2"infoItems":["dataitemId":"4584""dataLength%"20","dataName":"企業(yè)名稱""dataType":1,"description";hull,"infoitemId:"45578"openness":-1,opennessCondition":null,"shareKind":1附錄B數(shù)據(jù)資源目錄示例數(shù)據(jù)資源分類數(shù)據(jù)資源名稱(必填項數(shù)據(jù)資源代碼數(shù)據(jù)資源提供方數(shù)據(jù)資源提供方代碼(選填項)數(shù)據(jù)資源摘要(必填項)數(shù)據(jù)資源格式類型數(shù)據(jù)資源項信息共享條件(必填項)開放屬性更新周期(必填項)發(fā)布(必填項)關聯(lián)資源代碼(選填項)數(shù)據(jù)項名稱(必填項)數(shù)據(jù)類型(必填項)數(shù)據(jù)長度(必填項)部門信息資源目錄(示例)市內勘察設計企業(yè)JWo203重慶市住房和城鄉(xiāng)建設委員會察設計企業(yè)xls企業(yè)名稱200無條件共享開放每季度2019年3月30日本標準用詞說明1為便于在執(zhí)行本標準條文時區(qū)別對待，對要求嚴格程度不同的用詞說明如下：1)表示很嚴格，非這樣做不可的用詞：2)表示嚴格，在正常情況下均應這樣做的用詞：3)表示允許稍有選擇，在條件許可時首先應這樣做的用詞：4)表示有選擇，在一定條件下可以這樣做的用詞，采用2條文中指明應按其它有關標準執(zhí)行的寫法為“應按……28引用標準目錄《政務信息資源交換體系第1部分：總體框架》GB/T21062.1《政務信息資源交換體系第2部分：技術要求》GB/T21062.2《政務信息資源交換體系第3部分：數(shù)據(jù)接口規(guī)范》GB/T21062.3《政務信息資源目錄體系第4部分：政務信息資源分類》GB/T21063.4《國家電子政務外網(wǎng)信息安全標準體系框架》GB/T21063.4《國家電子政務外網(wǎng)跨網(wǎng)數(shù)據(jù)安全交換技術規(guī)范》GWO205《城市地理空間信息共享與服務元數(shù)據(jù)標準》CJJ/T144《建筑施工企業(yè)管理基礎數(shù)據(jù)標準JGJ/T204《建筑產(chǎn)品信息系統(tǒng)基礎數(shù)據(jù)規(guī)范》JGJ/T236《城市地理空間框架數(shù)據(jù)標準》CJJ1《城市地理空間信息共享與服務元數(shù)據(jù)標準》CJJ/T144北京市《電子政務總體技術框架》DB117/610江西省《電子政務外網(wǎng)安全接入平臺技術規(guī)范》DB36/T979《重慶市城鄉(xiāng)建設領域基礎數(shù)據(jù)標準》DBJ50/T-196DBJ50/T-311-2019 33 3數(shù)據(jù)交換體系 353.1體系構成 353.2數(shù)據(jù)交換平臺 3.3數(shù)據(jù)交換模式 4數(shù)據(jù)標準及資源目錄 374.1數(shù)據(jù)標準及編碼規(guī)范 4.2數(shù)據(jù)資源目錄 5數(shù)據(jù)交換方式及技術要求 395.1一般規(guī)定 395.2數(shù)據(jù)交換技術要求 395.3數(shù)據(jù)傳輸技術要求 406數(shù)據(jù)交換安全規(guī)范 416.2共享數(shù)據(jù)權限管理 416.3數(shù)據(jù)接口使用權限認證 416.4前置機安全管理 417數(shù)據(jù)接口服務規(guī)范 427.1一般規(guī)定 427.2權限管理接口 427.3資源目錄接口 427.4數(shù)據(jù)內容接口 431.0.1本標準旨在針對城鄉(xiāng)建設領域數(shù)據(jù)來源多、規(guī)模龐大、覆蓋面廣、空間分辨率和時間分辨率細致等行業(yè)特點，通過規(guī)范城鄉(xiāng)建設領域進行數(shù)據(jù)共享和交換時需遵循的數(shù)據(jù)編碼規(guī)范、交換方式、交換安全和接口服務規(guī)范等，切實解決重慶市城鄉(xiāng)建設領域各單位數(shù)據(jù)格式不統(tǒng)一、數(shù)據(jù)交換接口不規(guī)范導致信息難以共享的矛盾，避免數(shù)據(jù)孤島的形成，以指導和促進重慶市城鄉(xiāng)建設領域信息系統(tǒng)的建設。1.0.2本標準適用于城鄉(xiāng)建設領域信息系統(tǒng)數(shù)據(jù)交換，新建系統(tǒng)應遵照此標準開展建設，已有系統(tǒng)可逐步改造遷移符合此標準要求。1.0.3本標準撰寫要求遵循系統(tǒng)性、實用性、可擴展性和科學性的原則，以確保本標準滿足在城鄉(xiāng)建設領域信息化系統(tǒng)建設需求，并能實際的推廣應用。1.0.4-1.0.5本標準是重慶市城鄉(xiāng)建設領域數(shù)據(jù)交換的通用標準，突出了重慶市城鄉(xiāng)建設領域基礎數(shù)據(jù)交換的特點。交換數(shù)據(jù)與城市建設及城市規(guī)劃、管理等工作均有密切關系，因此，在實施過程中除執(zhí)行本標準外，還應符合現(xiàn)行的相關強制性標準。本標準定義的術語，是為了闡明標準中涉及的一些重要概念，為詳細敘述重慶市城鄉(xiāng)建設領域數(shù)據(jù)交換接口標準的內涵和外延，在術語中對“數(shù)據(jù)資源”、“數(shù)據(jù)交換”“數(shù)據(jù)交換體系”和“資源目錄”等概念作了重點描述，目的在于明確對重慶市城鄉(xiāng)領域的數(shù)據(jù)進行交換共享的依據(jù)。3數(shù)據(jù)交換體系3.1體系構成3.1.1數(shù)據(jù)交換是一個系統(tǒng)性工程，在數(shù)據(jù)交換的活動中，涉及到數(shù)據(jù)提供、數(shù)據(jù)使用、數(shù)據(jù)管理者三種角色，信息庫作為數(shù)據(jù)的載體，數(shù)據(jù)交換平臺是數(shù)據(jù)交換的工具，數(shù)據(jù)交換模式是交換的過程。數(shù)據(jù)提供方為數(shù)據(jù)提供者角色，數(shù)據(jù)需求方為數(shù)據(jù)使用者，兩種交換角色可以按照約定的交換模式通過數(shù)據(jù)交換平臺完成數(shù)據(jù)交換，在實際數(shù)據(jù)交換應用的不同場景中可能數(shù)據(jù)提供者和數(shù)據(jù)使用者角色會交替轉換。3.1.5信息庫作為數(shù)據(jù)的載體組織形式，包括數(shù)據(jù)提供者和數(shù)據(jù)使用者為實現(xiàn)信息交換而建立的共享信息庫和前置交換信息庫，數(shù)據(jù)宜包括提供和接收的信息。3.2數(shù)據(jù)交換平臺3.2,1-3.2.2對數(shù)據(jù)交換平臺的建設進行說明，指導各單位確定是否需要建設數(shù)據(jù)交換平臺。對數(shù)據(jù)交換平臺的構成和功能進行說明，數(shù)據(jù)交換平臺應包括數(shù)據(jù)標準及目錄、共享交換服務、前3.3數(shù)據(jù)交換模式3.3.1由于各單位信息發(fā)展水平的差異和信息交換支持的應用需求的差異，在同一個交換區(qū)域內，可能不會是單一的交換模式，而是多種模式的組合。在建設規(guī)劃時，要根據(jù)應用需求特點進行合理布局，充分發(fā)揮兩種交換模式的特點解決特定問題。3.3.2集中式交換模式，信息資源集中存儲于共享數(shù)據(jù)庫，數(shù)據(jù)提供者或使用者通過共享信息庫實現(xiàn)信息資源交換，主要適用于信息共享程度高、信息一致性要求高的基礎共享信息交換。3.3.3分布式交換模式，信息資源分布存儲在各應用業(yè)務信息庫中，信息資源提供者和使用者通過交換節(jié)點提供的交換服務實現(xiàn)兩者之間信息資源定向傳送的交換模式，多用于異構系統(tǒng)互聯(lián)，系統(tǒng)構建靈活，可擴展性好，可以將數(shù)據(jù)提供者和使用者通過不同的通信方式連接，充分保障已有系統(tǒng)的投資，還可以隔離上下層交換服務與上層應用，可以很好的解決信息實時交換、信息適配和信息安全等問題，提高數(shù)據(jù)交換的有效性和可用性。4數(shù)據(jù)標準及資源目錄4.1數(shù)據(jù)標準及編碼規(guī)范4.1.1數(shù)據(jù)標準及編碼規(guī)范是各業(yè)務系統(tǒng)進行數(shù)據(jù)交換的基礎，主要解決數(shù)據(jù)的語義、內涵及指標定義一致等問題。4.1.2為確保對數(shù)據(jù)的語義、內涵一致，避免不同來源對同一數(shù)據(jù)的理解和指標出現(xiàn)歧義，數(shù)據(jù)需要按照統(tǒng)一的標準和編碼規(guī)范，因此應符合《城鄉(xiāng)建設領域基礎數(shù)據(jù)標準》DBJ50/T-312-2019的有關規(guī)定，但考慮到各單位具體業(yè)務的特殊性，基礎數(shù)據(jù)標準中未必能夠包含全部，允許根據(jù)具體業(yè)務在相同的規(guī)則下進行擴展。4.2數(shù)據(jù)資源目錄4.2.1數(shù)據(jù)資源目錄是數(shù)據(jù)提供者共享數(shù)據(jù)的依據(jù)，也是數(shù)據(jù)使用者查找、定位和獲取數(shù)據(jù)資源的入口，主要解決有什么資源、資源的內容是什么、由誰提供、什么時間提供、數(shù)據(jù)從哪里來產(chǎn)生價值。4.2.2為確保數(shù)據(jù)資源目錄的一致性和可用性，數(shù)據(jù)資源目錄按照《重慶市政務信息資源共享開放管理辦法》和國家政務信息資源目錄編制指南的要求，包括數(shù)據(jù)資源分類、數(shù)據(jù)資源名稱、數(shù)據(jù)資源代碼、數(shù)據(jù)資源提供方、數(shù)據(jù)資源提供方代碼、數(shù)據(jù)資源摘期、發(fā)布日期、關聯(lián)資源代碼等。對于數(shù)據(jù)共享，無條件共享應為可提供給所有使用者使用的數(shù)據(jù)資源屬于無條件共享類，有條件共享應為可提供給相關使用者共享使用或者僅能夠部分提供給的數(shù)據(jù)資源屬于有條件共享類，不予共享為不宜提供給其他使用者使用的數(shù)據(jù)資源屬于不予共享類，對于共享和開放屬性，有條件共享和有條件開放，應該說明具體的條件。對數(shù)據(jù)項的名稱、類型、長度等參數(shù)進行說明，數(shù)據(jù)項名稱為必填項，描述結構化信息資源中具體數(shù)據(jù)項的標題，采用中文表示；數(shù)據(jù)類型為必填項，標明該數(shù)據(jù)項的數(shù)據(jù)類型，屬于文本類信息的，應標明所采用的字符集和編碼方式，推薦使用GB13000-2010及其后續(xù)版本字符集和UTF-8方式編碼；數(shù)據(jù)類型為必填項，包括但不限于：字符型C、數(shù)字型N、貨幣型Y、日期型D、時間戳型TS、大文本型T、邏輯型L、整型I、浮點型F、通用