安全培訓(xùn)信息管理平臺(tái)數(shù)據(jù)交換接口規(guī)范國(guó)家安全生產(chǎn)監(jiān)督管理總局

—PAGE2——PAGE1—附件4安全培訓(xùn)信息管理平臺(tái)數(shù)據(jù)交換接口規(guī)范（試行）一、文檔說(shuō)明1.編寫(xiě)目的本文檔適用于安全生產(chǎn)培訓(xùn)信息化管理平臺(tái)各應(yīng)用系統(tǒng)及和外部系統(tǒng)的交換接口，為各應(yīng)用系統(tǒng)對(duì)接的開(kāi)發(fā)、測(cè)試提供依據(jù)。2.使用對(duì)象本文檔供以下相關(guān)人員參閱使用：參與需求分析和確認(rèn)的業(yè)務(wù)人員參與軟件系統(tǒng)開(kāi)發(fā)的技術(shù)人員參與軟件系統(tǒng)測(cè)試的測(cè)試人員相關(guān)合作商成員二、接口說(shuō)明1.接口類型接口類型包含聯(lián)機(jī)交換接口。2.接口元素格式描述說(shuō)明格式類型格式符號(hào)說(shuō)明約束?0..1：可選*0..n：0到多次+1..n：至少出現(xiàn)一次11：必選類型String基礎(chǔ)數(shù)據(jù)類型，包括字符串、日期、數(shù)字等都采用String方式表示長(zhǎng)度Fn固定長(zhǎng)度，n個(gè)字符Vn非固定長(zhǎng)度，最長(zhǎng)為n個(gè)字符3.接口開(kāi)發(fā)規(guī)范WebService+XML,把整個(gè)XML作為輸入?yún)?shù)傳遞.publicStringcooperator（StringXMl）4.協(xié)議頭控制說(shuō)明4.1發(fā)送參數(shù)元素名稱約束類型長(zhǎng)度描述備注UserName1StringF50接口帳號(hào)（必填）PassWord1StringF50接口密碼（必填）IP1StringF50接口IPTransactionId1StringF32請(qǐng)求編號(hào)32位UUID標(biāo)識(shí)SendPlatCode1StringV50發(fā)起方系統(tǒng)代碼機(jī)構(gòu)代碼ReceivePlatCode1StringV50接收方系統(tǒng)代碼機(jī)構(gòu)代碼ServiceCode1StringV50接口編碼PF******ReqTime1StringF14請(qǐng)求時(shí)間YYYYMMDDHHMMSS4.2接收參數(shù)元素名稱約束類型長(zhǎng)度描述備注RetCode1StringF6應(yīng)答編碼RT******RetMsg1StringV2000應(yīng)答描述——三、聯(lián)機(jī)交換接口注：以下定義的“發(fā)送參數(shù)”和“接收參數(shù)”均是協(xié)議體。1.題庫(kù)知識(shí)點(diǎn)更新接口1.1接口說(shuō)明接口編碼SJ01接口描述省局平臺(tái)主動(dòng)獲取總局平臺(tái)題庫(kù)知識(shí)點(diǎn)信息接口類型webservice數(shù)據(jù)流向總局平臺(tái)->省局平臺(tái)1.2接收參數(shù)元素名稱約束類型寬度描述備注lgList1--節(jié)點(diǎn)標(biāo)簽——lgInfo1--節(jié)點(diǎn)標(biāo)簽——id1StringF32題庫(kù)知識(shí)點(diǎn)代碼(必填)lg_name1StringV50題庫(kù)知識(shí)點(diǎn)名稱(必填)lg_class_id1StringV32題庫(kù)知識(shí)點(diǎn)分類代碼(必填)lg_class_name1StringV50題庫(kù)知識(shí)點(diǎn)分類名稱(必填)lg_type1int題庫(kù)知識(shí)點(diǎn)類型1理論題2能力題(必填)lg_remark1StringV500題庫(kù)知識(shí)點(diǎn)描述(選填)version1int版本號(hào)(必填)input_dep_id1V32錄入單位代碼(必填)zglx_code1StringV50資格類型(必填)zylb_code1StringV50單位類型/作業(yè)類別(必填)czxm_codeStringV50操作項(xiàng)目(必填)lg_code1StringV50題庫(kù)知識(shí)點(diǎn)編碼——2.組題策略更新接口2.1接口說(shuō)明接口編碼SJ03接口描述省局平臺(tái)主動(dòng)獲取總局平臺(tái)策略信息接口類型webservice數(shù)據(jù)流向總局平臺(tái)->省局平臺(tái)2.2接收參數(shù)策略主信息：元素名稱約束類型寬度描述備注ruleList策略集合標(biāo)簽——ruleInfo策略實(shí)體標(biāo)簽——lg_class_id1StringF32題庫(kù)知識(shí)點(diǎn)分類代碼(必填)lg_class_name1StringV50題庫(kù)知識(shí)點(diǎn)分類名稱(必填)rule_type1int題庫(kù)知識(shí)點(diǎn)類型1：初訓(xùn)2：復(fù)訓(xùn)(必填)duration1int考試時(shí)長(zhǎng)(必填)sum_mark1int試卷總分值(必填)pass_mark1int及格分?jǐn)?shù)(必填)num1int單張?jiān)嚲砜傤}數(shù)(必填)single_mark_11float理論單選題分值(必填)multi_mark_11float理論多選題分值(必填)judge_mark_11float理論判斷題分值(必填)single_mark_21float能力單選題分值(必填)multi_mark_21float能力多選題分值(必填)judge_mark_21float能力判斷題分值(必填)rate_11int抽題比例（國(guó)家）(必填)rate_21int抽題比例（地方）(必填)version1int版本號(hào)(必填)remark1StringV500考試說(shuō)明(選填)input_dep_id1StringV32錄入單位代碼(必填)single_sum_11int單選題題量(理論)(必填)multi_sum_11int多選題題量(理論)(必填)judge_sum_11int判斷題題量(理論)(必填)single_sum_21int單選題題量(能力)(必填)multi_sum_21int多選題題量(能力)(必填)judge_sum_21int判斷題題量(能力)(必填)detailList策略明細(xì)集合標(biāo)簽——detailInfo策略明細(xì)標(biāo)簽——策略明細(xì)信息：元素名稱約束類型寬度描述備注lg_id1StringF32題庫(kù)知識(shí)點(diǎn)代碼(必填)lg_name1StringV50題庫(kù)知識(shí)點(diǎn)名稱(必填)tq_type1int試題類型1：?jiǎn)芜x；2：多選；3：判斷(必填)tq_level1int試題難度1：難；2：中；3：易(必填)rate1float知識(shí)點(diǎn)題型占試卷題量的抽題比例保留2位小數(shù)(必填)num1int知識(shí)點(diǎn)題型占試卷題量的抽題比例值(必填)3.試題庫(kù)更新接口3.1接口說(shuō)明接口編碼SJ02接口描述省局平臺(tái)主動(dòng)獲取總局平臺(tái)試題庫(kù)信息接口類型webservice數(shù)據(jù)流向總局平臺(tái)->省局平臺(tái)3.2接收參數(shù)元素名稱約束類型寬度描述備注tqList1--節(jié)點(diǎn)標(biāo)簽——tqInfo1--節(jié)點(diǎn)標(biāo)簽——lg_class_id1StringF32題庫(kù)知識(shí)點(diǎn)分類代碼(必填)lg_id1StringF32題庫(kù)知識(shí)點(diǎn)代碼(必填)lg_name1StringV50題庫(kù)知識(shí)點(diǎn)名稱(必填)tq_ccode1StringV50試題編號(hào)(必填)tq_name1StringV1000試題名稱（題干）(必填)tq_type1StringF1試題類型1：?jiǎn)芜x；2：多選；3：判斷(必填)tq_level1StringF1試題難度1：難；2：中；3：易(必填)bz_answer1StringV10標(biāo)準(zhǔn)答案以逗號(hào)隔開(kāi)(必填)da_jx1StringV1200答案解析(選填)xx1StringV1200試題選項(xiàng)(必填)version1int版本(必填)input_dep_id1StringV32試題錄入單位代碼(必填)4.學(xué)員(考生)、學(xué)時(shí)、成績(jī)、證書(shū)信息維護(hù)接口4.1接口說(shuō)明接口編碼PF0004接口描述省局平臺(tái)將學(xué)員、學(xué)時(shí)、成績(jī)、證書(shū)信息同步給總局接口類型Excel導(dǎo)入數(shù)據(jù)流向省局平臺(tái)->總局平臺(tái)備注不同資格類型人員報(bào)名信息的必填信息不同。4.2發(fā)送參數(shù)元素名稱約束類型寬度描述備注資格證書(shū)年份1StringV50發(fā)證年份（數(shù)字）（必填）資格類型1StringV50參考安全培訓(xùn)相關(guān)規(guī)定（必填）作業(yè)類別/單位類型1StringV50參考安全監(jiān)管總局30號(hào)令及相關(guān)規(guī)定（必填）操作項(xiàng)目1StringV50參考安全監(jiān)管總局30號(hào)令（必填）初訓(xùn)/復(fù)訓(xùn)1StringV50填寫(xiě)初訓(xùn)或復(fù)訓(xùn)（必填）期次1StringV50培訓(xùn)班期次，如“01”（必填）姓名1StringV50姓名（必填）性別1StringV50男/女（必填）身份證件類型1StringV50身份證、軍官證、護(hù)照（必填）身份證件號(hào)1StringV50證件號(hào)碼（必填）民族1StringV50參考GB3304國(guó)家標(biāo)準(zhǔn)（選填）政治面貌1StringV50參考GBT4762國(guó)家標(biāo)準(zhǔn)（選填）最高學(xué)歷1StringV50參考GB/T4658國(guó)家標(biāo)準(zhǔn)（必填）畢業(yè)院校1StringV300院校全稱（選填）所學(xué)專業(yè)1StringV300專業(yè)全稱（選填）從事專業(yè)1StringV300目前從事專業(yè)（選填）健康狀況1StringV50參考GB/T261.3國(guó)家標(biāo)準(zhǔn)（必填）工作單位1StringV300工作單位全稱（必填）工商登記號(hào)1StringV50工商登記號(hào)（選填）參加工作時(shí)間1StringV50日期格式y(tǒng)yyymmdd（選填）部門(mén)1StringV300所在部門(mén)全稱（選填）職務(wù)1StringV300擔(dān)任的職務(wù)（選填）職稱或技能等級(jí)1StringV50參考相關(guān)規(guī)定（選填）固定電話1StringV50區(qū)號(hào)-號(hào)碼（選填）移動(dòng)電話1StringV50——（必填）通訊地址1StringV50通訊地址（選填）郵政編碼1StringV50郵政編碼（選填）電子郵箱1StringV300——（選填）從事安全培訓(xùn)工作時(shí)間1StringV50日期格式y(tǒng)yyymmdd（選填）兼職單位1StringV300單位全稱（必填）是否免培訓(xùn)1int填寫(xiě)是/否（必填）培訓(xùn)單位代碼1StringV50參考相關(guān)規(guī)定——總學(xué)時(shí)1float數(shù)字（必填）是否已考試1int是/否（必填）考試機(jī)構(gòu)代碼1StringV50————知識(shí)考試點(diǎn)代碼1StringV50————實(shí)操考試點(diǎn)代碼1StringV50————安全知識(shí)成績(jī)1float安全知識(shí)成績(jī)，默認(rèn)填寫(xiě)0（必填）實(shí)際操作成績(jī)1float實(shí)際操作成績(jī)，默認(rèn)填寫(xiě)0（必填）是否需取證1int是/否（必填）發(fā)證機(jī)關(guān)代碼1StringV50————證書(shū)編號(hào)1StringV50——（必填）證件標(biāo)識(shí)1StringV50————初次發(fā)證日期1StringV50日期格式y(tǒng)yyymmdd（必填）有效期開(kāi)始時(shí)間1StringV50日期格式y(tǒng)yyymmdd（必填）應(yīng)復(fù)審時(shí)間1StringV50日期格式y(tǒng)yyymmdd（必填）實(shí)際復(fù)審時(shí)間1StringV50日期格式y(tǒng)yyymmdd（必填）5.證件狀態(tài)變更接口5.1接口說(shuō)明接口編碼PF0005接口描述省局平臺(tái)將證書(shū)狀態(tài)變更信息同步給總局接口類型Excel導(dǎo)入數(shù)據(jù)流向省局平臺(tái)->總局平臺(tái)5.2發(fā)送參數(shù)元素名稱約束類型寬度描述備注證書(shū)編號(hào)1StringF50——（必填）證件狀態(tài)1int“有效”、“撤銷”、“暫扣”、“吊銷”、“注銷”（必填）證件標(biāo)識(shí)1int——（必填）6.證書(shū)異地登記接口6.1接口說(shuō)明接口編碼PF0005接口描述省