DH1/T2268—2024鄉村振興大數據交換和共享規范2024-06-28發布2024-10-01實施北京市市場監督管理局發布I前言 1范圍 32規范性引用文件 33術語和定義 34數據交換和共享范圍 45交換和共享流程 46元數據屬性 47元數據擴展 58數據交換與共享元數據 69數據交換與共享方法 910數據接口方式及說明 參考文獻 本文件按照GB/T1.1-2020《標準化工作導則第1部分：標準化文件的結構和起草規則》的規定本文件由北京市農業農村局提出并歸口。本文件由北京市農業農村局組織實施。本文件起草單位：北京市農業農村局、北京市數字農業農村促進中心、北京市農林科學院數據科學與農業經濟研究所、北京市標準化研究院。本文件主要起草人：馬榮才、李理、于峰、王永泉、趙翔宇、張軍、羅長壽、陸陽、余軍、欒汝朋、張金軼、張宇、王曉麗、魏清鳳、蘆天罡、劉新、閆濤、曹承忠、鄭亞明、趙瑞芳、平陽、王一罡、薛曉娟、范媛媛、王淼、秦向陽、孟鶴、王富榮、楊蕾、周巧霖。3鄉村振興大數據交換和共享規范1范圍本文件規定了鄉村振興大數據交換和共享范圍、交換和共享流程、元數據屬性、元數據擴展、數據交換與共享元數據、數據交換與共享方法、數據接口方式及說明。本文件適用于北京市鄉村振興大數據交換和共享管理。2規范性引用文件下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T7408.1日期和時間信息交換表示法第1部分：基本原則GB/T13000信息技術通用多八位編碼字符集(UCS)3術語和定義下列術語和定義適用于本文件。元數據ntadata定義和描述其他數據的數據。元數據元素ntaiataelenent元數據的基本單元。元數據實體ntadataentity一組說明信息資源相關特性的元數據元素。數據交換與共享dataexchangeandsharing實現不同地域、不同計算機、不同軟件的用戶獲取或交換非本機數據并進行各種操作、運算和分析的過程。4進行數據傳輸時，數據提供方和接收方需遵守的接口約束或規定。4數據交換和共享范圍鄉村振興大數據交換和共享范圍如下：——鄉村振興數據在農業農村局內部現有相關應用系統的數據交換與共享；——鄉村振興數據與下屬各事業單位相關應用系統之間的數據交換與共享；——鄉村振興數據與農業農村部相關應用系統之間的數據交換與共享；——鄉村振興數據與其他橫向部門信息系統之間為了實現業務協同進行的數據交換與共享。5交換和共享流程鄉村振興大數據交換和共享基本流程見圖1。捉供接7身份9證圖1數據交換和共享基本流程6元數據屬性采用摘要表示的方式定義和描述元數據，摘要內容包括以下9個屬性：a)中文名稱：指元數據元素或元數據實體的中文名稱；b)定義：描述元數據實體或元數據元素的基本內容，給出信息資源某個特性的解釋和說明；c)英文名稱：元數據實體或元素的英文名稱，一般用英文全稱。所有組成詞匯為無縫連寫。元數據元素的首詞匯全部采用小寫字母，其余每個詞匯的首字母采用大寫；元數據實體的每個詞匯的首字母大寫；5d)數據類型：說明元數據元素或元數據實體的數據類型，對元數據元素的有效值域及允許的有效操作進行了規定。例如整型、實型、布爾型、字符串、日期型等；e)值域：規定了元數據元素的有效取值范圍；f)縮寫名：元數據元素或元數據實體的英文縮寫名稱。縮寫規則如下：1)縮寫名在本標準范圍內必須唯一；2)縮寫名不應包括任何空格、破折號、下劃線或分隔符等；3)縮寫名不應使用復數形式的英文單詞，除非該單詞本身就是復數形式，如“Goods”;4)元數據實體縮寫名描述應采用UCC(UpperCamelCase)方式，即每個英文單詞的首字母均大寫；元數據元素縮寫名描述應采用LCC(LowerCamelCase)方式，即除第一個英文單詞外，每個單詞的首字母大寫，并把這些單詞組合起來；5)對存在國際或行業領域慣用英文名稱縮寫的，采用慣用縮寫。g)約束/條件：說明一個元數據元素或元數據實體是否選取的描述符。該描述符分別為：1)M:必選，表明該元數據元素或元數據實體必須選擇。2)0:可選，根據實際應用可以選擇也可以不選的元數據元素或元數據實體。已經定義的可選元數據元素和可選元數據實體，可指導部門元數據標準制定人員充分說明其信息。如果一個可選元數據實體未被使用，則該實體所包含的元素(包括必選元素)也不選用。可選元數據實體可以有必選元素，但只當可選實體被選用時才成為必選。3)C:條件必選，當滿足約束條件中所定義的條件時應選擇。條件必選用于以下三種可能性之一：·當在多個選項中進行選擇時，至少一個選項必選，且必須使用；·當另一個元數據元素已經使用時，選用一個元數據實體或元數據元素；·當另一個元數據元素已經選擇了一個特定值時，選用一個元數據元素。h)最大出現次數：說明元數據元素或元數據實體可以出現的最大實例數目。只出現一次的用“1”表示，多次重復出現的用“N”表示。允許不為1的固定出現次數用相應的整型數值表示，例如i)備注：可根據需要對元數據元素或實體進一步補充說明。7元數據擴展7.1元數據擴展的原則7.1.1選取元數據應考慮數據資源單位的數據資源特點以及工作的復雜、難易程度，應充分滿足鄉村振興大數據的利用以及用戶查詢、提取數據的需要。7.1.2選取的元數據應滿足鄉村振興大數據標準化需求，并考慮未來可能產生的標準化需求。擴展過程中，可參考國內和國外先進標準。7.1.3新建的元數據不應與第6章定義的元數據中現有的元數據實體、元素、代碼表的名稱、定義相沖突。7.1.4增加的元數據元素應按照第6章所確定的層次關系進行合理組織。如果第6章現有的元數據實體無法滿足新增元數據的需要時，可以新建元數據實體。7.1.5新建的元數據實體可包含現有的和新建的元數據元素作為其組成部分。7.1.6可用代碼表替代值域為自由文本的現有元數據元素的值域。7.1.7可增加現有代碼表中值的數量，擴充后的代碼表應與擴充前的代碼表在邏輯上保持一致。7.1.8可對現有的元數據元素的值域進行縮小。67.1.9可對現有的元數據的可選性和最大出現次數施以更嚴格的限制。7.2元數據擴展的類型信息資源在不同行業、不同地區應用時，需要在應用中對本文件規定的元數據進行補充。擴展的類a)擴展元數據元素的值域；b)增加新的元數據元素；c)增加新的元數據實體類型；d)對已有的元數據元素施加更嚴格的限定；e)對已有元數據元素值域施加更多的限定；f)創建新的元數據代碼表元素(擴展代碼表)。7.3元數據擴展的實施7.31在擴展元數據之前，應查閱第6章中現有的元數據及其屬性，根據實際需求確認是否缺少適用的元數據。7.3.2對于每一個增加的元數據，應按照本標準第6章規定，采用摘要表示方式，定義其中文名稱、英文名稱、數據類型、值域、注解。7.3.3對于新建的代碼表和代碼表元素，應說明代碼表中每個值的名稱、代碼以及定義。7.4元數據擴展的報備當元數據內容不能滿足用戶需求時，將相關的元數據標準文檔上報審核。審核通過后，可按照上述實施方法擴展。8數據交換與共享元數據8.1交換與共享數據名稱定義：縮略交換與共享數據內容的標題數據類型：字符型值域：自由文本注解：必選項；最大出現次數為18.2交換與共享數據代碼定義：交換與共享數據唯一不變的標識代碼數據類型：字符型值域：自由文本注解：可選項；最大出現次數為18.3交換與共享數據來源定義：說明數據交換與共享提供方及其聯系方式的信息7數據類型：復合型注解：必選項；最大出現次數為N8.3.1交換與共享數據提供方定義：提供信息的單位數據類型：字符型值域：自由文本注解：必選項；最大出現次數為18.3.2交換與共享數據提供方聯系方式定義：提供信息的單位聯系方式數據類型：字符型值域：7~18位數字字符(包括聯系人電話號碼，完整的電話包括國際區號、國內長途區號、本地電話號和分機號，之間用“-”分隔。)注解：必選項；最大出現次數為18.4交換與共享數據信息摘要定義：對信息資源內容的概要描述數據類型：字符型值域：自由文本注解：必選項；最大出現次數為18.5交換與共享數據關鍵字定義：用于概況描述數據信息內容的通用詞、形式化詞或短語數據類型：字符型值域：自由文本注解：可選項；最大出現次數為18.6交換與共享數據格式定義：信息資源的存在方式數據類型：字符型值域：電子信息文檔、數據庫格式注解：必選項；最大出現次數為18.7數據類型定義：標明該信息項的數據類型英文名稱：dataType數據類型：字符型8值域：“公開”“秘密”“機密”“絕密”98.11更新周期定義：對信息資源更新的頻率數據類型：字符型值域：自由文本，如：實時、每日、每周、每月、每季、每年等注解：必選項；最大出現次數18.12關聯資源代碼定義：相關聯資源的符合規范標識體系的代碼數據類型：字符型值域：自由文本，如該信息資源同屬于其他資源分類體系，需要標注該資源在其他分類體系中的代碼注解：可選項；最大出現次數N9數據交換與共享方法9.1身份認證接口調用方(客戶端)向接口提供方(服務器)申請接口調用賬號，申請成功后，接口提供方會給接口9.2數據整理對需要共享的數據利用元數據進行定義、標識、表示及允許值等一系列屬性描述，方便數據對象在不同部門、不同系統之間進行流通和流轉，并確保流轉過程中數據標準的一致性。9.3數據安全在鄉村振興大數據共享的過程中應符合相關法律法規的規定，應采取措施保證數據的有序安全開放，如根據數據等級對傳輸數據進行加密，防止所開放的數據被泄密或篡改，并可對加密數據進行跟蹤和審計。9.4數據發布數據發布方法如下：a)數據提供方使用元數據定義數據元；b)定義數據獲取接口；c)與共享中心連接；d)身份驗證獲取唯一標識；e)攜帶身份標識，注冊并發布服務接口，完成數據接口注冊共享。數據獲取方法如下：a)與共享中心連接，身份驗證，獲取身份標識；b)攜帶身份標識，能夠查找獲得所需服務接口；c)按接口定義，調用服務，獲取數據；d)數據檢查、對齊后，反饋結果。10數據接口方式及說明10.1接口描述規范10.1.1接口描述規則接口服務描述是業務服務的集中描述，包含其提供的功能以及如何進行調用；是在系統發布的服務提供方和服務調用方之間的規約。接口服務描述應包含對各個方面的人員有意義并可理解的信息，接口服務描述應包含概要和詳細服務信息，使用平臺/技術實現無關的語言進行描述應以業務為導向。10.1.21接口服務屬性接口服務屬性是業務接口服務的描述，它提供組織和性能相關要求，是接口服務提供方和接口服務消費方之間服務協議的依據。定義一個接口服務應該包含的屬性如下：——服務編碼(必選):能體現出接口服務的業務含義的唯一識別編碼，應遵循統一的編碼規——接口服務中文名稱(必選):能體現接口服務的意義，簡單概括，應少于30個漢字；——接口服務描述(必選):清晰描述接口服務的業務功能；——服務提供方(必選):提供此接口服務的業務系統；——服務消費方(可選):可能會使用到此接口服務的業務系統；——服務等級(必選):分為緊急、普通和低級；——報文文件名：指請求報文文件名和響應報文文件名；——數據量(必選):運行期間單次訪問的數據量均值和范圍，比如均值為200K,范圍為100K-——運行效率(可選):單次訪問的響應時間均值和范圍；——支持并發(可選):此接口可支持的并發訪問量；——是否可重(可選):接口是否能被多次重試調用；——超時說明(必選):提供超時時間及其說明。——返回碼說明(必選):業務上需提供返回碼和返回信息給服務消費方；——技術方式(必選):明確此接口的技術方式；——調用說明(必選):提供調用此接口服務的必要條件；——安全要求(必選):描述此接口服務的安全要求；——接口服務調用權限(必選):描述該接口可以被哪些系統調用，即服務的調用權限。10.1.22接口服務規約接口服務規約是接口及參數的技術描述，定義所有綁定和傳輸信息，以及所有支持的操作及相關輸入、輸出的格式等，應以XSD(XMLSchemaDefinition)格式描述；Webservice協議應以WSDL(WebServicesDescriptionLanguage)形式存在。接口服務規約應包括詳細接口服務操作描述、數據類型、消息格式和結構、綁定的傳輸協議和服務的位置。——接口服務應盡可能通用，避免為不同系統開發10.2接口報文規范10.2.2XM報文規范——文件接口：基于超文本傳輸安全協議HTTPS(HypertextTransferProtocolSecure)網絡——API接口：基于HTTPS網絡協議的網絡服務，用于交換主體之間通過調用AP!接口獲取數據10.4.1文件接口文件接口是數據需求方獲得數據授權后由數據服務平臺為其提供的下載端口，通過端口可直接獲取數據文件。文件接口說明包括但不限于：a)文件下載地址：可獲取到數據文件的URL地址，URL一般包括模式或協議、服務器名稱或IP(互聯網協議地址，InternetProtocolAddress)地址、路徑和文件名等；b)文件類型：數據文件的存儲格式說明；c)文件大小：數據文件的數據量描述；d)附加說明：數據文件的其他說明。10.4.21API接口是鄉村振興大數據平臺中數據提供方、數據獲取方分別共享和獲取共享數據集的服務方式。10.4.22接口參數要求如下：a)公共參數公共參數是每個接口都要攜帶的參數，描述每個接口的基本信息，用于統計或其他用途，放在Header或URL參數中。主要參數及說明見表1。表1主要參數及說明說明時間戳時間戳，是客戶端調用接口時對應的當前時間戳，時間戳用于防用戶請求ID,是客戶端隨機生成的值，要保證全局唯一。簽名份、憑證，減少用戶名和密碼的傳輸次數。一般token、timestamp、request_id和sign四個參數會在接口中同時作為參數傳遞，每個參數都有各自的用途，其中首次獲取token需要app_id、timestamp