LY T 3102-2019 林业有害生物监测预报数据交换规范.pdf
《LY T 3102-2019 林业有害生物监测预报数据交换规范.pdf》由会员分享,可在线阅读,更多相关《LY T 3102-2019 林业有害生物监测预报数据交换规范.pdf(104页珍藏版)》请在麦多课文档分享上搜索。
1、ICS 65.020.99 B 60 LY 中华人民共和国 林业 行业标准 LY/T 3102 2019 林业有害生物监测预报数据交换规范 Data interchange specification for monitoring and forecasting of forest pest (发布稿) 2019 - 10 - 23 发布 2020 - 04 - 01 实施 国家 林业和草原 局 发布 LY/T 3102 2019 I 目 次 前言 . II 1 范围 . 1 2 规范性引用文件 . 1 3 术语、定义和缩略语 . 1 3.1 术语和定义 . 1 3.2 缩略语 . 2 4 监
2、测预报数据 . 2 4.1 监测预报数据说明 . 2 4.2 林业有害生物发生与防治数据 . 3 4.3 林业有害生物国家级中心测报点调查数据 . 3 4.4 林业有害生物应急事件报告报表 . 3 4.5 林业有害生物趋势预报数据 . 3 5 数据交换处理 . 3 5.1 数据交换的参与者 . 3 5.2 交换方式 . 3 5.3 交换模式 . 4 6 数据交换格式 . 4 6.1 数据交换格式说明 . 4 6.2 数据类型 . 4 6.3 消息类型 . 4 6.4 推送数据格式 . 4 6.5 确认推送数据格式 . 5 6.6 请求数据格式 . 5 6.7 反馈请求数据格式 . 6 7 数据
3、交换接口 . 6 7.1 接口调用说明 . 6 7.2 数据接口名称 . 6 8 数据交换安全要求 . 7 附 录 A(规范性附录) 数据交换 JSON格式要求及示例 . 8 附录 B(规范性附录) 消息类型 . 95 附录 C(资料性附录) 错误标识符 . 96 参考文献 . 97 LY/T 3102 2019 II 前 言 本标准按照 GB/T 1.1-2009给出的规则起草。 本标准由 国家林业和草原局 信息中心提出。 本标准由全国林业信息数据标准化技术委员会( SAC/TC 386)归口。 本标准起草单位: 国家林业和草原局 信息中心、 国家林业和草原局森林和草原病虫害防治总站 、北
4、京东蓝数码科技有限公司。 本标准主要起草人:董振辉、 顾红波、 于治军、徐钰、刘广安、韩阳、崔东阳、白莹 、 姜 璠 。 本标准首次发布。 LY/T 3138 2019 1 林业有害生物监测预报数据交换规范 1 范围 本标准规定了林业 有害生物监测预报 数据交换的内容 与格式 。 本标准适用于林业 有害生物发生与防治数据、 国家级中心测报点调查数据 、 应急事件报告报表 及趋 势预报 等 林业 有害生物监测预报 相关数据的交换。 注: 根据实际业务模式,本标准中含 林业 有害生物防治、林业有害生物应急事件 报 告报表 数据。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期
5、的引用文件,仅注日期的版本适用于本文件。 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T 21062.1 政务信息资源交换体系 第 1部分:总体框架 GB/T 2260 中华人民共和国行政区划代码 GB/T 10114 县以下行政区划代码编制规则 GB/T 15775 林业资源分类与代码林木害虫 GB/T 15161 林业资源分类与代码林木病害 LY/T 2022 应施检疫的林业植物产品代码 LY/T 1681 林业有害生物发生及成灾标准 3 术语、定义和缩略语 GB/T 21062.1 2007和 LY/T 1681 2006界 定的术语和定义,以及下列术 语
6、和定义适用于 本 文件 。 3.1 术语和定义 3.1.1 林业有害生物 forest pest 对森林植物有害的任何植物、动物或病原体的种、株(或品系)或生物型。包括害虫、病害、鼠(兔) 害、有害植物。 LY/T 1681 2006, 定义 3.1 3.1.2 林业有害生物发生与防治数据 forest pest occurrence and control data LY/T 3138 2019 2 按照 国家林业 主管部门要求各级林业有害生物防治检疫机构定期报送的林业有害生物发生 与防治 常规性 数据 。 3.1.3 林业有害生物 国家级中心测报点调查数据 forest pest surv
7、ey data of national center station 按照 国家林业 主管部门要求 林业有害生物 国家级中心测报点对指定的林业有害生物 按照相关调查 办法开展 监测并上报调查数据 。 3.1.4 林业有害生物应急事件报告报表 forest pest trend forecast 按照国家应急管理办公室有关要求,各省级林业有害生物防治检疫管理机构对本地区突发灾害 应急 事件情况定期进行报告 。 3.1.5 林业有害生物趋势预报 forest pest trend forecast 根据林业有害生物 的生物学特性结合气象、资源及 监测数据 等信 息 对 其发生发展趋势进行预测 预
8、报 ,一般按 预报 时间分为短期 预报 、中期 预报 、长期 预报 ,按 预报 对象不同分为发生量 预报 、发生期 预 报 、发生范围 预报 等 。 3.1.6 交换 interchange 政务部门间通过 政务信息资源交换体系技术支撑环境实现政务信息资源在线传送的过程 。 GB/T 21062.1 2007, 定义 2.1 3.2 缩略语 HTTP 超文本传输协议( Hypertext Transfer Protocol) HTML 超文本标记语言 ( Hyper Text Mark-up Language) IETF 国际互联网工 程任务组 ( The Internet Engineeri
9、ng Task Force) RFC 由 IETF 发布的一系列备忘录 ( Request For Comments) JSON 一种轻量级的数据交换格式 ( JavaScript Object Notation) UTF-8 一种 Unicode 字符编码 ( 8-bit Unicode Transformation Format) UUID 通用 唯一标识符 ( Universally Unique IDentifier) VPN 虚拟专用网络 ( Virtual Private Network) SSL 安全套接层( Secure Sockets Layer) 4 监测预报数据 LY/T
10、 3138 2019 3 4.1 监测预报数据说明 林业有害生物监测预报数据包括林业有害生物发生与防治数据、国家级中 心 测报点调查数据、应急 事件报告报表和趋势预报数据四类业务数据。 4.2 林业有害生物发生与防治数据 主要包括林业有害生物发生 情况 数据,与发生情况相关联的防治情况、 防治 措施、 防治药剂药械、 人财物统计 等数据, 要求 县 级林业有害生物防治管理机构每月报送 。 4.3 林业有害生物 国家级中心测报点调查数据 主要包括 由 林业 有害生物 国家级中心测报 点 报送的 林业有害生物 虫 情动 态 和短期预报报告、 发 生历 期 报表、 发生 量 调查表等监 测 调查数据
11、及 气象数据 、 国家 级 中心测报点基本情况 等 数据 。 4.4 林业有害生物应急事件报告报表 各个省级 林业有害生物防治管理机构 每周需要对本周所管辖范围内的林区是否发生重大事件进行 报告,如果没有发生病虫害事件则零报送;如果发生病虫害事件,则具体描述事件情况,进行应急报送, 报 送 内容包括事件名称 、 事件 级别 、 事件描述 、 发 生区域 、 有害生物信息、寄主信息、周边区域信息等。 4.5 林业有害生物趋势预报数据 主要 包括 县 级林业有害生物防治管理机构 的 林业有 害生物 发生 期 和 发生量 的 预报 数据 。 5 数据交换处理 5.1 数据交换的参与者 参与数据交换的
12、业务系统通过数据交换将数据写入应用支撑平台或从应用支撑平台读取数据,实现 与 其他 业务系统的数据共享和业务协同。 包括以下参与者: a) 数据交换的发送者 。 负责构造请求数据包,并将请求数据包发送至数据交换平台 ; 负责从数据 交换平台接收响应数据包,并对响应数据包进行处理。 b) 数据交换的接收者 。 负责接收、解析、处理请求数据包,根据处理结果构造响应数据包 , 并将 响应数据包发送至数据交换平台。 c) 数据交换平台 。 负责请求数据包和响应数据包的接收、转换、传递 ,并对数据交 换过程进行 监控和管理。 原则上,请求数据包和响应数据包的构造、业务数据体的解析、 与交换相关的 业务处
13、理由数据交换发送者或接收者完成。 5.2 交换方式 数据交换参与者之间存在两种方式 :同步方式和异步方式。 a) 同步方式 。 同步方式过程为 数据交换发送者构造请求数据包,并发送至数据交换平台;数据交 换平台将请求数据包发送给数据交换接收者进行处理,最终向发送者返回响应数据包。发送者只有接收 到响应数据包或捕获到数据交换异常后才继续往下执行,这种方式适用于数据交换量小、响应时间要求 严格的情况。 LY/T 3138 2019 4 b)异步方式 。 异步方式过程为 数据交 换发送者向数据交换平台发出请求数据包后,继续进行其他 处理,而不是等待响应数据包 ; 数据交换平台负责将请求数据包发送给接
14、收者,或接收者主动从数据交 换平台索取请求数据包 ; 接收者在获得请求数据包后进行处理并构造响应数据包,然后发送至数据交换 平台 ; 数据交换平台负责将响应 数据包发送给发送者,或发送者主动从数据交换平台索取响应数据包 ; 发送者在获得响应数据包后进行处理。这种方式适用于数据交换量比较大且对响应时间要求不十分严格 的情况。 5.3 交换模式 数据交换参与者之间存在两种 模式 : 同 级模式和上下级模式 。 国 家 林业主 管部门 林业有害 生物发生 防治相关业务系统之间数据交换为同级模式 。 国 家 林业主 管部门 林业有害生物发生防治业务系统与省级 系统之间数据交换为上下级模式 。 同级模式
15、时,主动 请求 数据的系统是交换过程的发送者。 上下级 模式 时,下级数据交换 系统 是交换过程的 发送者 。 数据交换 是 数据参与者 之间 对数据 采用 “推 ”和 “拉 ”相结合的方式, 发送者 从 接收者 处 检索属于本 级的数据包, “拉”到本地后再进行 处理 ; 发送者 将需要报送的数据包 “推” 到 接收者 处 。 6 数据交换格式 6.1 数据 交 换 格式说明 交换数据 可以 采用 JSON和 XML格式进行包装 。 本标准中以 JSON数据格式 为例进行 表述 , 数据交换 格 式采用 JSON Schema进行描述和验证 , 数据包 默认采用 UTF-8的编码方式。 6.
16、2 数据类型 数据交换格式中共包括九种数据类型, 具体格式见表 1。 表 1 数据 类型 类型名称 类型 描述 String 任意字符串 数据类型 Null 空数据类型 Integer 整数 数据类型 Number 浮点数 数据类型 Boolean 布尔值数据类型 Object 对象数据类型 Array 数组数据类型 Any 任意数据类型 Union 两个以上的数据类型构成的数组类型 6.3 消息类型 数据交换格式中共包括 二十九种消息类型( mType),每个消息类型 标识符 用三至十一个字符表示。 LY/T 3138 2019 5 消息类型定义见 附录 B。 6.4 推送 数据 格式 推送
17、 数据 格式用于主动向接收 者交换 系统提交数据时使用,具体格式 见表 2。 表 2 推送 数据格式 标识符 名称 数据类型 备注 mVer 发送消息版本号 Integer 必填内容,默认版本号 10000 mKey 消息密钥 String 必填内容, 加密公钥, 由交换平台指定 mType 消息类型 String 必填内容, 见 附录 B 中的消息类型 mMsgID 消息 ID String 必填内容, 消息的唯一标识符( 32 位 UUID) mDatas 数据内容 Any 必填内容, 根据推送消息填写内容,详见附录 A 中的 JSON Schema 描述 mUnitID 单位编码 Str
18、ing 必填内容,由交换平台指定 mUnitCode 单位行政区划 String 必填内容, 最大长度 6,代码参考 GB/T 2260 mTimerFlag 时间戳标志 String 必填内容, yyyy-MM-dd HH:mm:ss 格式字符串 mDelFlag 删除标志 Boolen True 表示删除, False 表示有效 6.5 确认推送 数据 格式 确认 推送 数据格式 用于回应主动提交数据的发送 者交换 系统 , 具体 格式 见 表 3。 表 3 确认推送 数据格式 标识符 名称 数据类型 备注 mVer 确认消息版本号 Integer 必填内容,默认版本号 10000 mMs
19、gID 消息 ID String 必填内容, 推送数据的唯一标识符( 32 位UUID) mReturnCode 消息 标识符 Integer 必填内容( 0:接受 、 1:拒绝 ) mErrorCode 错误 标识符 Integer 必填内容 , 参见 附录 C 中的错误标识符 mErrorMsg 错误描述 String 必填内容, 错误描述内容字符串 6.6 请求 数据 格式 请求数据 格式 用于主动 向 接收者交换 系统 请求需要的数 据 ,具体 格式 见 表 4。 表 4 请求数据格式 标识符 名称 数据类型 备注 LY/T 3138 2019 6 mVer 发送消息版本号 Integ
20、er 必填内容,默认版本号 10000 标识符 名称 数据类型 备注 mKey 消息密钥 String 必填内容, 加密公钥, 由交换 平台指定 mType 消息类型 String 必填内容 , 见 附录 B 中的消息类型 mMsgID 消息 ID String 必填内容, 请求数据的唯一标识符( 32 位UUID) mDatas 数据 内容 Any 必填内容, 根据请求数据查询条件填写内容,详见附录 A 中的 JSON Schema 描述 mPage 分页的页码 Integer 必填内容 mCount 每页的数量 Integer 必填内容, 大于 0, 小于或等于 100 mUnitID 单
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- LY 3102-2019 林业有害生物监测预报数据交换规范 3102 2019 林业 有害生物 监测 预报 数据 交换 规范
