4.安全培训信息管理平台数据交换接口规范-国家安全生产监督管理总局.docVIP

附件4 安全培训信息管理平台数据交换 接口规范（试行） 一、文档说明 1.编写目的 本文档适用于安全生产培训信息化管理平台各应用系统及和外部系统的交换接口，为各应用系统对接的开发、测试提供依据。 2.使用对象 本文档供以下相关人员参阅使用： 参与需求分析和确认的业务人员 参与软件系统开发的技术人员 参与软件系统测试的测试人员 相关合作商成员 二、接口说明 1.接口类型 接口类型包含联机交换接口。 2.接口元素格式描述说明 格式类型 格式符号 说明 约束 ? 0..1：可选 * 0..n：0到多次 + 1..n：至少出现一次 1 1：必选 类型 String 基础数据类型，包括字符串、日期、数字等都采用String方式表示 长度 Fn 固定长度，n个字符 Vn 非固定长度，最长为n个字符 3.接口开发规范 WebService + XML,把整个XML作为输入参数传递. public String cooperator（String XMl） 4.协议头控制说明 4.1发送参数 元素名称 约束 类型 长度 描述 备注 UserName 1 String F50 接口帐号 （必填） PassWord 1 String F50 接口密码 （必填） IP 1 String F50 接口IP TransactionId 1 String F32 请求编号 32位UUID标识 SendPlatCode 1 String V50 发起方系统代码 机构代码 ReceivePlatCode 1 String V50 接收方系统代码 机构代码 ServiceCode 1 String V50 接口编码 PF****** ReqTime 1 String F14 请求时间 YYYYMMDDHHMMSS 4.2接收参数 元素名称 约束 类型 长度 描述 备注 RetCode 1 String F6 应答编码 RT****** RetMsg 1 String V2000 应答描述 —— 三、联机交换接口 注：以下定义的“发送参数”和“接收参数”均是协议体。 1.题库知识点更新接口 1.1接口说明 接口编码 SJ01 接口描述 省局平台主动获取总局平台题库知识点信息 接口类型 webservice 数据流向 总局平台-省局平台 1.2接收参数 元素名称 约束 类型 宽度 描述 备注 lgList 1 - - 节点标签 —— lgInfo 1 - - 节点标签 —— id 1 String F32 题库知识点代码 (必填) lg_name 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 题库知识点描述 (选填) version 1 int 版本号 (必填) input_dep_id 1 V32 录入单位代码 (必填) zglx_code 1 String V50 资格类型 (必填) zylb_code 1 String V50 单位类型/作业类别 (必填) czxm_code String V50 操作项目 (必填) lg_code 1 String V50 题库知识点编码 —— 2.组题策略更新接口 2.1接口说明 接口编码 SJ03 接口描述 省局平台主动获取总局平台策略信息 接口类型 webservice 数据流向 总局平台-省局平台 2.2接收参数 策略主信息： 元素名称 约束 类型 宽度 描述 备注 ruleList - - - 策略集合标签 —— ruleInfo - - - 策略实体标签 —— lg_class_id 1 String F32 题库知识点分类代码 (必填) lg_class_name 1 String V50 题库知识点分类名称 (必填) rule_type 1 int 题库知识点类型 1：初训2：复训 (必填) duration 1 int 考试时长 (必填) sum_mark 1 int 试卷总分值 (必填) pass_mark 1 int 及格分数 (必填) num 1 int 单张试卷总题数 (必填) single_mark_1 1 float 理论单选题分值 (必填) multi_mark_1 1 float 理论多选题分值 (必填) judge_mark_1 1 float 理论判