基于Web的場景化電子交互式幫助系統(tǒng)

毛瑩 謝亞妮 李輝

摘? 要：針對(duì)當(dāng)前信息系統(tǒng)操作使用手冊(cè)實(shí)用性和便利性不強(qiáng)的現(xiàn)狀，文章基于GJB 6600-2008提出了針對(duì)信息系統(tǒng)裝備軟件的幫助信息數(shù)據(jù)模塊結(jié)構(gòu)，據(jù)此設(shè)計(jì)并實(shí)現(xiàn)了一種適用于信息系統(tǒng)裝備軟件的電子交互式幫助軟件，統(tǒng)一幫助文檔制作工序，統(tǒng)一信息系統(tǒng)用戶的使用模式，實(shí)現(xiàn)了幫助信息制作智能化、集成化、版本化管理，降低幫助信息儲(chǔ)存冗余，輔助系統(tǒng)操作人員快速掌握系統(tǒng)主要功能和典型應(yīng)用流程，提高了系統(tǒng)的保障性，提升了用戶軟件使用感受。

關(guān)鍵詞：電子交互式幫助;SpringMVC;軍隊(duì)信息化

中圖分類號(hào)：TP334.3? ? ? 文獻(xiàn)標(biāo)識(shí)碼：A 文章編號(hào)：2096-4706（2020）18-0054-04

Abstract：In view of the current information system operation manual is not practical and convenient，this paper proposes the help information data module structure for information system equipment software based on GJB 6600-2008，and designs and implements an electronic interactive help software suitable for information system equipment software，unifies the help document making process，unifies the use mode of information system users，realizes the intelligent，integrated and version management of help information production，and reduces the storage of help information redundancy，assist system operators to quickly master the main functions and typical application process of the system，improve the supportability of the system and enhance the users experience of software use.

Keywords：electronic interactive help;SpringMVC;army informatization

0? 引? 言

近年來，隨著軍工領(lǐng)域不斷發(fā)展，軍隊(duì)信息化系統(tǒng)建設(shè)逐步推進(jìn)，軍隊(duì)對(duì)信息系統(tǒng)裝備的需求越來越高。中國電子科技集團(tuán)公司第二十八研究所作為以指揮控制為核心的信息系統(tǒng)供應(yīng)商，為用戶提供指揮信息系統(tǒng)解決方案。我所信息系統(tǒng)裝備軟件具有集成規(guī)模大、業(yè)務(wù)復(fù)雜度高、版本迭代快等特點(diǎn)，如何使用戶快速掌握系統(tǒng)操作要領(lǐng)、促進(jìn)用戶業(yè)務(wù)水平提升是售后保障工作重要內(nèi)容之一。用戶培訓(xùn)可以使用戶快速掌握系統(tǒng)軟件的主要功能和典型應(yīng)用流程。系統(tǒng)用戶手冊(cè)作為用戶培訓(xùn)工作的關(guān)鍵手段和技術(shù)，在信息系統(tǒng)裝備的交付驗(yàn)收和維修保障階段具有越來越重要的作用[1]。系統(tǒng)用戶手冊(cè)主要包括操作手冊(cè)和安裝維護(hù)說明書，目前業(yè)內(nèi)電子用戶手冊(cè)常用形式：TXT文件、DOC/DOCX/PDF文件、HTML/CHM文件，不易進(jìn)行幫助文件共享、更新和版本控制[2，3]。

2008年中國人民解放軍總裝備部批準(zhǔn)發(fā)布了GJB 6600-2008系列標(biāo)準(zhǔn)，該標(biāo)準(zhǔn)規(guī)定了裝備交互式電子技術(shù)手冊(cè)（Inter-active Electronic Technical Manual，IETM）的功能、內(nèi)容、樣式、數(shù)據(jù)格式和管理信息等要求[4]。目前IETM主要用于武器硬件裝備幫助設(shè)計(jì)，尚未在信息系統(tǒng)裝備中進(jìn)行廣泛應(yīng)用。針對(duì)當(dāng)前信息系統(tǒng)操作使用手冊(cè)的實(shí)用性和便利性不強(qiáng)的現(xiàn)狀，以快速掌握典型應(yīng)用流程需求為牽引，作者深入研究GJB 6600-2008，加強(qiáng)對(duì)用戶培訓(xùn)需求的調(diào)研，提出了針對(duì)信息系統(tǒng)裝備軟件的幫助信息數(shù)據(jù)模塊結(jié)構(gòu)，據(jù)此設(shè)計(jì)并實(shí)現(xiàn)了一種適用于信息系統(tǒng)裝備軟件的電子交互式幫助軟件，規(guī)范信息化裝備幫助信息標(biāo)準(zhǔn)，實(shí)現(xiàn)電子交互式幫助軟件精簡化、自動(dòng)化、智能化，突出用戶場景體驗(yàn)感受。目前我所已在海事領(lǐng)域某項(xiàng)目中對(duì)該電子交互式幫助系統(tǒng)進(jìn)行試用，該系統(tǒng)深受用戶好評(píng)，有效提升產(chǎn)品服務(wù)質(zhì)量。

1? IETM軟件數(shù)據(jù)模型設(shè)計(jì)

IETM的本質(zhì)是按照規(guī)范的數(shù)據(jù)格式以數(shù)字化形式將文本、多媒體、表格等技術(shù)信息資料組織起來，再通過一定的顯示程序向用戶展現(xiàn)。IETM的核心是規(guī)范化的數(shù)據(jù)模塊[5]，數(shù)據(jù)模塊是描述裝備結(jié)構(gòu)、性能和操作步驟等技術(shù)信息的獨(dú)立、完整的數(shù)據(jù)單位。而數(shù)據(jù)模型的規(guī)范化有利于實(shí)現(xiàn)軟件裝備技術(shù)信息交互和軟件重用模塊信息共享。GJB 6600-2008標(biāo)準(zhǔn)的核心數(shù)據(jù)塊由通用信息和專用信息組成，通用信息包括數(shù)據(jù)模塊的標(biāo)識(shí)和狀態(tài)信息，專用信息包括文檔內(nèi)容的主體，主要包括操作使用、維修保障信息。GJB 6600-2008將數(shù)據(jù)模塊分為8類，包括描述類、程序類、故障類、維修計(jì)劃類、操作類、圖解零件類、連線類、過程類;對(duì)于軟件裝備信息系統(tǒng)，描述類信息、故障類信息、操作類和程序類信息尤為重要[6]。

喬福超基于GJB 6600-2008設(shè)計(jì)了一種“系統(tǒng)—分系統(tǒng)/分分系統(tǒng)層—窗口層—組件層”軟件系統(tǒng)劃分和軟件類數(shù)據(jù)模型，該模型以窗口為顆粒度，通過將窗口中組件識(shí)別錄入成XML數(shù)據(jù)格式并對(duì)其解析的方式獲取系統(tǒng)信息[7，8]。該方法具有一定操作性，但是一個(gè)復(fù)雜的業(yè)務(wù)信息系統(tǒng)往往包含幾十個(gè)甚至幾百個(gè)窗口/頁面，窗口/頁面中組件形式也趨于多樣化;不同窗口之間信息冗余度較高，如通過差異碼對(duì)窗口組件信息進(jìn)行區(qū)分，勢必會(huì)增加幫助信息錄入人員的工作量，也對(duì)IETM數(shù)據(jù)維護(hù)提出了較高要求。目前計(jì)算機(jī)行業(yè)注重用戶友好性設(shè)計(jì)，如頁面/窗口存在大量提示信息等用戶友好界面方式，幫助軟件著重頁面/窗口組件功能解析，不利于用戶快速熟悉了解系統(tǒng)整體功能。

以應(yīng)用流程為導(dǎo)向，本文提出了基于“主題應(yīng)用層—基礎(chǔ)功能層—數(shù)據(jù)元素層”三層架構(gòu)的軟件系統(tǒng)幫助信息層次圖。以某企業(yè)信息化管理系統(tǒng)為例，如圖1所示，該系統(tǒng)由財(cái)務(wù)管理系統(tǒng)、項(xiàng)目管理系統(tǒng)、人力資源系統(tǒng)等分系統(tǒng)構(gòu)成，其中每一個(gè)分系統(tǒng)有多個(gè)主題應(yīng)用，不同的主題應(yīng)用由多個(gè)基礎(chǔ)功能組成，基礎(chǔ)功能以一個(gè)或多個(gè)窗口為基本單元，窗口信息以數(shù)據(jù)元素為載體實(shí)線，數(shù)據(jù)元素形式一般包括文字、視頻、圖片等多種多媒體格式。不同的主題應(yīng)用可能涉及同一基礎(chǔ)功能，通過基礎(chǔ)功能的劃分識(shí)別后再整合，降低幫助信息冗余度。

1.1? 基礎(chǔ)功能數(shù)據(jù)模型

基礎(chǔ)功能指的系統(tǒng)中獨(dú)立存在、具有一定接口規(guī)范、可以被復(fù)用的最小功能模塊?；A(chǔ)功能數(shù)據(jù)模型由功能編碼、功能簡介、發(fā)布狀態(tài)、功能描述組成。功能編碼是基礎(chǔ)功能數(shù)據(jù)模型的唯一標(biāo)識(shí)符。軍用軟件信息系統(tǒng)強(qiáng)調(diào)組合化、通用化、系列化，鼓勵(lì)軟件模塊復(fù)用，為了降低幫助信息冗余度，針對(duì)同樣的模塊可能在不同系統(tǒng)使用場景不一的問題，基礎(chǔ)功能模塊中的功能描述以用例為單位存儲(chǔ)。用例可以源于同一系統(tǒng)不同應(yīng)用場景想定，也可以源于不同系統(tǒng)同一應(yīng)用想定，同一用例可以適用于不同的典型應(yīng)用流程。這些基礎(chǔ)功能模塊經(jīng)過多輪測試使用，具有較強(qiáng)的健壯性，基礎(chǔ)功能模板的使用提高了系統(tǒng)研制效率，提升了軟件開發(fā)的費(fèi)效比。以基礎(chǔ)功能報(bào)銷申請(qǐng)為例，具體信息結(jié)構(gòu)如下所示：

<基礎(chǔ)功能信息>

<功能編碼>BSWOINDW-78629322

<功能簡介>報(bào)銷申請(qǐng)

<發(fā)布狀態(tài)>1

<功能描述>

<票據(jù)信息錄入>

<用例編碼>x0001

<所屬分系統(tǒng)碼>FIANCE-APPRB-29387108

<用例描述>

<用例摘要>啟動(dòng)報(bào)銷申請(qǐng)流程，完成票據(jù)信息錄入、審核

<操作說明>

打開“報(bào)銷申請(qǐng)”對(duì)話框，點(diǎn)擊“票據(jù)錄入”按鈕，上傳票據(jù)照片，輸入票據(jù)信息，包括出發(fā)地、目的地、耗時(shí)、交通工具等基本信息，如下圖所示。

<錄入時(shí)間>2020-08-12

<版本信息>v0.0.2

<發(fā)布狀態(tài)>1

<票據(jù)信息修改>

……

1.2? 主題應(yīng)用數(shù)據(jù)模型

主題應(yīng)用層數(shù)據(jù)主要是結(jié)合系統(tǒng)典型應(yīng)用流程，從用戶使用場景出發(fā)，通過典型應(yīng)用讓軟件使用者迅速了解掌握系統(tǒng)操作使用方法，全局性地描述整個(gè)系統(tǒng)典型應(yīng)用流程的使用步驟。典型應(yīng)用數(shù)據(jù)結(jié)構(gòu)由典型應(yīng)用編碼、所屬系統(tǒng)、版本信息、發(fā)布狀態(tài)、操作流程信息組成，其中操作流程具體步驟由基礎(chǔ)功能的用例信息組合而成，不需要二次錄入。系統(tǒng)設(shè)計(jì)人員只需要關(guān)注基礎(chǔ)功能數(shù)據(jù)及其排序，若沒有相關(guān)使用場景，設(shè)計(jì)人員可根據(jù)實(shí)際需求進(jìn)行基礎(chǔ)功能用例信息補(bǔ)充描述，提高了電子交互式幫助信息錄入的便捷性和智能化。以“財(cái)務(wù)報(bào)銷”應(yīng)用為例，說明典型應(yīng)用數(shù)據(jù)結(jié)構(gòu)，代碼如下：

<財(cái)務(wù)報(bào)銷典型應(yīng)用>

<典型應(yīng)用編碼>198876789

<所屬系統(tǒng)>CPCMGL-FIANCE-APPRB-29387108

<版本信息>V0.0.0.3

<發(fā)布狀態(tài)>1

<操作流程>

<基本功能>

<功能編碼>BSWOINDW-78629322

<用例編碼>0x0001

<基本功能>

<功能編碼>BSWOINDW-78344322

<用例編碼>0x0002

<基本功能>

……

2? 系統(tǒng)設(shè)計(jì)

基于場景化IETM軟件數(shù)據(jù)模型，本文設(shè)計(jì)并實(shí)現(xiàn)了一種適用于信息系統(tǒng)裝備軟件的電子交互式幫助軟件，系統(tǒng)采用B/S（瀏覽器/服務(wù)器）架構(gòu)，包括制作編輯系統(tǒng)和使用幫助展現(xiàn)系統(tǒng)兩大類功能。制作編輯系統(tǒng)主要面向設(shè)計(jì)和開發(fā)人員，支持幫助文檔制作、導(dǎo)入、典型應(yīng)用流程合成等功能;使用幫助展現(xiàn)系統(tǒng)主要面向信息系統(tǒng)用戶，提供幫助信息展現(xiàn)、幫助信息檢索功能。電子交互式幫助框架支持文字、圖片、視頻等常用多媒體信息的展現(xiàn)，提升了用戶視覺體驗(yàn)。電子交互式幫助軟件前臺(tái)展現(xiàn)頁面如圖2所示。

2.1? 基礎(chǔ)功能錄入

系統(tǒng)支持Word文檔導(dǎo)入和人工錄入兩種方式錄入基礎(chǔ)功能信息。人工錄入模式主要利用CKEditor富文本工具對(duì)幫助信息進(jìn)行編輯，支持文字、圖片、表格、視頻和音頻的錄入功能;支持對(duì)齊方式、字體、字號(hào)、顏色、間距等基本排版功能;支持錄入基本元素（所屬分系統(tǒng)、摘要等信息）的模板制作。系統(tǒng)支持通過JACOB中間件完成DOC/DOCX文檔轉(zhuǎn)變?yōu)镠TML文件，通過CKEditor富文本工具二次編輯排版完成歷史Word版幫助信息自動(dòng)導(dǎo)入，提高幫助信息錄入效率，如圖3所示。

2.2? 典型應(yīng)用合成

錄入的幫助信息在后臺(tái)基于1.1節(jié)提出的基礎(chǔ)功能數(shù)據(jù)模型進(jìn)行存儲(chǔ)。設(shè)計(jì)人員通過對(duì)基礎(chǔ)功能用例進(jìn)行選擇排序合成典型應(yīng)用，并進(jìn)行幫助信息發(fā)布。該系統(tǒng)面向開發(fā)者提供幫助功能單元的順序，可根據(jù)功能用例進(jìn)行組合，形成流程化的幫助說明，指導(dǎo)用戶按照編排的功能用例（順序）逐個(gè)組合形成復(fù)雜操作的過程。

2.3? 維保信息模糊搜索

安格努斯·瑞望的用戶體驗(yàn)輪模型指出，以產(chǎn)品價(jià)值為核心，輻射出可查找性、可訪問性、可獲取性、可用性、可信度和有用性等基本特性[9]?；谟脩趔w驗(yàn)輪模型，系統(tǒng)提供面向用戶的維護(hù)保障信息檢索功能，支持按關(guān)鍵詞進(jìn)行幫助信息模糊檢索。系統(tǒng)基于編輯距離算法，計(jì)算關(guān)鍵字與幫助信息之間的關(guān)鍵距離，并按相似度由高到低進(jìn)行排列，記錄用戶的檢索記錄;對(duì)于幫助瀏覽中出現(xiàn)的關(guān)鍵詞匯用顏色進(jìn)行標(biāo)記，便于用戶快速檢索、識(shí)別、篩選所需的幫助信息。

3? 結(jié)? 論

本文基于GJB 6600-2008，綜合用戶體驗(yàn)輪模型，提出了基于“主題應(yīng)用層—基礎(chǔ)功能層—數(shù)據(jù)元素層”三層架構(gòu)的軟件系統(tǒng)幫助信息數(shù)據(jù)模塊結(jié)構(gòu)，設(shè)計(jì)并實(shí)現(xiàn)了一種適用于信息系統(tǒng)裝備的電子交互式幫助軟件，統(tǒng)一幫助文檔制作工序，統(tǒng)一信息系統(tǒng)用戶的使用模式。本文設(shè)計(jì)的電子交互式幫助軟件實(shí)現(xiàn)了系統(tǒng)幫助信息程序化錄入管理、版本化維護(hù)存儲(chǔ)、用例化組合生成。通過HTML/CHM文件生成1 000萬行規(guī)模的系統(tǒng)幫助文件平均耗時(shí)約7人日，其中6人日用于幫助信息錄入，1人日用于幫助文件標(biāo)準(zhǔn)化審查修改。通過電子交互式幫助軟件進(jìn)行幫助信息錄入，利用標(biāo)準(zhǔn)統(tǒng)一約束、信息同步錄入、用例同步共享等機(jī)制，生成1 000萬行規(guī)模的系統(tǒng)幫助文件平均耗時(shí)3人日，基礎(chǔ)功能用例復(fù)用率達(dá)30%。

參考文獻(xiàn)：

[1] 王小玉，張艷煥.指揮信息系統(tǒng)持續(xù)改進(jìn) [J].指揮信息系統(tǒng)與技術(shù)，2014，5（3）：17-20+27.

[2] 成棟.IETM系統(tǒng)開發(fā)問題與新技術(shù)應(yīng)用 [J].電子技術(shù)與軟件工程，2019（8）：247.

[3] 田啟明.Windows幫助系統(tǒng)的設(shè)計(jì)及實(shí)現(xiàn) [J].溫州職業(yè)技術(shù)學(xué)院學(xué)報(bào)，2003（1）：39-42.

[4] 李貞良.基于GJB6600的IETM數(shù)據(jù)格式標(biāo)準(zhǔn)研究 [J].軟件導(dǎo)刊，2016（7）：39-41.

[5] 蘇戈，楊昊寧，郝清.IETM在裝備保障中的應(yīng)用 [J].電子技術(shù)與軟件工程，2018（11）：185-186.

[6] 程躍兵，張林梅，陳本軍，等.基于GJB6600的武器裝備IETM標(biāo)準(zhǔn)裁剪研究[J].數(shù)字技術(shù)與應(yīng)用，2018，36（4）：116-118.

[7] 喬福超.IETM軟件數(shù)據(jù)模型設(shè)計(jì) [J].兵工自動(dòng)化，2015，34（1）：93-96.

[8] 喬福超.基于GJB6600的IETM邏輯引擎設(shè)計(jì) [J].四川兵工學(xué)報(bào)，2015，36（4）：116-119.

[9] 鄭楊碩，朱奕雯，王昊宸.用戶體驗(yàn)研究的發(fā)展現(xiàn)狀、研究模型與評(píng)價(jià)方法 [J].包裝工程，2020，41（6）：43-49.

作者簡介：毛瑩（1990—），女，漢族，江蘇鹽城人，工程師，碩士，主要研究方向：系統(tǒng)集成;謝亞妮（1988—），女，漢族，山西運(yùn)城人，高級(jí)工程師，碩士，主要研究方向：系統(tǒng)集成;李輝（1982—），男，漢族，江蘇丹陽人，高級(jí)工程師，碩士，主要研究方向：系統(tǒng)設(shè)計(jì)。