DB21_T+3840—2023.辽宁省冷链食品安全追溯平台数据交换接口规范.pdf
《DB21_T+3840—2023.辽宁省冷链食品安全追溯平台数据交换接口规范.pdf》由会员分享,可在线阅读,更多相关《DB21_T+3840—2023.辽宁省冷链食品安全追溯平台数据交换接口规范.pdf(25页珍藏版)》请在咨信网上搜索。
1、ICS91.140.90CCS Q 7821辽宁省地方标准DB21/T 38402023辽宁省冷链食品安全追溯平台数据交换接口规范Interface standard specification of Liaoning cold chain food safety traceabilityplatform2023-09-30 发布2023-10-30 实施辽宁省市场监督管理局发 布DB21/T 3840-2023I目次前言.1范围.12规范性引用文件.13术语和定义.14数据交换体系.24.1总体框架.24.2数据交换模型.35数据交换类型.45.1数据交换类型分类.45.2文件交换.45.3
2、数据库对接.45.4服务调用.46数据交换模式.46.1数据交换模式分类.46.2数据上报.46.3数据共享.67数据交换审计.108数据交换安全.10附录 A(资料性)数据格式标准.12附录 B(资料性)XML 数据包包头放置数据资源描述信息.20参考文献.22DB21/T 3840-2023II前言本文件按照 GB/T 1.12020标准化工作导则第 1 部分:标准化文件的结构和起草规则给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由辽宁省市场监督管理局提出并归口。本文件起草单位:辽宁省食品安全协会。本文件主要起草人:张效东、洪达文、刘洪旺
3、、刘艳华、赵香华。本文件发布实施后,任何单位和个人如有问题和意见建议,均可以通过来电和来函等方式进行反馈,我们将及时答复并认真处理,根据实际情况依法进行评估及复审。归口管理部门通讯地址:辽宁省市场监督管理局,辽宁省沈阳市皇姑区崇山中路 55 号,联系电话:96315-1-2903。文件起草单位通讯地址:辽宁省食品安全协会,辽宁省沈阳市皇姑区太白山路 110-3 号,联系电话:024-23898046。DB21/T 3840-20231辽宁省冷链食品安全追溯平台数据交换接口规范1范围本文件规定了辽宁省冷链食品安全追溯平台的数据交换体系、数据交换类型、数据交换模式、数据交换审计和数据交换安全。本文
4、件适用于辽宁省冷链食品安全追溯平台数据与相关政府部门在政务外网的数据交换。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 2260中华人民共和国行政区划代码GB/T 4657中央党政机关、人民团体及其他机构代码GB/T 21062.1-2007政务信息资源交换体系第 1 部分:总体框架GB/T 22239-2019信息安全技术网络安全等级保护基本要求3术语和定义下列术语和定义适用于本文件。3.1交换节点exchange node辽宁省
5、冷链食品安全追溯平台下不同的业务系统中实现信息资源传送和处理的系统单元。3.2中心交换节点central exchange node辽宁省冷链食品安全追溯平台,也称省级交换节点。3.3端交换节点end exchange node直接与辽宁省冷链食品安全追溯平台进行信息交换的辽宁省政府数据共享中心、辽宁省新冠肺炎疫情防控指挥部及相关政府部门。3.4DB21/T 3840-20232交换域exchange domain由中心交换节点以及与其直接交换的端交换节点组成,可供“辽宁省冷链食品安全追溯平台”进行信息交换、共享等各类专属业务的交换环境。3.5交换服务exchange service端交换节点
6、和企业平台共享数据信息,或检索“辽宁省冷链食品安全追溯平台”中相关数据信息的服务。4数据交换体系4.1总体框架依据 GB/T 21062.1-2007,在国家电子政务外网公共数据交换平台框架下,本文件规范了辽宁省冷链食品安全追溯平台交换体系总体框架,见图 1。图 1交换体系总体框架图DB21/T 3840-202334.2数据交换模型4.2.1数据交换模型组成与功能辽宁省冷链食品安全追溯数据交换模型由交换信息、交换关系及共享信息库组成。可通过共享信息库进行信息交换,也可通过中心交换节点进行信息交换。4.2.2交换信息交换信息是端交换节点存储的、与“辽宁省冷链食品安全追溯平台”交换的信息资源。4
7、.2.3交换关系辽宁省冷链食品安全追溯平台作为中心交换节点,管理交换域内端交换节点信息交互服务,提供点到点、一点到多点的信息路由和信息可靠传输等功能,并根据需求形成辽宁省冷链食品安全追溯信息基础数据库。各部门系统作为交换域的端交换节点,负责接收、汇聚相关部门的信息,完成业务信息与交换信息转换操作,并通过交换服务实现信息的传送和处理。4.2.4共享信息库共享信息库可以为多个端交换节点提供一致的冷链食品安全追溯信息共享数据。5数据交换类型5.1数据交换类型分类数据交换类型分为文件交换、数据库对接和服务调用。5.2文件交换在数据交换信息中,汉字使用中文半角,英文字母、数字和符号使用英文半角,交换数据
8、应采用 UTF-8编码格式。5.3数据库对接数据提供单位需为每条交换数据记录增加设置两个数据项:记录 ID(GUID)、记录入库时间。其中:记录 ID 为数据记录指纹,由记录原始生成单位赋值,采用 GUID 机制,以标识记录的全局唯一性,是每一条冷链食品安全追溯信息的信息主键。对于文件交换方式,记录入库时间指数据传送文件生成的时间;对于数据库对接方式,记录入库时间指数据加载到端交换节点前置机数据库的时间。5.4服务调用通过 WebService 传递参数,参数按照 XML 数据交换格式定义。6数据交换模式DB21/T 3840-202346.1数据交换模式分类辽宁省冷链食品安全追溯平台数据交换
9、模式分为数据上报和数据共享。6.2数据上报6.2.1数据上报流程数据上报流程包括数据生成、数据传输、数据确认、获取反馈及对账确认等,见图 2。图 2数据上报流程图6.2.2数据生成根据约定的报送周期,数据报送交换节点按本文件要求,将报送信息生成需要传送的数据,见图 2 中。报送数据起始时间、报送周期可在工作细则中约定。当数据报送交换节点为端交换节点、数据接收交换节点为中心交换节点时,初次传输应为数据集全量传输,之后按增量传输。6.2.3数据传输数据报送交换节点通过可靠的数据传送服务,将数据传送到数据接收交换节点,数据传送服务应能支持断点续传,并要求记录传送成功的标志,见图 2 中。6.2.4数
10、据确认当数据接收交换节点接收到数据报送交换节点传送来的数据时,应该就数据的内容(具体内容参见表 1)进行确认,见图 2 中。6.2.5获取反馈DB21/T 3840-20235当数据接收交换节点对接收到的数据进行确认后,按照表 1 内容生成对账数据库表记录,并将记录反馈到数据报送交换节点,见图 2 中。6.2.6对账确认当数据报送交换节点接收到数据接收交换节点传送来的对账数据库表记录时,应该就记录内容(具体内容参见表 1)进行对账确认,如确认无误则数据传输成功,如对账存在出入则数据传输失败,需要重新传输,见图 2 中。6.3数据共享6.3.1共享数据辽宁省冷链食品安全追溯平台生成的数据作为业务
11、部门的共享数据,共享数据见表 1。表 1共享数据字段名称数据类型中文注释说明FILE_NAMEVARCHAR(64)交换文件名称仅用于文件交换方式REV_TIMEDATETIME(16)接收时间FILE_SIZEVARCHAR(16)交换文件大小FILE_NUMNUMBER(16)交换文件数量FILE_TYPEVARCHAR(32)交换文件格式TABLE_NAMEVARCHAR(32)数据库表名称仅用于数据库对接方式INSERT_TIMEDATETIME(16)入库时间DATA_SUMNUMBER(16)入库记录数量SOURCEVARCHAR(16)交换数据来源文件交换方式和数据库对接方式复用
12、FEEDBACK_TIMEDATETIME(16)时间戳6.3.2文件交换6.3.2.1文件交换格式对于结构化数据,应支持三种文件交换格式,分别为 XML 格式、EXCEL 格式、TXT 格式;对于非结构化数据,无交换格式限制;对于压缩文件,采用 ZIP 交换格式,支持国产软件压缩格式。6.3.2.2XML 文件交换格式XML 交换数据文件应符合 XML1.0 规范。声明部分应使用 XML 语言表述,数据包包头放置数据资源描述信息应由数据资源名称、单位代码、单位名称、交换时间、加载标志(全量加载、增量加载)、更新频率、交换数据量、共享范围、主体类别、数据资源描述项(数据包包头)组成,见附录 B
13、.1。DB21/T 3840-20236XML 格式限定文件大小,单个 XML 格式文件不应超过 150M,如超出,需要拆分成多个 XML 文件;采用XML 文件进行文件交换的节点,应提供符合约定的 Schema 文件,以定义交换数据语义上的限制;XML 中共有&、“、这 5 个特殊的字符,当 XML 数据内容中存有这些特殊字符时,需对 XML 文件做特殊处理,将特殊字符按照表 2 中内容转换为转义字符,生成标准 XML 文件。表 2XML 特殊字符与对应的转义字符特殊字符&“转义字符&<>""6.3.2.3EXCEL 文件交换格式6.3.2.3.1交换
14、格式基本要求EXCEL 文件交换格式应满足以下基本要求:1)第一行为数据资源描述信息,包括:数据资源描述项及描述内容,数据资源描述项及描述内容之间的分隔符为“:”,数据资源描述项之间的描述分隔符为“|”;2)第二行为数据项名称;3)第三行开始为数据记录信息;4)EXCEL 数据资源描述信息格式示例见表 3。表 3EXCEL 数据资源描述信息格式示例法人名称统一社会信用代码组织机构代码.记录 ID记录入库时间XXXX 有限公司91370202787560XXXXXX210043-3.337C7F2B-7A34-4F50-9141-BAB9E6478CC820211010125830XXXX 公司
15、91320481755071XXXXXX275833-5.38BDDF48-F43C-4858-8E0D-78761EAA1CE6202110101258406.3.2.3.2遵循的其他约定EXCEL 文件交换格式还应遵循以下约定:1)EXCEL 格式应为 EXCEL2007 及以上版本;2)数据名称信息(列名)只占一行,每个数据项只占一个单元格,禁止合并单元格;3)单个 EXCEL 格式文件不应超过 150M,如超出,应拆分成多个 EXCEL 文件;4)仅支持单 SHEET 页,后续更新数据应与之前保持一致;5)对于 12 位及以上的数字(如身份证号码),应将要输入的单元格设置成文本格式,避
16、免科学计数法的出现。DB21/T 3840-202376.3.2.4TXT 文件交换格式6.3.2.4.1交换格式基本要求TXT 文件交换格式应满足以下基本要求:1)第一行为数据资源描述信息,包括数据资源描述项及描述内容。数据资源描述项及描述内容之间的分隔符为“:”,数据资源描述项之间的描述分隔符为“|”;2)第二行为数据项名称,之间的分隔符为“|”,换行标识符为“rn”,封闭符为“”;3)第三行为数据记录,之间的分隔符为“|”,换行标志符为“rn”,封闭符为“”;4)TXT 数据资源描述信息格式示例如表 4 所示。表 4TXT 数据资源描述信息格式示例SJZYMC:冷库信息|DWDM:080
17、0|DWMC:沈阳关区|JHSJ:20211010|JZBZ:0|GXPL:月|SJL:50|GXFW:1|ZTLB:1法人名称|统一社会信用代码|组织机构代码|.|记录 ID|记录入库时间rnXXXX公司|91370202787560XXXX|XX210043-3|.|337C7F2B-7A34-4F50-9141-BAB9E6478CC8|20211010125830rnXXXX公司|223456789012345678|223456789|.|38BDDF48-F43C-4858-8E0D-78761EAA1CE6|20211010125840rn6.3.2.4.2遵循的其他约定TXT
18、文件交换格式还应遵循以下约定:1)若数据项没有内容时,分隔符“|”不能省略,需保证完整性;2)TXT 格式限定文件大小,单个 TXT 格式文件不超过 150M,如超出,需要拆分成多个 TXT文件;3)若数据中出现分隔符“|”或封闭符“”,应对其进行转义处理,“|”的转义符号为“”,“”的转义符号为“”。6.3.2.5文件名规范信息交换数据文件名应由信用接口类型标识、接入机构名称标识、信息类别标识、数据文件更新时间、数据交换序号等五部分组成,各组成部分之间使用“_”连接,文件后缀为“.XML”、“.TXT”、“.EXCEL”等,如图 3 所示。DB21/T 3840-20238R _ 32000
19、0 _ C0301 _ 20150101 _ 001.XML 第 5 部分 第 4 部分 第 3 部分 第 2 部分 第 1 部分 图 3文件名组成各部分的具体要求如下:1)第 1 部分:接口类型标识由 1 位大写英文字母表示,“R”代表上报数据接口,“S”代表共享数据接口,“M”代表冷链食品安全追溯信息目录及元数据接口,可扩展;2)第 2 部分:当交换节点为部门信息系统时,交换节点机构名称标识由 3 位数字表示,参照 GB/T4657 中央党政机关、人民团体及其他机构代码;3)第 3 部分:信息类别标识由 1 位大写英文字母和 4 位数字表示,“C0301”代表“区域代码”;4)第 4 部分
20、:数据文件生成日期由 8 位数字表示,格式为“yyyymmdd”;5)第 5 部分:数据文件交换序号由 3 位数字表示,由数据提供方生成,为十进制表示的小于 999 的数字,起始值为 001,主要是防止一次交换数据量过大(一次交换数据量不要超过 2G),可由多个文件构成。6.3.2.6文件打包规范文件打包应满足以下要求:1)当交换文件包含有多个 XML、EXCEL 或 TXT 文件时,可以对交换文件进行打包处理,每个压缩文件大小不应超过 2G,交换文件包可由多个压缩文件构成(压缩文件卷号由 3 位数字表示,由数据提供方生成,为十进制表示的小于 999 的数字,起始值为 001);2)压缩文件的
21、命名格式为为“文件名”+“_卷号”+“.ZIP”。6.3.3数据库对接接口数据库对接接口应满足以下要求:1)建前置机数据库:端交换节点在本地前置机上建立相应的源端前置机数据库表;中心交换节点在本地前置机上建立对应的目标端前置机数据库表;2)表资源发布:端交换节点将需要交换的数据库表注册为表资源,并将此表资源进行发布;中心交换节点对数据端交换节点表资源进行资源订阅;3)数据监控:通过监控前置数据库表中数据的变化,包括但不限于时间戳、标识位、触发器方式,触发信息交换;DB21/T 3840-202394)交换策略:数据报送交换节点将需要交换的信息推送到数据报送交换节点的前置机数据库表中,通过数据监
22、控,数据接收交换节点前置机数据库从数据传输交换节点的前置机数据库表中抽取数据到数据接收前置对应库中;5)确认机制:当数据接收交换节点完成了对数据传输交换节点推送数据的获取后,以数据库表的方式就数据的内容(交换文件名称、接收时间、交换文件大小、交换文件数量、交换文件格式、数据库表名称、入库时间、入库记录数量、交换数据来源、时间戳)向数据报送交换节点进行对账确认,如双方确认无误则数据库对接传输数据成功,如双方对账存在出入则数据库对接传输数据失败,需要重新进行数据库对接传输。6.3.4服务方式与服务交换接口6.3.4.1服务方式服务方式实现数据交换,主要是指 WebService 交换方式。以 We
23、bService 方式进行发布,采用 HTTP 通讯协议进行同步通讯,实现数据交换。6.3.4.2服务交换接口服务交换接口应满足以下要求:1)报文规范:报文以 XML 标签形式封装,为报文头和报文体两部分;从交互方式,报文分为请求报文和响应报文两类,即输入和输出,数据对象及字段英文名即为 XML 报文中的标签名;2)报文约定:各字段若无特别说明均为字符型;日期字段默认格式为“yyyymmdd”,例如 2021-04-15,报文内容为 20210415;时间字段默认格式为“hhmmss”,例如 16:25:16,报文内容为 162516;返回包报文头流水号,与请求包报文头流水号保持一致;报文头信
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB21_T+38402023.辽宁省冷链食品安全追溯平台数据交换接口规范 DB21_T 3840 2023. 辽宁省 食品安全 追溯 平台 数据 交换 接口 规范
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【Fis****915】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【Fis****915】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。