34TechnicalspecificationfordatainterfaceofagricultureandruralI本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規則》的規定請注意本文件的某些內容可能涉及專利。本文件的發布機構不承擔識別專利的責任。1農業農村信息系統數據接口技術規范本文件適用于農業農村信息系統相互共享數據時數GB/T37973信息安全技術大數據安全管理GB/T39477信息安全技術政務信息共享數據安全技術要求NY/T3501農業數據共享技術規范DB34/T3473農業大數據信息資源目錄4數據接口模型4.1模型組成4.1.1數據接口模型（ExchangeData）由數據結構（DataStructure）、數據集（DataSet）和附件集（Attachments）組成。數據結構用來描述信息內容的結構信息，數據集用來封裝結構化4.1.2數據結構為必含項，數據集和附件集4.2數據結構4.2.1數據結構由數據標識、數據名稱、農業農村信息資源目錄代碼、說明性注釋、數據項描述、附2數據名稱數據項標識數據結構附件描述類型附件項描述數據項描述4.2.2數據標識(ResourceID),具有唯一性，為必選元素。4.2.3數據名稱(ResourceName),可以采用農業數據的常用名稱，如農村集體經濟4.2.4農業農村信息資源目錄代碼(ResourceDirectoryCode)詳見DB34/T3473文件，為必選元素。4.2.5說明性注釋(ExplanatoryComment),用于對數據進行補充性、提示性說明，為可選元素。4.2.6數據項描述(DataUnitDescription),構成結構化數據的最小單元，一個DataUnitDescription型、數據項定義、數據項備注、最大長度、最小長度、精度8個元素組成：a)數據項標識(DataUnitID),數據項的唯一標識符，為必選元素；b)數據項名稱(DataUnitName),采用業務中慣用的名稱作為數據項名稱，如糧食產量、肉類c)數據類型(DataType),可采用但不限于以下4種：字符型、數值型、日期型、二進制等，d)數據項定義(Definitioe)數據項備注(Comments),為可選元素；f)最大長度(MaximumSize),數據項取值的最大長度，不指定表示沒有最大長度限制，為可選3g)最小長度(MinimumSize),數據項取值的最小長度，不指h)精度(Scale),數值型數據項的精度，即小數點后的位數，不指定表示沒有精度限制，為可i)擴展(Extend)針對農業數據的多樣性及復雜性，預留字段擴展能力，為可選元素；k)附件名稱(AttachmentName),單個附件項的名稱，為必選元素。4.3.1數據集用來封裝結構化數據。數據集由一個或多個數據記錄組成，數據集示意見圖2。數據集類型數據集數據記錄數據項數據項標識符數據項名稱數據項值4.3.2數據記錄(RecordData),組成數據集的基本單元，表示一條記錄，如關系數據庫表的一行或4.3.3數據項(UnitData),組成數據記錄的基本單元，如關系數據庫中表的某個字段或電子表格的某個單元格。數據項由數據項標識符、數據項名稱和數據項值3個元素組成。a)數據項標識符(UnitID),數據項的標識符，與數據結構中的某個數據項對應，為必選元素；b)數據項名稱(UnitDisplayName),數據項的名稱，為必選元素；4.4.1附件集用來封裝非結構化數據，如農村土地承包經營權合同等文本數據、病蟲害識別等圖像數描述、類型描述、附件類型、附件內容6個元素組成，附件集示意見圖3。4附件集類型附件集類型附件標識顯示名稱描述單個附件類型描述附件類型附件內容附件集4.4.4顯示名稱(AttachmentDisplayName),為4.4.6類型描述(TypeDescript5N密NYYAttachmentsY5.3接口返回參數5.3.2接口響應返回參數示例見附錄B，錯NNYYY應符合GB/T37973和GB/T396{"ResourceDirectoryCode":"ZG3"ExplanatoryComment":"該數據為物聯