DB34T 5135-2025農(nóng)業(yè)農(nóng)村信息系統(tǒng)數(shù)據(jù)接口技術(shù)規(guī)范

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