毛瑩 謝亞妮 李輝

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

關鍵詞：電子交互式幫助;SpringMVC;軍隊信息化

中圖分類號：TP334.3? ? ? 文獻標識碼：A 文章編號：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? 引? 言

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

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

1? IETM軟件數據模型設計

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

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

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

1.1? 基礎功能數據模型

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

<基礎功能信息>

<功能編碼>BSWOINDW-78629322

<功能簡介>報銷申請

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

<功能描述>

<票據信息錄入>

<用例編碼>x0001

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

<用例描述>

<用例摘要>啟動報銷申請流程，完成票據信息錄入、審核

<操作說明>

打開“報銷申請”對話框，點擊“票據錄入”按鈕，上傳票據照片，輸入票據信息，包括出發(fā)地、目的地、耗時、交通工具等基本信息，如下圖所示。

<錄入時間>2020-08-12

<版本信息>v0.0.2

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

<票據信息修改>

……

1.2? 主題應用數據模型

主題應用層數據主要是結合系統(tǒng)典型應用流程，從用戶使用場景出發(fā)，通過典型應用讓軟件使用者迅速了解掌握系統(tǒng)操作使用方法，全局性地描述整個系統(tǒng)典型應用流程的使用步驟。典型應用數據結構由典型應用編碼、所屬系統(tǒng)、版本信息、發(fā)布狀態(tài)、操作流程信息組成，其中操作流程具體步驟由基礎功能的用例信息組合而成，不需要二次錄入。系統(tǒ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)設計

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

2.1? 基礎功能錄入

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

2.2? 典型應用合成

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

2.3? 維保信息模糊搜索

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

3? 結? 論

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

參考文獻：

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

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

[3] 田啟明.Windows幫助系統(tǒng)的設計及實現 [J].溫州職業(yè)技術學院學報，2003（1）：39-42.

[4] 李貞良.基于GJB6600的IETM數據格式標準研究 [J].軟件導刊，2016（7）：39-41.

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

[6] 程躍兵，張林梅，陳本軍，等.基于GJB6600的武器裝備IETM標準裁剪研究[J].數字技術與應用，2018，36（4）：116-118.

[7] 喬福超.IETM軟件數據模型設計 [J].兵工自動化，2015，34（1）：93-96.

[8] 喬福超.基于GJB6600的IETM邏輯引擎設計 [J].四川兵工學報，2015，36（4）：116-119.

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

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