智慧城市公共信息平臺平臺接口與效勞要求1范圍本要求是《智慧城市公共信息平臺建設指南》建設要求系列之接口與服接口與服接口與效勞要求。本局部要求分兩大部描述平臺接口分兩大部描述平臺接口分兩大部描述平臺接口分兩大部描述平臺接口分兩大部描述平臺接口要求，第一局部：總體，第一局部：總體，第一局部：總體，第一局部：總體要求，總體要求描述消息的總體結構、接口訪問方地址使用說明。第二局部：業務描述消息的總體結構、接口訪問方地址使用說明。第二局部：業務描述消息的總體結構、接口訪問方地址使用說明。第二局部：業務描述消息的總體結構、接口訪問方地址使用說明。第二局部：業務描述消息的總體結構、接口訪問方地址使用說明。第二局部：業務描述消息的總體結構、接口訪問方地址使用說明。第二局部：業務接口要求，具體描述每個業務應用服接口的，具體描述每個業務應用服接口的要求。也就是每一個業務接口。也就是每一個業務接口要求套在總體要求內。只有使用業務接口內。只有使用業務接口內。只有使用業務接口內。只有使用業務接口要求+總體要求才能正常使用信息平臺的應才能正常使用信息平臺的應才能正常使用信息平臺的應才能正常使用信息平臺的應用效勞來發現，查詢管理資源。本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求本局部適用于參與公共信息平臺設計和研發人員，系統維護及要求接入公共信息平臺的外部應用開發人員。智慧城市公共信息平臺-平臺接口與效勞要求22標準性引用文件以下文件中的條款通過本局部引用而成為。但凡注日期以下文件中的條款通過本局部引用而成為。但凡注日期用文件，其隨后用文件，其隨后所有的修改單〔不包括勘誤內容〕或訂版均適用于本局部，所有的修改單〔不包括勘誤內容〕或訂版均適用于本局部，所有的修改單〔不包括勘誤內容〕或訂版均適用于本局部，鼓勵根據本局部達成協議的各方研究是否可使用這些文件最新版。凡不注鼓勵根據本局部達成協議的各方研究是否可使用這些文件最新版。凡不注日期的引用文件，其最新版本適于局部。GB/T21063.1-2007政務信息資源目錄體系第1局部：總體框架；GB/T21063.2-2007政務信息資源目錄體系第2局部：技術要求；GB/T21063.3-2007政務信息資源目錄體系第3局部：核心元數據；GB/T21063.4GB/T21063.4-2007政務信息資源目錄體系第4局部：政務信息資源分類；GB/T21063.5-2007政務信息資源目錄體系第5局部：政務信息資源標識局部：政務信息資源標識符編碼方案；本文<業務接口要求>引用《GB/T21063.2GB/T21063.2-2007》中的附錄A目錄效勞接口；本文<附錄A要求所涉及的結構表所涉及的結構表所涉及的結構表所涉及的結構表>引用《引用《GB/T21063.2GB/T21063.2-2007》中的附》中的附》中的附錄A目錄效勞接口，及引用《目錄效勞接口，及引用《目錄效勞接口，及引用《GB/T21063.2GB/T21063.2-2007》中的附錄》中的附錄C政務信息資源目錄效勞屬性集本文<附錄DQUERYDQUERY-RPN范例>引用《GB/T21063.2GB/T21063.2-2007》中的附錄》中的附錄F檢索串例如9.智慧城市公共信息平臺-平臺接口與效勞要求33術語與定義GB/T19710-2005中規定的與以下術語和義適用于本局部。目錄針對擁有共性的數據資源針對擁有共性的數據資源針對擁有共性的數據資源針對擁有共性的數據資源/文件資源進行分類，并且為該賦予唯一的文件資源進行分類，并且為該賦予唯一的文件資源進行分類，并且為該賦予唯一的文件資源進行分類，并且為該賦予唯一的文件資源進行分類，并且為該賦予唯一的文件資源進行分類，并且為該賦予唯一的文件資源進行分類，并且為該賦予唯一的源標識符，該局部類及描述的集合統稱為資目錄簡。結構化資源公共信息平臺享的二維庫表結構數據，統稱為化資源。非結構化資源公共信息平臺享的非二維庫表結構數據，例如：文本件、視頻網絡訪公共信息平臺享的非二維庫表結構數據，例如：文本件、視頻網絡訪公共信息平臺享的非二維庫表結構數據，例如：文本件、視頻網絡訪公共信息平臺享的非二維庫表結構數據，例如：文本件、視頻網絡訪公共信息平臺享的非二維庫表結構數據，例如：文本件、視頻網絡訪問資源等統稱為非結構化。數據交換管理者管理信息資源結點的機構。交換內容提供者提供信息資源交換內容的機構。交換內容使用者使用信息資源交換內容的機構。前置環境應用單位接入端系統軟硬件及相關網絡環境組成的前置元環境。目錄交換按訂閱模式進行目錄資源數據的交換；橋接系統業務數據庫與共享的橋接器，保持交換數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步數據庫與共享的同步；變更捕捉捕捉數據資源變更情況。數據轉入以固定間隔時輪詢變更登記表，讀取其中的錄并將這些約以固定間隔時輪詢變更登記表，讀取其中的錄并將這些約以固定間隔時輪詢變更登記表，讀取其中的錄并將這些約格式組成XML報文，存儲到共享庫的換出表中；非結構化數據文件直接通過效勞傳輸至交換中心器，并有非結構化數據文件直接通過效勞傳輸至交換中心器，并有智慧城市公共信息平臺-平臺接口與效勞要求4分發非結構化數據文件。數據交換路由以固定時間隔輪詢應用單位換入表，拆解以固定時間隔輪詢應用單位換入表，拆解XML報文，根據目標庫自動分揀報文，根據目標庫自動分揀；非結構化數據文件直接通過效勞傳輸至交換中心器，并有非結構化數據文件直接通過效勞傳輸至交換中心器，并有分發非結構化數據文件。數據轉出獨立運行的進程，以固定間隔時輪詢交換庫中的入表，讀取其以固定間隔時輪詢交換庫中的入表，讀取其XML報文，并將數據按定制的格式同步到共享庫中。非結構化數據文件描述信息存儲在隊列中，由各效勞器根分非結構化數據文件描述信息存儲在隊列中，由各效勞器根分別從中心文件效勞器獲取所需數據。交換管理程序完成數據交換審批流程、監控調度系統管理數據交換審批流程、監控調度系統管理數據交換審批流程、監控調度系統管理數據交換審批流程、監控調度系統管理數據交換審批流程、監控調度系統管理數據交換審批流程、監控調度系統管理數據交換審批流程、監控調度系統管理數據交換審批流程、監控調度系統管理等功能一套等功能一套程序，部署于中心。Web效勞基于webservice技術開放的效勞接口，采用約定的效勞接口，采用約定的XML作為交易數據接口，提供給客戶端調用。WSDLWeb效勞描述文件，一個用來描述一個用來描述Web效勞和說明如何與效勞和說明如何與Web效勞通信的效勞通信的XML語言。為用戶提供詳細的接口說明。訪問認證公共信息平臺提供用戶認證效勞，由托管應系統的客端調于驗公共信息平臺提供用戶認證效勞，由托管應系統的客端調于驗公共信息平臺提供用戶認證效勞，由托管應系統的客端調于驗用戶是否合法；應用單位接入公共信息平臺的機構單位。主管單位公共信息平臺的管理單位。數據中心公共信息平臺的組成局部，是公共信息平臺數據及應用系統存儲的地方。智慧城市公共信息平臺-平臺接口與效勞要求54接口效勞概述4.1接口效勞組成信息資源目錄效勞包含三種接口，即信息資源根底效勞接口、資源效勞接口(發現接口、資源接口)、信息資源管理效勞接口。其中，根底接口是將資源效勞接口和管理接口中根底性的操作定義成一個公共接口。這3類接口實現了信息資源的發現功能、檢索功能和管理功能。根底接口：提供會話管理功能和效勞自描述功能，包含有目錄效勞初始化接口、目錄效勞終止接口和效勞自描述接口。發現接口：提供信息資源元數據檢索功能和信息資源元數據檢索結果提取功能，包含有目錄檢索接口以及目錄檢索結果提取接口。這些接口本身并不提供資源，而是提供資源根本信息和如何去獲得這些資源的元數據。資源接口：根據發現接口獲得信息資源元數據，定位、查找資源具體內容的接口，包含資源內容檢索接口及資源內容結果提取接口。管理接口：提供元數據管理的功能，包含信息資源元數據管理接口。城市公共信息平臺接口效勞組成見圖1.智慧城市公共信息平臺根底接口效勞資源接口效勞管理接口效勞效勞初始化認證授權效勞終止發現效勞資源效勞資源元數據新增效勞資源元數據更新效勞資源元數據刪除效勞資源目錄檢索資源目錄結果提取資源內容檢索資源內容結果提取圖1.城市公共信息平臺接口效勞組成圖智慧城市公共信息平臺-平臺接口與效勞要求64.24.2接口技術要求接口技術要求接口技術要求接口技術要求接口技術要求a)提供基于SOAP協議的web效勞接口b)支持跨語言、操作系統調用智慧城市公共信息平臺-平臺接口與效勞要求75總體要求5.1消息結構每個交易消息每個交易消息(包括請求和應答包括請求和應答包括請求和應答包括請求和應答)有一個是名字〔有一個是名字〔有一個是名字〔有一個是名字〔MessageNameMessageName〕，交易消息〕，交易消息〕，交易消息以XML格式表達的，根據格式表達的，根據XML的定義，每個的定義，每個XML文件需要有特定的RootTagRootTag〔根標記〕，在本標記〕，在本標記〕，在本要求中，用交易名稱中，用交易名稱+請求類別作為根節點，如初始化接口的包請求類別作為根節點，如初始化接口的包根節點為initRequest，而響應包的根節點為，而響應包的根節點為initResponse。根節點下之間放業。根節點下之間放業務接口數據。5.1.1請求報文范例<initRequest><protocolVersion/><idAuthentication/><implementationId/><implementationName/><otherInfo/></initRequest>5.1.2響應報文范例<initResponse><referenceId></referenceId><protocolVersion></protocolVersion><pubKey></pubKey><result></result><otherInfo></otherInfo></initResponse>5.25.2接口方式接口采用WebService方式，接口協議使用SOAP協議，提供標準的WSDL文件。智慧城市公共信息平臺-平臺接口與效勞要求85.35.3接口地址公共信息目錄效勞〔以下簡稱〕主要有三個公共信息目錄效勞〔以下簡稱〕主要有三個公共信息目錄效勞〔以下簡稱〕主要有三個wsdl地址，不同的地址，不同的wsdl下有不同的方法，文說明。這是根據webservice的soap協議開放出來的協議開放出來的wsdl地址，第三方應用可以根據實際的部署效勞器來使它。1)根底接口WSDL文件地址：://<ip地址>:<端口>/es/catalogbase?wsdl目錄效勞初始化–initCatalogService目錄效勞終止–stopCatalogService2)發現接口WSDL文件地址：://<ip地址>:<端口>/es/digcatalog?wsdl目錄檢索–queryCatalogList目錄檢索結果提取–queryCatalogResult3)資源效勞接口：://<ip地址>:<端口>/es/digresource?wsdl資源檢索–getResourceResultset資源檢索結果提取–getResourceResultDetail4)發現接口WSDL文件地址：://<ip地址>:<端口>/es/digcatalog?wsdl資源元數據管理–metadataManage5.45.4使用說明完成資源的檢索與發現需要根據以下步驟來操作：1)第一步：初始化操作。調用根底接口的“目錄效勞初始化”獲得一個會話標識符以后每次調用接口都需要次標識符。2)第二步：查詢公共信息目錄操作。調用發現接口的“目錄檢索”組織好查詢參數，發起交易，獲得查詢結果。注：這里的查詢結果只有返回命中的查詢記錄數。比方：返回值是100，那么表示有100條記錄符合查詢條件，這個時候需要發起“公共信息目錄檢索結果提取”交易才能提取智慧城市公共信息平臺-平臺接口與效勞要求9查詢的結果。如果發回值是0，表示沒有符合查詢條件的記錄。3)第三步：查詢公共信息目錄對應的資源。這里的操作也是和上面一樣，調用“資源檢索”先要查詢下是否有符合查詢條件的資源。有資源記錄的話，然后在調用“資源檢索結果提取”提取符合條件的資源信息。4)第四步：假設調用接口結束后，可調用根底接口里的“目錄效勞終止”來釋放會話標識符資源信息。智慧城市公共信息平臺-平臺接口與效勞要求106業務接口要求6.16.1根底接口要求6.1.1目錄效勞初始化公共信息目錄效勞初始化用于建立客戶端與效勞端的會話，所有其他效勞都必須依賴會話。會話的持續時間為30分鐘，假設會話持續30分鐘沒有活動，那么會話自動終止。本次初始化作用是客戶端認證同時獲取會話標識符，后續發起交易時需要傳遞該會話標識符。1.請求報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion可選StringStringStringStringString50客戶端協議版本號客戶端協議實現的客戶端協議實現的客戶端協議實現的客戶端協議實現的客戶端協議實現的客戶端協議實現的客戶端協議實現的客戶端協議實現的版本號2.idAuthenticationidAuthenticationidAuthenticationidAuthenticationidAuthenticationidAuthenticationidAuthenticationidAuthenticationidAuthentication必選StringStringStringStringString50用戶名用戶名用戶名/密碼認證信息。包含用戶認證信息。包含用戶認證信息。包含用戶認證信息。包含用戶認證信息。包含用戶認證信息。包含用戶身份標識及其密碼。身份標識及其密碼。身份標識及其密碼。身份標識及其密碼。身份標識及其密碼。格式“格式“<用戶名用戶名>/<密碼>”3.implementationIdimplementationIdimplementationIdimplementationIdimplementationIdimplementationIdimplementationIdimplementationIdimplementationId可選StringStringStringStringString50應用標識應用標識在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用戶體系中注冊的第戶體系中注冊的第戶體系中注冊的第戶體系中注冊的第戶體系中注冊的第戶體系中注冊的第戶體系中注冊的第戶體系中注冊的第三方應用編號三方應用編號三方應用編號4.implementationNameimplementationNameimplementationNameimplementationNameimplementationNameimplementationNameimplementationNameimplementationNameimplementationName可選StringStringStringStringString200200200應用名稱應用名稱在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用在公共信息平臺用戶管系統中注冊的戶管系統中注冊的戶管系統中注冊的戶管系統中注冊的戶管系統中注冊的戶管系統中注冊的戶管系統中注冊的戶管系統中注冊的第三方應用名稱第三方應用名稱第三方應用名稱5.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用2.請求報文體模板<initRequest><protocolVersion>V1.0</protocolVersion><idAuthentication>testApp/12456</idAuthentication><implementationId>1</implementationId><implementationName>測試應用</implementationName><otherInfo/></initRequest>3.響應報文體智慧城市公共信息平臺-平臺接口與效勞要求11序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識當驗證成功時返回，否當驗證成功時返回，否當驗證成功時返回，否當驗證成功時返回，否當驗證成功時返回，否那么設置為空那么設置為空2.protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion必選StringStringStringStringString50效勞端協議版本號效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本效勞端協議實現的版本號3.resultresultresult必選BooleanBoolean處理結果處理結果效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明效勞器端用該參數說明是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請是否接受建立會話的請求。truetruetrue表示建立會話成功，falsefalsefalsefalse表示建立會表示建立會話失敗，此時話失敗，此時話失敗，此時話失敗，此時referenceIdreferenceIdreferenceIdreferenceIdreferenceIdreferenceId為空。4.pubKeypubKeypubKeypubKey必選StringStringStringStringString64加解密公鑰加解密公鑰5.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用4.響應報文體模板<initResponse><referenceId>cde2db52-8cee-45f4-9cec-f8a68ebbad5c</referenceId><protocolVersion>V1.0</protocolVersion><pubKey>catalog</pubKey><result>true</result><otherInfo>初始化效勞成功</otherInfo></initResponse>6.1.2目錄效勞終止公共信息目錄效勞終止將結束效勞端與客戶端的會話，與會話相關的資源將被釋放。1.請求報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識要終止的會話編號要終止的會話編號要終止的會話編號要終止的會話編號2.closeReasoncloseReasoncloseReasoncloseReasoncloseReasoncloseReasoncloseReason可選StringStringStringStringString50終止原因終止原因3.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用2.求報文體模板<initRequest><referenceId>cde2db52-8cee-45f4-9cec-f8a68ebbad5c</referenceId>智慧城市公共信息平臺-平臺接口與效勞要求12<closeReason>終止使用</closeReason><otherInfo/></initRequest>6.1.3認證授權認證授權主要是公鑰獲取接口效勞，用于根據客戶端應用的請求，取出最新的加解密公鑰并返回給客戶端的過程。公鑰獲取與其他接口不同，不需要用戶驗證，不需要會話標識。調用客戶端只有獲取公鑰后對用戶認證信息進行加密才能完成其效勞調用。整個密碼加解密的處理過程如以下圖所示：圖2..密碼加解密的處理過程圖1.請求報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息備用2.請求報文體模板智慧城市公共信息平臺-平臺接口與效勞要求13<pubKeyRequest><otherInfo></otherInfo></pubKeyRequest>3.響應報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.pubKeypubKeypubKeypubKey必選StringStringStringStringString8公鑰用于加解密碼的密鑰2.opResultopResultopResultopResult必選elementelement操作結果參見《表參見《表參見《表參見《表A.6A.6A.6opResultopResultopResultopResult屬性表》之屬性表》之屬性表》之說明3.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息備用4.響應報文體模板<pubKeyResponse><pubkey>catalog</pubkey><opResult><opStatus>true</opStatus><opRetCode>code</opRetCode><opRetMsg>message</opRetMsg></opResult><otherInfo></otherInfo></pubKeyResponse>6.26.2發現接口要求6.2.1資源目錄檢索公共信息目錄檢索是效勞端根據客戶端指定的檢索條件，在效勞器端從元數據庫中檢索并標識出匹配的元數據記錄，并將元數據記錄保存在結果集中的過程。結果集的保存時間與會話標識一致，當會話結束后，響應的結果集將被同步刪除。智慧城市公共信息平臺-平臺接口與效勞要求141.請求報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識2.replaceIndicatoreplaceIndicatoreplaceIndicatoreplaceIndicatoreplaceIndicatoreplaceIndicatoreplaceIndicatoreplaceIndicator必選BooleanBoolean結果集覆蓋結果集覆蓋結果集覆蓋結果集覆蓋結果集覆蓋標志truetruetrue表示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查表示覆蓋原來的查詢結果，詢結果，falsefalsefalsefalse表示保存表示保存原來的查詢結果原來的查詢結果原來的查詢結果3.resultSetIDresultSetIDresultSetIDresultSetIDresultSetIDresultSetID必選StringStringStringStringString200200200指定的查詢指定的查詢指定的查詢指定的查詢指定的查詢結果集名稱結果集名稱假設存在同名的結果集，假設存在同名的結果集，假設存在同名的結果集，假設存在同名的結果集，假設存在同名的結果集，需要根據需要根據replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator判斷是判斷是否需要覆蓋結果集。否需要覆蓋結果集。否需要覆蓋結果集。否需要覆蓋結果集。4.databaseNamedatabaseNamedatabaseNamedatabaseNamedatabaseNamedatabaseNamedatabaseNames必選ElementElementElement要查詢的元要查詢的元要查詢的元要查詢的元要查詢的元數據庫名稱數據庫名稱數據庫名稱數據庫名稱數據庫名稱列表客戶端指定的要查詢元數據庫名稱列表元數據庫名稱列表元數據庫名稱列表元數據庫名稱列表5.queryqueryquery必選ElementElementElement客戶端定制客戶端定制客戶端定制客戶端定制客戶端定制的檢索語句的檢索語句檢索語句必須符合檢索語句必須符合檢索語句必須符合檢索語句必須符合TypeType-1型，使用逆波蘭型，使用逆波蘭型，使用逆波蘭型，使用逆波蘭表達式(RPN)(RPN)(RPN)作為檢索語作為檢索語作為檢索語法，參見《附錄法，參見《附錄法，參見《附錄法，參見《附錄EQUERYQUERYQUERY-RPNRPN范例》范例》6.preferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecordSyntaxdSyntaxdSyntaxdSyntaxdSyntax可選StringStringStringStringString10檢索結果的檢索結果的檢索結果的檢索結果的檢索結果的編碼方式編碼方式固定取值固定取值:”XML”:”XML”:”XML”:”XML”:”XML”7.otherInfootherInfootherInfootherInfootherInfootherInfo可選ElementElementElement其他信息其他信息備用2.請求報文體模板<searchRequest><referenceId>f4973365-a9be-4f80-b5d8-a8b9c7949185</referenceId><replaceIndicator>true</replaceIndicator><resultSetID>highResult</resultSetID><databaseNames>BMDB</databaseNames><preferredRecordSyntax>XML</preferredRecordSyntax><query>根據國標的逆波蘭表達式(RPN)組合的查詢條件…具體規那么參考《附錄EQUERYEQUERYEQUERYEQUERY-RPNRPN范例》范例》</query></searchRequest>3.響應報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識智慧城市公共信息平臺-平臺接口與效勞要求152.resultCountresultCountresultCountresultCountresultCountresultCount必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20符合條件符合條件符合條件符合條件的記錄數的記錄數效勞器端執行檢索操作得效勞器端執行檢索操作得效勞器端執行檢索操作得效勞器端執行檢索操作得效勞器端執行檢索操作得到的命中記錄數，檢索失敗到的命中記錄數，檢索失敗到的命中記錄數，檢索失敗到的命中記錄數，檢索失敗到的命中記錄數，檢索失敗到的命中記錄數，檢索失敗到的命中記錄數，檢索失敗設置為設置為03.searchStatussearchStatussearchStatussearchStatussearchStatussearchStatussearchStatussearchStatus必選StringStringStringStringString7執行檢索執行檢索執行檢索執行檢索的執行結的執行結的執行結的執行結果返回的檢索狀態信息，返回的檢索狀態信息，返回的檢索狀態信息，返回的檢索狀態信息，返回的檢索狀態信息，successsuccesssuccesssuccess表示檢索成功，表示檢索成功，表示檢索成功，failturefailturefailturefailturefailture表示檢索失敗表示檢索失敗表示檢索失敗表示檢索失敗4.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用4.響應報文體模板<searchResponse><referenceId>3720b175-7db7-408d-90cd-108e1f2ec887</referenceId><resultCount>9</resultCount><searchStatus>success</searchStatus><otherInfo></otherInfo></searchResponse>6.2.2資源目錄檢索結果提取目錄檢索結果由效勞器端從結果集中提取并返回假設干數據記錄給客戶端。1.請求報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識2.resultSetIDresultSetIDresultSetIDresultSetIDresultSetIDresultSetID必選StringStringStringStringString要抽取的要抽取的要抽取的要抽取的結果集的結果集的結果集的結果集的標識因為系統允許在抽取數據因為系統允許在抽取數據因為系統允許在抽取數據因為系統允許在抽取數據因為系統允許在抽取數據因為系統允許在抽取數據因為系統允許在抽取數據前進行屢次檢索，每前進行屢次檢索，每前進行屢次檢索，每前進行屢次檢索，每前進行屢次檢索，每前進行屢次檢索，每前進行屢次檢索，每索都可以指定不同的結果索都可以指定不同的結果索都可以指定不同的結果索都可以指定不同的結果索都可以指定不同的結果索都可以指定不同的結果索都可以指定不同的結果集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須集名稱，所以客戶端必須指定要抽取的數據結果集指定要抽取的數據結果集指定要抽取的數據結果集指定要抽取的數據結果集指定要抽取的數據結果集指定要抽取的數據結果集指定要抽取的數據結果集標識3.resultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPresultSetStartPointointoint必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20開始抽取開始抽取開始抽取開始抽取的位置客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記客戶端指定的從第幾條記錄開始抽取，序號從錄開始抽取，序號從錄開始抽取，序號從錄開始抽取，序號從1開始4.numberOfReconumberOfReconumberOfReconumberOfReconumberOfReconumberOfReconumberOfRecordsResquestedrdsResquestedrdsResquestedrdsResquestedrdsResquestedrdsResquestedrdsResquested必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20記錄數客戶端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記客戶端指定的要抽取記錄數5.elementSetNaelementSetNaelementSetNaelementSetNaelementSetName必選elementelement結果集屬結果集屬結果集屬結果集屬性參見表《參見表《A.3A.3elementSetNameelementSetNameelementSetNameelementSetNameelementSetNameelementSetNameelementSetName結果集屬性》集屬性》智慧城市公共信息平臺-平臺接口與效勞要求166.preferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecorpreferredRecordSyntaxdSyntaxdSyntaxdSyntaxdSyntax可選StringStringStringStringString10提取結果提取結果提取結果提取結果的編碼方的編碼方的編碼方的編碼方式固定取值固定取值:”XML”:”XML”:”XML”:”XML”:”XML”7.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用2.請求報文體模板<presentRequest><referenceId>f4973365-a9be-4f80-b5d8-a8b9c7949185</referenceId><resultSetID>highResult</resultSetID><resultSetStartPoint>0</resultSetStartPoint><numberOfRecordsResquested>30</numberOfRecordsResquested><elementSetName><genericElementSetName>brief</genericElementSetName></elementSetName><preferredRecordSyntax>XML</preferredRecordSyntax></presentRequest>3.響應報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識2.numberOfRecordnumberOfRecordnumberOfRecordnumberOfRecordnumberOfRecordnumberOfRecordnumberOfRecordnumberOfRecordnumberOfRecordsReturnedsReturnedsReturnedsReturned必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20元數據元數據元數據元數據目效勞器端返回的元數效勞器端返回的元數效勞器端返回的元數效勞器端返回的元數據數目3.presentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatus必選StringStringStringStringString7提取狀態提取狀態效勞器端返回的提取效勞器端返回的提取效勞器端返回的提取效勞器端返回的提取狀態。successsuccesssuccesssuccess表示提表示提取成功，取成功，failturefailturefailturefailturefailture表示提表示提取失敗4.recordsrecordsrecordsrecordsrecords必選elementelement結果集效勞器返回的結果集效勞器返回的結果集效勞器返回的結果集效勞器返回的結果集,包含一個或多包含一個或多包含一個或多singleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecord，詳細描述，詳細描述，詳細描述，詳細描述參見《表參見《表A.5singleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecord參數表》參數表》參數表》5.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用4.響應報文體模板<presentResponse><referenceId>f4973365-a9be-4f80-b5d8-a8b9c7949185</referenceId><numberOfRecordsReturned>9</numberOfRecordsReturned><presentStatus>success</presentStatus><records>結構化資源目錄結構化資源目錄結構化資源目錄結構化資源目錄/非結構化資源目錄非結構化資源目錄非結構化資源目錄非結構化資源目錄</records><otherInfo></otherInfo>智慧城市公共信息平臺-平臺接口與效勞要求17</presentResponse>6.36.3資源效勞接口資源效勞接口資源效勞接口資源效勞接口資源效勞接口要求6.3.1資源內容檢索資源檢索是公共信息平臺效勞端根據客戶端發送的請求信息，從共享數據庫中讀取符合條件的記錄，并將查詢結果集相關返回的過程。注意，資源檢索功能并不返回具體的結果集，結果集返回功能將由”資源檢索結果提取”效勞提供。結果集的保存時間與會話標識一致，當會話結束后，響應的結果集將被同步刪除。1.請求報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識2.resIdresIdresId必選StringStringStringStringString50資源標識符資源標識符6位字母位字母/數字加數字加”/”加1到23位數字位數字3.replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator必選BooleanBoolean結果集覆蓋結果集覆蓋結果集覆蓋結果集覆蓋標志truetruetrue表示覆蓋原來的查詢表示覆蓋原來的查詢表示覆蓋原來的查詢表示覆蓋原來的查詢表示覆蓋原來的查詢結果，falsefalsefalsefalse表示保存原來表示保存原來表示保存原來表示保存原來的查詢結果的查詢結果4.resultSetIDresultSetIDresultSetIDresultSetIDresultSetIDresultSetID必選StringStringStringStringString200200200指定的查詢指定的查詢指定的查詢指定的查詢結果集名稱結果集名稱假設存在同名的結果集，需假設存在同名的結果集，需假設存在同名的結果集，需假設存在同名的結果集，需假設存在同名的結果集，需假設存在同名的結果集，需假設存在同名的結果集，需要根據要根據replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator判斷是否需要覆蓋結果集。斷是否需要覆蓋結果集。斷是否需要覆蓋結果集。斷是否需要覆蓋結果集。斷是否需要覆蓋結果集。5.dataQuerydataQuerydataQuerydataQuerydataQuery必選elementelement客戶端定制客戶端定制客戶端定制客戶端定制的檢索條件的檢索條件參見《附錄參見《附錄參見《附錄CQUERYQUERYQUERY-RESRES-DATADATADATADATA說明》說明》–dataQuerydataQuerydataQuerydataQuerydataQuery屬性說明屬性說明屬性說明6.preferredRecordpreferredRecordpreferredRecordpreferredRecordpreferredRecordpreferredRecordpreferredRecordpreferredRecordpreferredRecordpreferredRecordSyntaxSyntaxSyntaxSyntaxSyntax可選StringStringStringStringString10檢索結果的檢索結果的檢索結果的檢索結果的編碼方式編碼方式固定取值固定取值:”XML”:”XML”:”XML”:”XML”:”XML”7.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用2.請求報文體模板<dataSearchRequest><referenceId>d8137d81-ef76-4dc5-80c7-01dc493f9d3f</referenceId><resId>GXWgxwAA000</resId><resultSetID>GXWgxwAA000</resultSetID><replaceIndicator>true</replaceIndicator>智慧城市公共信息平臺-平臺接口與效勞要求18<preferredRecordSyntax>XML</preferredRecordSyntax><dataQuery>取值參考dataQuery屬性說明</dataQuery></dataSearchRequest>3.響應報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標會話標會話標識2.resultCountresultCountresultCountresultCountresultCountresultCount必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20符合條符合條符合條件的記件的記件的記錄數效勞器端執行檢索操效勞器端執行檢索操效勞器端執行檢索操效勞器端執行檢索操作得到的命中記錄作得到的命中記錄作得到的命中記錄作得到的命中記錄數，檢索失敗設置為數，檢索失敗設置為數，檢索失敗設置為數，檢索失敗設置為03.searchStatussearchStatussearchStatussearchStatussearchStatussearchStatussearchStatussearchStatus必選StringStringStringStringString7執行檢執行檢執行檢索的執索的執索的執行結果返回的檢索狀態信返回的檢索狀態信返回的檢索狀態信返回的檢索狀態信息，successsuccesssuccesssuccess表示檢索表示檢索成功，failturefailturefailturefailturefailture表示檢表示檢索失敗4.opResultopResultopResultopResult可選elementelement操作信操作信操作信息詳情參見附錄詳情參見附錄詳情參見附錄詳情參見附錄詳情參見附錄詳情參見附錄表A.4-opResultopResultopResultopResult屬性表屬性表5.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信其他信其他信息備用4.響應報文體模板<dataSearchResponse><referenceId>d8137d81-ef76-4dc5-80c7-01dc493f9d3f</referenceId><resultCount>0</resultCount><searchStatus>failure</searchStatus><opResult><opStatus>failure</opStatus><opRetCode>錯誤代碼</opRetCode><opRetMsg>錯誤信息</opRetMsg></opResult><otherInfo></otherInfo></dataSearchResponse>6.3.2資源內容檢索結果提取資源檢索結果提取用于從<資源檢索>所得的結果集中提取指定的結果。1.請求報文體智慧城市公共信息平臺-平臺接口與效勞要求19序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識2.resultSetIDresultSetIDresultSetIDresultSetIDresultSetIDresultSetID必選StringStringStringStringString要抽取的要抽取的要抽取的要抽取的結果集的結果集的結果集的結果集的標識因為系統允許在抽因為系統允許在抽因為系統允許在抽因為系統允許在抽因為系統允許在抽因為系統允許在抽因為系統允許在抽因為系統允許在抽取數據前進行屢次取數據前進行屢次取數據前進行屢次取數據前進行屢次取數據前進行屢次取數據前進行屢次取數據前進行屢次取數據前進行屢次檢索，每次都檢索，每次都檢索，每次都檢索，每次都檢索，每次都檢索，每次都檢索，每次都檢索，每次都可以指定不同的結可以指定不同的結可以指定不同的結可以指定不同的結可以指定不同的結可以指定不同的結可以指定不同的結可以指定不同的結果集名稱，所以客果集名稱，所以客果集名稱，所以客果集名稱，所以客果集名稱，所以客果集名稱，所以客果集名稱，所以客果集名稱，所以客戶端必須指定要抽戶端必須指定要抽戶端必須指定要抽戶端必須指定要抽戶端必須指定要抽戶端必須指定要抽戶端必須指定要抽戶端必須指定要抽取的數據結果集標取的數據結果集標取的數據結果集標取的數據結果集標取的數據結果集標取的數據結果集標取的數據結果集標取的數據結果集標識3.resultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPointresultSetStartPoint必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20開始抽取開始抽取開始抽取開始抽取的位置客戶端指定的從第客戶端指定的從第客戶端指定的從第客戶端指定的從第客戶端指定的從第客戶端指定的從第客戶端指定的從第客戶端指定的從第幾條記錄開始抽幾條記錄開始抽幾條記錄開始抽幾條記錄開始抽幾條記錄開始抽幾條記錄開始抽幾條記錄開始抽取，序號從取，序號從取，序號從1開始4.numberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsRenumberOfRecordsResquestedsquestedsquestedsquestedsquested必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20記錄數客戶端指定的要抽客戶端指定的要抽客戶端指定的要抽客戶端指定的要抽客戶端指定的要抽客戶端指定的要抽客戶端指定的要抽客戶端指定的要抽取的記錄數取的記錄數5.numberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTonumberOfRecordsTotaltal必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20符合條件符合條件符合條件符合條件的總共命的總共命的總共命的總共命中記錄數中記錄數資源檢索接口查詢資源檢索接口查詢資源檢索接口查詢資源檢索接口查詢資源檢索接口查詢資源檢索接口查詢資源檢索接口查詢資源檢索接口查詢得到的總共命中記得到的總共命中記得到的總共命中記得到的總共命中記得到的總共命中記得到的總共命中記得到的總共命中記得到的總共命中記錄數。6.preferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntpreferredRecordSyntax可選StringStringStringStringString10提取結果提取結果提取結果提取結果的編碼方的編碼方的編碼方的編碼方式固定取值固定取值:”XML”:”XML”:”XML”:”XML”:”XML”7.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用2.請求報文體模板<dataPresentRequest><referenceId>2190bf83-a934-4f4d-995c-f688dc4808ae</referenceId><resultSetID>JTJQD/JTJ00000</resultSetID><resultSetStartPoint>1</resultSetStartPoint><numberOfRecordsResquested>30</numberOfRecordsResquested><numberOfRecordsTotal>3</numberOfRecordsTotal><preferredRecordSyntax>XML</preferredRecordSyntax></dataPresentRequest>3.響應報文體序號元素名稱元素名稱約束類型長度描述取值說明取值說明1.referenceIdreferenceIdreferenceIdreferenceIdreferenceId必選StringStringStringStringString50會話標識會話標識2.numberOfReconumberOfReconumberOfReconumberOfReconumberOfReconumberOfReconumberOfRecordsReturnedrdsReturnedrdsReturnedrdsReturnedrdsReturnedrdsReturnedrdsReturned必選NumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberStringNumberString20元數據元數據元數據元數據目效勞器端返回的元數據效勞器端返回的元數據效勞器端返回的元數據效勞器端返回的元數據效勞器端返回的元數據目智慧城市公共信息平臺-平臺接口與效勞要求203.presentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatus必選StringStringStringStringString7提取狀態提取狀態效勞器端返回的提取狀效勞器端返回的提取狀效勞器端返回的提取狀效勞器端返回的提取狀效勞器端返回的提取狀態。successsuccesssuccesssuccess表示提取成表示提取成表示提取成功，failturefailturefailturefailturefailture表示提取失敗表示提取失敗表示提取失敗表示提取失敗4.resTyperesTyperesType必選StringStringStringStringString50資源種類資源種類結構化資源或非結構化資源或非結構化資源或非結構化資源或非結構化資源或非源，不同的資種類對應源，不同的資種類對應源，不同的資種類對應源，不同的資種類對應源，不同的資種類對應的singleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecord中ItemItem項不同5.recordsrecordsrecordsrecordsrecords必選elementelement結果集效勞器返回的結果集效勞器返回的結果集效勞器返回的結果集效勞器返回的結果集,包含一個或多含一個或多含一個或多singleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecordsingleRecord，詳細描述參，詳細描述參，詳細描述參，詳細描述參見《B.2B.2資源檢索結果提取資源檢索結果提取資源檢索結果提取資源檢索結果提取資源檢索結果提取結構》6.otherInfootherInfootherInfootherInfootherInfootherInfo可選elementelement其他信息其他信息備用4.響應報文體模板<dataPresentResponse><referenceId>687d0aed-6e43-44eb-9d0e-e25eeca83470</referenceId><numberOfRecordsReturned>3</numberOfRecordsReturned><presentStatus>s</presentStatus><resType>結構化資源</resType><records><singleRecord>….</singleRecord>(具體結構參照)</records><otherInfo></otherInfo></dataPresentResponse>6.46.4管理接口要求6.4.1目錄資源元數據管理目錄資源元數據管理接口包含元數據的新增、刪除和更新操作，根據不同的操作類型來完成相應的動作，且元數據管理接口一次只操作一種操作類型的一條元數據記錄。當操作類型為更新時其操作對象為通過“目錄檢索結果提取”接口返回的元數據，元數據元素必須符合《核心元數據屬性集》要求；當操作類型為刪除時，其操作對象為通過“目錄檢索結果提取”接口返回的元數據中的特定一條記錄；智慧城