安全培训信息管理平台数据交换.DOC

1、安全培训信息管理平台数据交换接口规范（试行）国家安全生产监督管理总局人事司（宣教办）国家安全生产监督管理总局培训中心2017年 11月 2 安全培训信息管理平台数据交换接口规范（试行）一、 文档说明1.1. 编写目的本文档适用于安全生产培训信息化管理平台各应用系统及和外部系统的交换接口，为各应用系统对接的开发、测试提供依据。1.2. 使用对象本文档供以下相关人员参阅使用：参与需求分析和确认的业务人员参与软件系统开发的技术人员参与软件系统测试的测试人员相关合作商成员二、 数据交换对接前期准备2.1. 基础数据准备省局系统管理员登录安全培训信息管理平台，设置维护本省所有组织机构，设置完成后，总局系

2、统管理员设置数据交换口令。2.2. 组卷相关业务数据准备如使用地方题库、知识点、组题策略、试题数据，省局登录安全培训信息管理平台，录入本省的知识点、组题策略、试题数据。三、 对接内容3.1. 组织机构信息考核发证机关、考试机构、考试点及培训机构基本信息。3.2. 题库信息国家题库、知识点、组题策略，地方题库、知识点、组题策略。 3 3.3. 学员相关信息学员（考生）基本信息、培训单位、学时、考试机构、考试点、成绩、发证机关、证书信息等数据。四、 对接方式4.1. 组织机构信息对接方式总局通过平台开通省级管理员用户，省局管理员将考核发证机关、考试机构、考试点及培训机构基本信息维护进入平台。4.2

3、. 题库信息对接方式1）地方题库、知识点通过总局平台的题库管理功能进行录入（导入）、修改、删除、签发，地方题库组题策略通过总局平台的组题策略功能配置；2）总局平台通过数据接口平台将国家题库、地方题库及对应的组题策略整体加密压缩形成组卷系统，统一配发至省级现有信息管理系统，省级现有信息管理系统向组卷系统提交考试期次、人员类别、试卷数量等参数，抽取试卷。4.3. 学员相关信息对接方式学员（考生）基本信息、培训单位、学时、考试机构、考试点、成绩、发证机关、证书信息等数据，由省级现有信息管理系统通过接口自动推送至总局平台数据中心。五、 接口说明5.1. 接口类型接口类型包含联机交换接口。5.2. 接口

4、元素格式描述说明格式类型 格式符号 说明? 0.1：可选* 0.n：0 到多次+ 1.n：至少出现一次约束1 1：必选类型 String 基础数据类型，包括字符串、日期、数字等都采用 String 方式表示Fn 固定长度，n 个字符长度Vn 非固定长度，最长为 n 个字符5.3. 接口开发规范WebService + XML,把整个 XML 作为输入参数传递. 4 5.4. webService 协议头控制说明5.4.1. 发送 xml 元素元素名称 约束 类型 长度 描述 备注UserName 1 String V50 接口帐号 （必填）PassWord 1 String V20 接口密码

5、（必填）IP 1 String V20 接口 IP 选填TransactionId 1 String F32 请求编号 选填(32 位 UUID 标识)SendPlatCode 1 String V50 发起方系统代码 (必填)机构代码ReceivePlatCode 1 String V50 接收方系统代码 (必填)机构代码ServiceCode 1 String F4 接口编码 SJ*ReqTime 1 String F14 请求时间 YYYYMMDDHHMMSSVersion 1 int V20 版本号 题库版本号5.4.2. 接收参数元素名称 约束 类型 长度 描述 备注RetCode

6、1 String F4 应答编码 RT*RetMsg 1 String V2000 应答描述 5.4.3. 头文件 xml 格式( 见附 件 1)六、 联机交换接口注：以下定义的“发送参数” 和“ 接收参数”均是协议体。6.1. 题库知识点更新接口6.1.1. 接口说明接口编码 SJ01接口描述 省局平台主动获取总局平台题库知识点信息接口类型 webservice数据流向 总局平台-省局平台6.1.2. 接收 xml 元素元素名称 约束 类型 宽度 描述 备注lgList 1 - - 节点标签 lgInfo 1 - - 节点标签 id 1 String F32 题库知识点代码 (必填)lg_n

7、ame 1 String V50 题库知识点名称 (必填)lg_code 1 String V50 题库知识点编码 lg_class_id 1 String V32 考核对象代码 (必填)lg_class_name 1 String V50 考核对象名称 (必填)lg_type 1 int 题库知识点类型 1 理论题 2 能力题(必填)lg_remark 1 String V500 题库知识点描述 (选填) 5 input_dep_id 1 V32 组织 ID (必填)6.1.3. 返回参数元素名称 约束 类型 宽度 描述 备注info 1 - - 节点标签 input_dep_id 1 -

8、V50 考点所在省代码 (选填)send_status 1 String V50 接收是否成功状态 (选填)6.1.4. 题库知识点 xml 格式 (见附件 2)6.1.5. 接口使用说明1）通过 webservice 方法获取知识点字符串，该字符串是经过 gzip 压缩并通过 Base64 编码后的字符串。2）获取知识点后，需先使用 BASE64 对字符串解码。3）解码后，通过 gzip 进行解压缩（字符串格式为 GBK）。解压缩后即可获得一个 xml 格式的知识点字符串。4）解析 xml 格式数据，对下列需转义字符进行转义：需转义字符 字符img”的内容（img: 图片路径 ;img），说

9、明它是个图片需要解析显示，这个需要去 ftp 下载图片，这个图片是 tq/images1/tk/m_m_2.png 。6.6. （改）学员(考生) 、学时、成绩、证书信息维护接口6.6.1. 接口说明接口编码 SJ04接口描述 省局平台将学员、学时、成绩、证书信息同步给总局接口类型 webservice数据流向 省局平台-总局平台备注 不同资格类型人员报名信息的必填信息不同。6.6.2. 输入参数元素名称 元素名称 约束 类型 宽度 描述 备注ZGLX_NAME 资格类型 1 String V50 参考安全培训相关规定 （必填）ZYLB_NAME 作业类别(单位类型) 1 String V50

10、参考安全监管总局 30号令及相关规定 （必填）CZXM_NAME 操作项目 1 String V50 参考安全监管总局 30号令 （必填）STU_NAM 姓名 1 String V50 姓名 （必填）SEX 性别 1 String V50 男/女 （必填）CERTTYPE_NAME 身份证件类型 1 String V50身份证、军官证、护照 （必填）CERTNUM 身份证件号 1 String V50 证件号码 （必填）NATION_NAME 民族 1 String V50 参考 GB3304 国家标准 （选填）POLITICAL_STATUS_NAME 政治面貌 1 String V50参考

11、 GBT4762 国家标准 （选填）HIGHEST_EDUCATION_NAME最高学历 1 String V50 参考 GB/T4658 国家标准 （必填）GRADUATE_SCHOOL 毕业院校 1 String V300 院校全称 （选填）MAJOR 所学专业 1 String V300 专业全称 （选填）WORK_MAJOR 从事专业 1 String V300 目前从事专业(负责人、安管人员必填)HEALTH_NAME 健康状况 1 String V50参考 GB/T261.3 国家标准 （必填）WORK_UNIT 工作单位 1 String V300 工作单位全称 （选填）START_WORK_TIME 参加工作时间 1 String V50 日期格式 yyyy-mm-dd （选填）DEPT 部门 1 String V300 所在部门全称 （选填）