1、ICS 35.240.60 L 67 DB37 山东省地方标准 DB37/T 14352009 法人单位基础信息库 数据交换规范 2009-12-31 发布 2010-01-15 实施 山东省质量技术监督局 发 布 DB37/T 14352009 I 目 次 前 言 .II 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 1 4 缩略语 . 1 5 数据交换总体架构 . 1 5.1 数据交 换技术规范组成内容 . 1 5.2 数据交 换逻辑规范组成 . . 2 5.3 数据交 换体系规范组成 . . 2 5.4 数据交换模式 . . 2 6 数据交换逻辑规范 . 3 6.1
2、数据交 换逻辑层次划分 . . 3 6.2 数据交 换处理流程 . . 3 6.3 法人库 中心接口规范 . . 4 6.3.1 数 据交换接口格式标准 . . 4 6.3.1.1 数据上传接口 . . 5 6.3.1.2 数据下载接口 . . 5 6.3.2 数 据比对接口格式标准 . . 5 6.3.3 数 据应用接口格式标准 . . 5 6.4 参建部 门接口规范 . . 6 6.4.1 适 配器应用接口格式标准 . 6 6.4.1.1 数据类型编码 . . 6 6.4.1.2 API 模式. . 6 6.4.2 适 配服务接口格式标准 . . 7 6.5 应用部 门接口规范 . . 7
3、 7 数据交换体系规范 . 7 7.1 报文格式规范 . . 7 7.1.1 数 据交换报文格式 . . 7 7.1.2 数 据交换报文大小限制 . . 7 7.1.3 数 据交换报文读写控制要求 . 7 7.1.4 数 据交换报文字符集 . . 8 7.1.5 数 据交换报文命名规范 . . 8 7.1.6 XML 文档格式. . 8 7.1.7 SOAP 头结构. . 8 7.1.7.1 子系统类型编码 . . 9 7.1.8 Web 服务结构格式. . 9 7.1.8.1 结构类型编码 . . 10 7.2 安全技术规范 . . 10 DB37/T 14352009 II 7.2.1 数
4、 据交换内容安全性 . . 10 7.2.2 授权机制 . . 10 7.2.3 数 据传输的安全性 . . 11 7.3 标准管理规范 . . 11 7.3.1 系 统版本号标识规范 . . 11 7.3.2 交 换标准版本号标识规范 . 11 7.3.3 错 误编码版本号标识规范 . 12 DB37/T 14352009 II 前 言 本标准由山东省信息化工作领导小组办公室提出。 本规范由山东省信息标准化技术委员会归口。 本规范的起草单位：山东省标准化研究院。 本规范主要起草人：朱瑞虹、李延海、王曙光、孙玉亭、邓祥武、李向东、刘春波、周东超、熊绍 东、张欣、丁又可、孟繁林。 DB37/T
5、14352009 1 法人单位基础信息库数据交换规范 1 范围 本规范定义了法人单位基础信息库数据交换的技术规范， 包含数据交换逻辑规范和数据交换体系规 范。其中逻辑规范包含法人库中心接口规范、参建部门接口规范、应用部门接口规范；体系规范包含报 文格式规范、安全技术规范、标准管理规范。 本规范适用于山东省法人单位基础信息库的信息交换体系的开发者、 建设者和其他与交换体系建设 相关的人员使用。 2 规范性引用文件 下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注明日期的引用文件，其随后所有 的修改单（不包括勘误的内容）或修订版均不适用于本规范。凡是不注日期的引用文件，其最新版本适 用于
6、本规范。 GB 2312 信息交换用汉字编码字符集 基本集 GB/T 18391 信息技术 数据元的规范与标准化 GB/T 7408-2005 数据元和交换格式 信息交换 日期和时间表示法 GB/T 18793-2002 信息技术 可扩展置标语言（XML）1.0 3 术语和定义 下列术语和定义适用于本指导性技术文件。 3.1 法人基础信息 juridical person f undamental information 与法人密切相关的信息，它代表了法人的基本状态与特征，具有跨业务系统共享需求的特性。 3.2 法人基础信息库 base of juridi cal person fundame
7、ntal information 由法人基础信息组成的数据库。 3.3 应用程序接口 application pro gramming interface 一种访问和操作对象的规则，也就是应用系统调用系统功能的接口。 4 缩略语 下列缩略语适用于本标准。 XML Extensible Markup Language 可扩展标识语言 SOAP Simple Object Access Protocol 简单对象访问协议 WSSF Web Service Structure Format Web 服务结构格式 5 数据交换总体架构 5.1 数据交换技术规范组成内容 法人单位基础信息库的数据交换技术
8、规范的内容组成以及相互的关系如图 1 所示。 DB37/T 14352009 2 图 1 法人单位基础信息库的数据交换技术规范的内容组成以及相互的关系 如图 1 所示，整个数据交换的技术规范体系的内容由交换逻辑规范和交换体系规范组成。 5.2 数据交换逻辑规范组成 数据交换逻辑规范主要描述了法人库数据交换的交换模式、部署结构、交换节点、数据操作逻辑等 具体内容。同时描述了法人库中心节点、各参与建设部门或各应用部门的各类交换结构格式标准和应用 接口格式标准，这些标准规范了跨部门、跨区域的数据交换实现的接口格式： 法人库中心交换接口规范：描述了法人库中心服务器在数据交换、比对处理以及数据应用多个
9、层面的接口格式标准。 交换接口格式标准规范了中心面向参与建设部门适配服务提供的接口模 式；比对接口格式标准规范了中心处理各部门上传数据的接口模式；应用接口格式标准规范了 中心与各类应用系统在实际中的接口模式。 参与建设部门接口规范：描述了参与建设部门在数据交换及数据应用层面的接口格式标准。 应用部门接口规范：提出在应用层面描述本系统（数据交换系统）与各个应用部门在实际工作 中的接口模式。 5.3 数据交换体系规范组成 数据交换体系规范主要描述了各类法人库数据操作逻辑过程中与交换实现息息相关的各类技术规 范，如数据传输中的报文格式、安全加密以及管理各交换节点等： 报文格式规范：约定各个数据交换节
10、点之间数据传输的业务数据报文格式，包括数据字符集、 数据类型等属性； 安全技术规范：保障数据在交换传输过程中的安全，包括数据的加密机制，传输协议等； 标准管理规范： 描述技术规范在更改数据交换技术规范内容方面的流程以及参与机构的作用和 职责。 5.4 数据交换模式 法人库系统的建设模式采用集中式和分布式相结合的建设模式。 参与建设部门首先将共享数据存储 至本部门前置机上，由 Web 服务自动集中到数据中心，数据中心将比对处理后的数据发送到其它参与 建设部门的前置机。因此，交换模式采用星型交换模式，部门间数据交换通过中心系统进行数据传输。 数据交换主要功能： 部门客户端的适配器提供各部门业务数据
11、与各自前置机服务之间的连接、 转换、 传输和存储功能，并提供对前置机服务的控制管理；部门前置机的适配服务提供对前置机与中心之间共 DB37/T 14352009 3 享数据的转换、传输、存储，并提供给客户端的应用接口；中心服务系统提供共享数据的接收、比对处 理、存储、分发功能，并提供应用接口给应用部门或应用系统。 客户端、前置机与中心服务系统的功能定位如下： 客户端向前置机发送动作主要是将业务数据发送到前置机数据库、前置机数据的统计查询、前 置机服务的管理控制。 前置机向中心系统发送动作主要是将前置机数据发送到中心系统、从中心系统下载更新数据、 本地系统和标准的更新； 中心系统向前置机发送动作
12、主要是返回请求结果、发送更新数据和反馈事实差异数据。 6 数据交换逻辑规范 6.1 数据交换逻辑层次划分 从交换的实现逻辑上数据交换划分为三个层次，即应用层（应用系统） 、及交换层（）和通讯层（网 络） ，如图 2 所示。 图 2 数据交换逻辑规范示意图 在数据交换逻辑规范上，应用层的消息使用 Web服务结构格式封装（ WSSF）后的交换格式作为消 息格式规范，交换层采用序列化（ Serialization）后的 2进制字节流作为消息格式规范。 应用层（各个应用系统）之间、应用层和交换层之间通过 Web 服务结构格式 (WSSF)进行相关信息 的传递。 WSSF 最重要的信息包括返回操作信息和
13、封装在 SOAP 头消息里的用户名、密码、数字证书和 部门信息。返回操作信息主要包括操作编号，如果产生错误，系统调用错误接口格式（ Error Interface Format）来返回错误信息。 SOAP 头消息主要用来验证用户信息，确保数据交换的完整性。 6.2 数据交换处理流程 数据交换过程中，业务数据根据共享数据的范围可以分为共享数据和定向传递数据两种。共享数据 指可以共享给其它所有参与建设部门的业务数据， 定向传递数据指只能共享给指定参与建设部门间的业 务数据。业务数据交换处理过程如图 3 所示。 DB37/T 14352009 4 图 3 数据交换处理流程 在数据交换处理过程各个步骤
14、中，具体的过程和采用的规范如下： 第 1、2、3 步指客户端适配器连接前置机的适配服务，将客户端上的业务数据传输并存储到前 置机数据库中。其中适配器连接适配服务需要符合适配器应用接口格式标准规范。 第 4、5、6 步指前置机的 Windows 服务定时发起数据上传请求，适配服务接收请求后，再向中 心服务发送数据交换请求，将前置机数据库的业务数据传输并存储到法人中心数据库中。其中 Windows 服务调用适配服务需要符合适配服务接口格式标准规范；适配服务调用中心服务需要 符合中心的交换接口格式标准规范。 法人库中心服务器的 Windows 服务定时发起比对校验请求，处理共享数据（定向传递无需处
15、理） 。处理完成的数据可以提供给其它参与建设部门下载，或应用部门或应用系统接口调用。 第 7、8、9 步指前置机的 Windows 服务定时发起数据下载请求，适配服务接收下载请求后，向 中心服务发送数据下载请求，将法人中心数据库的处理后的数据下载并存储到前置机数据库 中。 6.3 法人库中心接口规范 6.3.1 数据交换接口格式标准 交换接口格式标准用于规范中心服务与参建部门数据交换，主要包括数据上传和数据下载两个接 DB37/T 14352009 5 口。 6.3.1.1 数据上传接口 数据上传接口表示规范见表 1 表 1 数据上传接口表示规范 方法名称 UploadData 方法描述 接收
16、适配服务传输的数据内容，存储到法人数据库中 参数名称 参数类型 说明 ExchangeId 交换标准 编号 String 据此查找存储表 输入参数 upData 上传数据 DataSet 上传数据内容 返回类型 XML 输出参数 上传数据是否成功 6.3.1.2 数据下载接口 数据下载接口表示规范见表 2 表 2 数据下载接口表示规范 方法名称 DownData 方法描述 分批次下载参建部门所需的数据， 适配服务定时多次循环调用此接口 完成下载任务。 参数名称 参数类型 说明 ExchangeId 交换标准 编号 String 查找下载数据， 组合查询条 件 ThisPage 当前页 Long
17、 分批次下载， 每页下载的数 量从参数文件获取。 TotalPage 总页数 Long 判断是否继续下载 StartDate 开始日期 String 增量下载的查询依据， 格式 为 ”yyyy-mm-dd hh24:mi:ss” 输入参数 EndDate 截至日期 String 增量下载的查询依据， 格式 为 ”yyyy-mm-dd hh24:mi:ss” 返回类型 XML 输出参数 下载数据内容 6.3.2 数据比对接口格式标准 比对接口格式标准用于规范中心服务与校验比对。数据比对接口表示规范见表 3. 表 3 数据比对接口表示规范 接口名称 Contrastdata 方法描述 根据比对标准
18、逐个比对各参建部门上传的共享信息， 如果出现事实差 异数据，存储到反馈信息中，供各参建部门使用。 参数名称 参数类型 说明 CompareId 比对标准 编号 String 根据比对标准， 查找并比对 校验数据。 输入参数 CompareDate 比对日 期 String 记录校验比对的日期， 格式 为 ”yyyy-mm-dd hh24:mi:ss” 返回类型 XML 输出参数 事实差异数据 6.3.3 数据应用接口格式标准 应用接口格式标准用于规范中心服务与 Web 网站法人信息查询。数据应用接口表示规范见表 4. DB37/T 14352009 6 表 4 数据应用接口表示规范 接口名称
19、QueryData 方法描述 通过机构代码、机构名称查询法人信息。 参数名称 参数类型 说明 OrgCode 机构代码 String 根据机构代码， 获取法人信 息，精确匹配 输入参数 OrgName 机构名称 String 根据机构名称， 获取法人信 息，模糊匹配 返回类型 XML 输出参数 下载数据内容 6.4 参建部门接口规范 6.4.1 适配器应用接口格式标准 适配器应用接口格式标准指适配器与业务数据连接的接口模式，主要为提供针对于数据库类型的 API 模式。 6.4.1.1 数据类型编码 数据类型编码表示规范见表 5 表 5 数据类型编码表示规范 序号 代码 描述 1 Oracle
20、Oracle9i 数据库 2 MSSQLServer SQLServer2000 数据库 3 MySQL MySQL5.0 数据库 4 TXT Text 数据文件 5 XLS Excel 数据文件 6 XML XML 数据文件 7 DBF dBase5 数据文件 6.4.1.2 API 模式 当业务数据为数据库类型时，为使交换系统与部门业务数据无缝结合，提高传输效率，需要调用数 据库的 API 进行数据交换操作。 API 模式发送和接收的接口规范见表 6。 表 6 API 接口规范 发送接口 CDBConn.cs 构造函数 名称 类型 说明 ConnStr String 数据库连接字符串 DB
21、Type String 数据库类型 方法 名称 参数类型 返回类型 说明 Connection IDbConnection 得到数据库连接 Open String 打开数据库 IsOpen Boolean 判断是否打开数据库 Close Void 关闭数据库，但不清除 Dispose Void 清除数据库连接对象， 释放资源 Instance String 数据库连接 字符串 String 数据库类型 CDBConn 用指定的连接字串创建 DBConn 实例 ExecuteNonQuery string Sql 语句 DataSet 通过语句查询获取对象 DB37/T 14352009 7 6
22、.4.2 适配服务接口格式标准 适配服务接口格式标准用于规范适配器与适配服务之间的接口。适配服务接口表示规范见表 7 表 7 适配服务接口表示规范 方法名称 Setupload data 方法描述 接收适配器传输的数据内容，存储到前置机数据库中 参数名称 参数类型 说明 ExchangeId 交换标准 编号 String 据此查找存储表 upData 上传数据 DataSet 上传数据内容 输入参数 userID String 用户内部标识 返回类型 XML 输出参数 存储数据是否成功 6.5 应用部门接口规范 应用部门接口规范指法人库中心服务提供给应用部门查询法人信息的接口规范，接口主要包含
23、两 个：通过机构代码查询法人信息和通过组织机构实名邮箱查询法人信息。 应用部门接口表示规范见表 8 表 8 应用部门接口规范 名称 参数类型 返回 说明 GetCorpInfo String 用户名 String 密码 String 数字证书 String 机构代码 XML 通过机构代码查询获取 法人信息 GetCorpInfo String 用户名 String 密码 String 机构代码 XML 重载上个方法，因为没 有数字证书，暂时使用 GetCorpInfoByEmail String 用户名 String 密码 String 数字证书 String 组织机构 实名邮箱 XML 通过
24、组织机构实名邮箱 查询获取法人信息 GetCorpInfoByEmail String 用户名 String 密码 String 组织机构实 名邮箱 XML 重载上个方法，因为没 有数字证书，暂时使用 7 数据交换体系规范 7.1 报文格式规范 7.1.1 数据交换报文格式 数据交换报文采用符合 W3C XML 语法要求、可在同构或异构系统间交换的 XML Schema。 7.1.2 数据交换报文大小限制 从传输的效率和可靠性角度考虑，控制报文大小通过报文中数据数量控制更为精确，要求每次传输 数量小于 1000 条记录，即交换的数据量 1000 条。 7.1.3 数据交换报文读写控制要求 报文
25、在传输过程中，为保证数据的一致性和完整性，可以直接将报文从内存中读入数据库，采用事 务方式保证数据的一致性。 DB37/T 14352009 8 7.1.4 数据交换报文字符集 报文字符集统一采用 GB2312-1980（信息交换用汉字编码字符集基本集（中文） ） 7.1.5 数据交换报文命名规范 XML 文档采用统一的大小写和命名规范。 原始和属性根据标识对象的内容由 1 到 50 个字母或数字 组成，不包含标点符号，同时按国际统用惯例采用对大小写敏感的风格：对于元素，每个组成单词首字 母大写；对于属性，首字母小写，其余每个组成单词首字母大写。 7.1.6 XML 文档格式 报文由 SOAP
26、 头信息和 Web 服务结构格式（ WSSF）组成，结构见图 4。 图 4 报文结构 SOAP 头信息的格式如下： Web 服务结构格式 7.1.7 SOAP 头结构 SOAP 头的作用是向中心或适配器 Web 服务发送请求时， 判断 SOAP 头中用户信息是否正确。 SOAP 头结构如图 5 所示。 DB37/T 14352009 9 图 5 SOAP 头结构 z SOAP 地址 表示 Web 服务的地址。 z 用户名 表示发送此报文用户的用户名。 z 密码 表示发送此报文用户的密码，使用密文加密。 z 单位 表示发送此报文用户的单位。 z 数字证书 表示发送此报文用户的数字证书。 z 子系
27、统类型 标识此用户登录子系统的类型。 7.1.7.1 子系统类型编码 子系统类型编码见表 9 表 9 子系统类型编码 序号 代码 描述 1 00 法人单位基础信息库 2 10 中心 Web 服务系统 3 11 后台管理系统 4 20 比对校验系统 5 21 比对校验 Windows 服务系统 6 30 适配 Web 服务系统 7 40 上传 Windows 服务系统 8 41 下载 Windows 服务系统 9 50 适配器软件系统 10 90 错误编码管理系统 7.1.8 Web 服务结构格式 Web 服务结构格式的目的是将 Web 服务中发送或接收的信息格式统一。 Web 服务结构格式如图
28、 6 所示。 DB37/T 14352009 10 图 6 Web 服务结构格式 z 版本号 表示协议的版本号，目前版本号为 V1.0。 z 方法名 表示此消息要调用 Web 服务的方法。 z 发送日期 表示此报文发送的日期，格式为“ yyyy-mm-dd hh24:mi:ss” 。 z 结构类型 表示数据内容的类型。 z 错误编号 表示此次操作的错误编号，可匹配错误接口格式使用。 z 数据内容 此次发送的主要内容。 z 附加信息 用于补充发送的数据内容，如电子签名数据等。 7.1.8.1 结构类型编码 结构类型编码见表 10。 表 10 结构类型编码 序号 代码 描述 1 10 字符串 2
29、20 数值 3 30 DataSet 4 40 文件 5 50 图片 6 60 影片 7 90 其它类型 7.2 安全技术规范 7.2.1 数据交换内容安全性 用户登录需使用带有数字证书（ CA）的 USBKey，可以对报文里的数据内容提供加密，以实现抗 抵赖性。把签名加密后的密签标签放入 Web 服务结构格式中的附加信息部分中一起发送。 7.2.2 授权机制 DB37/T 14352009 11 管理中心的用户信息都由后台管理系统统一设定，并为每个用户赋予角色，为每个角色赋予相应的 操作权限。 7.2.3 数据传输的安全性 在 SOAP 和 XML 标准基础上对 SOAP 消息进行安全扩展，
30、保证消息的可信性，即消息的机密性、 完整性和不可抵赖性。 Web 服务目录创建时进行安全设置，当调用服务时，必须首先验证用户，验证通过后，方可进行 操作。 7.3 标准管理规范 随着业务需求的变更以及国家标准的不断更新发展， 各个参建部门可能希望提出对数据交换技术规 范内容进行修改和增加，以保证适用于不断变化的需求。 数据交换标准管理规范包括以下步骤：由参加部门提出标准变更的内容，法人库管理中心负责审核 和维护数据交换标准，并变更相应技术规范，交换标准更改发布后，适配服务根据版本自动更新本部门 的软件系统、数据交换标准。具体参照流程图 7 所示。 图 7 数据交换标准管理规范 7.3.1 系统
31、版本号标识规范 系统版本号标识规范见表 11 表 11 系统版本号标识规范 标准编码 SDFRK-1001 编码用途 该编码用于标识系统的版本 编码类型 字符型 编码长度 该编码采用 10 字节编码 表示方法 XX.XX.XXXX 7.3.2 交换标准版本号标识规范 交换标准版本号标识规范见表 12 表 12 交换标准版本号标识规范 DB37/T 14352009 12 标准编码 SDFRK-1002 编码用途 该编码用于标识数据交换标准的版本 编码类型 字符型 编码长度 该编码采用 10 字节编码 表示方法 XX.XX.XXXX 7.3.3 错误编码版本号标识规范 错误编码版本号标识规范见表 13 表 13 错误编码标识规范 标准编码 SDFRK-1003 编码用途 该编码用于标识错误编码的版本 编码类型 字符型 编码长度 该编码采用 7 字节编码 表示方法 XX.XXXX
