基于Web的场景化电子交互式帮助系统

毛莹 谢亚妮 李辉

摘  要：针对当前信息系统操作使用手册实用性和便利性不强的现状，文章基于GJB 6600-2008提出了针对信息系统装备软件的帮助信息数据模块结构，据此设计并实现了一种适用于信息系统装备软件的电子交互式帮助软件，统一帮助文档制作工序，统一信息系统用户的使用模式，实现了帮助信息制作智能化、集成化、版本化管理，降低帮助信息储存冗余，辅助系统操作人员快速掌握系统主要功能和典型应用流程，提高了系统的保障性，提升了用户软件使用感受。

关键词：电子交互式帮助;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  引  言

近年来，随着军工领域不断发展，军队信息化系统建设逐步推进，军队对信息系统装备的需求越来越高。中国电子科技集团公司第二十八研究所作为以指挥控制为核心的信息系统供应商，为用户提供指挥信息系统解决方案。我所信息系统装备软件具有集成规模大、业务复杂度高、版本迭代快等特点，如何使用户快速掌握系统操作要领、促进用户业务水平提升是售后保障工作重要内容之一。用户培训可以使用户快速掌握系统软件的主要功能和典型应用流程。系统用户手册作为用户培训工作的关键手段和技术，在信息系统装备的交付验收和维修保障阶段具有越来越重要的作用[1]。系统用户手册主要包括操作手册和安装维护说明书，目前业内电子用户手册常用形式：TXT文件、DOC/DOCX/PDF文件、HTML/CHM文件，不易进行帮助文件共享、更新和版本控制[2，3]。

2008年中国人民解放军总装备部批准发布了GJB 6600-2008系列标准，该标准规定了装备交互式电子技术手册（Inter-active Electronic Technical Manual，IETM）的功能、内容、样式、数据格式和管理信息等要求[4]。目前IETM主要用于武器硬件装备帮助设计，尚未在信息系统装备中进行广泛应用。针对当前信息系统操作使用手册的实用性和便利性不强的现状，以快速掌握典型应用流程需求为牵引，作者深入研究GJB 6600-2008，加强对用户培训需求的调研，提出了针对信息系统装备软件的帮助信息数据模块结构，据此设计并实现了一种适用于信息系统装备软件的电子交互式帮助软件，规范信息化装备帮助信息标准，实现电子交互式帮助软件精简化、自动化、智能化，突出用户场景体验感受。目前我所已在海事领域某项目中对该电子交互式帮助系统进行试用，该系统深受用户好评，有效提升产品服务質量。

1  IETM软件数据模型设计

IETM的本质是按照规范的数据格式以数字化形式将文本、多媒体、表格等技术信息资料组织起来，再通过一定的显示程序向用户展现。IETM的核心是规范化的数据模块[5]，数据模块是描述装备结构、性能和操作步骤等技术信息的独立、完整的数据单位。而数据模型的规范化有利于实现软件装备技术信息交互和软件重用模块信息共享。GJB 6600-2008标准的核心数据块由通用信息和专用信息组成，通用信息包括数据模块的标识和状态信息，专用信息包括文档内容的主体，主要包括操作使用、维修保障信息。GJB 6600-2008将数据模块分为8类，包括描述类、程序类、故障类、维修计划类、操作类、图解零件类、连线类、过程类;对于软件装备信息系统，描述类信息、故障类信息、操作类和程序类信息尤为重要[6]。

乔福超基于GJB 6600-2008设计了一种“系统—分系统/分分系统层—窗口层—组件层”软件系统划分和软件类数据模型，该模型以窗口为颗粒度，通过将窗口中组件识别录入成XML数据格式并对其解析的方式获取系统信息[7，8]。该方法具有一定操作性，但是一个复杂的业务信息系统往往包含几十个甚至几百个窗口/页面，窗口/页面中组件形式也趋于多样化;不同窗口之间信息冗余度较高，如通过差异码对窗口组件信息进行区分，势必会增加帮助信息录入人员的工作量，也对IETM数据维护提出了较高要求。目前计算机行业注重用户友好性设计，如页面/窗口存在大量提示信息等用户友好界面方式，帮助软件着重页面/窗口组件功能解析，不利于用户快速熟悉了解系统整体功能。

以应用流程为导向，本文提出了基于“主题应用层—基础功能层—数据元素层”三层架构的软件系统帮助信息层次图。以某企业信息化管理系统为例，如图1所示，该系统由财务管理系统、项目管理系统、人力资源系统等分系统构成，其中每一个分系统有多个主题应用，不同的主题应用由多个基础功能组成，基础功能以一个或多个窗口为基本单元，窗口信息以数据元素为载体实线，数据元素形式一般包括文字、视频、图片等多种多媒体格式。不同的主题应用可能涉及同一基础功能，通过基础功能的划分识别后再整合，降低帮助信息冗余度。

1.1  基础功能數据模型

基础功能指的系统中独立存在、具有一定接口规范、可以被复用的最小功能模块。基础功能数据模型由功能编码、功能简介、发布状态、功能描述组成。功能编码是基础功能数据模型的唯一标识符。军用软件信息系统强调组合化、通用化、系列化，鼓励软件模块复用，为了降低帮助信息冗余度，针对同样的模块可能在不同系统使用场景不一的问题，基础功能模块中的功能描述以用例为单位存储。用例可以源于同一系统不同应用场景想定，也可以源于不同系统同一应用想定，同一用例可以适用于不同的典型应用流程。这些基础功能模块经过多轮测试使用，具有较强的健壮性，基础功能模板的使用提高了系统研制效率，提升了软件开发的费效比。以基础功能报销申请为例，具体信息结构如下所示：

<基础功能信息>

<功能编码>BSWOINDW-78629322

<功能简介>报销申请

<发布状态>1

<功能描述>

<票据信息录入>

<用例编码>x0001

<所属分系统码>FIANCE-APPRB-29387108

<用例描述>

<用例摘要>启动报销申请流程，完成票据信息录入、审核

<操作说明>

打开“报销申请”对话框，点击“票据录入”按钮，上传票据照片，输入票据信息，包括出发地、目的地、耗时、交通工具等基本信息，如下图所示。

<录入时间>2020-08-12

<版本信息>v0.0.2

<发布状态>1

<票据信息修改>

……

1.2  主题应用数据模型

主题应用层数据主要是结合系统典型应用流程，从用户使用场景出发，通过典型应用让软件使用者迅速了解掌握系统操作使用方法，全局性地描述整个系统典型应用流程的使用步骤。典型应用数据结构由典型应用编码、所属系统、版本信息、发布状态、操作流程信息组成，其中操作流程具体步骤由基础功能的用例信息组合而成，不需要二次录入。系统设计人员只需要关注基础功能数据及其排序，若没有相关使用场景，设计人员可根据实际需求进行基础功能用例信息补充描述，提高了电子交互式帮助信息录入的便捷性和智能化。以“财务报销”应用为例，说明典型应用数据结构，代码如下：

<财务报销典型应用>

<典型应用编码>198876789

<所属系统>CPCMGL-FIANCE-APPRB-29387108

<版本信息>V0.0.0.3

<发布状态>1

<操作流程>

<基本功能>

<功能编码>BSWOINDW-78629322

<用例编码>0x0001

<基本功能>

<功能编码>BSWOINDW-78344322

<用例编码>0x0002

<基本功能>

……

2  系统设计

基于场景化IETM软件数据模型，本文设计并实现了一种适用于信息系统装备软件的电子交互式帮助软件，系统采用B/S（浏览器/服务器）架构，包括制作编辑系统和使用帮助展现系统两大类功能。制作编辑系统主要面向设计和开发人员，支持帮助文档制作、导入、典型应用流程合成等功能;使用帮助展现系统主要面向信息系统用户，提供帮助信息展现、帮助信息检索功能。电子交互式帮助框架支持文字、图片、视频等常用多媒体信息的展现，提升了用户视觉体验。电子交互式帮助软件前台展现页面如图2所示。

2.1  基础功能录入

系统支持Word文档导入和人工录入两种方式录入基础功能信息。人工录入模式主要利用CKEditor富文本工具对帮助信息进行编辑，支持文字、图片、表格、视频和音频的录入功能;支持对齐方式、字体、字号、颜色、间距等基本排版功能;支持录入基本元素（所属分系统、摘要等信息）的模板制作。系统支持通过JACOB中間件完成DOC/DOCX文档转变为HTML文件，通过CKEditor富文本工具二次编辑排版完成历史Word版帮助信息自动导入，提高帮助信息录入效率，如图3所示。

2.2  典型应用合成

录入的帮助信息在后台基于1.1节提出的基础功能数据模型进行存储。设计人员通过对基础功能用例进行选择排序合成典型应用，并进行帮助信息发布。该系统面向开发者提供帮助功能单元的顺序，可根据功能用例进行组合，形成流程化的帮助说明，指导用户按照编排的功能用例（顺序）逐个组合形成复杂操作的过程。

2.3  维保信息模糊搜索

安格努斯·瑞望的用户体验轮模型指出，以产品价值为核心，辐射出可查找性、可访问性、可获取性、可用性、可信度和有用性等基本特性[9]。基于用户体验轮模型，系统提供面向用户的维护保障信息检索功能，支持按关键词进行帮助信息模糊检索。系统基于编辑距离算法，计算关键字与帮助信息之间的关键距离，并按相似度由高到低进行排列，记录用户的检索记录;对于帮助浏览中出现的关键词汇用颜色进行标记，便于用户快速检索、识别、筛选所需的帮助信息。

3  结  论

本文基于GJB 6600-2008，综合用户体验轮模型，提出了基于“主题应用层—基础功能层—数据元素层”三层架构的软件系统帮助信息数据模块结构，设计并实现了一种适用于信息系统装备的电子交互式帮助软件，统一帮助文档制作工序，统一信息系统用户的使用模式。本文设计的电子交互式帮助软件实现了系统帮助信息程序化录入管理、版本化维护存储、用例化组合生成。通过HTML/CHM文件生成1 000万行规模的系统帮助文件平均耗时约7人日，其中6人日用于帮助信息录入，1人日用于帮助文件标准化审查修改。通过电子交互式帮助软件进行帮助信息录入，利用标准统一约束、信息同步录入、用例同步共享等机制，生成1 000万行规模的系统帮助文件平均耗时3人日，基础功能用例复用率达30%。

参考文献：

[1] 王小玉，张艳焕.指挥信息系统持续改进 [J].指挥信息系统与技术，2014，5（3）：17-20+27.

[2] 成栋.IETM系统开发问题与新技术应用 [J].电子技术与软件工程，2019（8）：247.

[3] 田启明.Windows帮助系统的设计及实现 [J].温州职业技术学院学报，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] 郑杨硕，朱奕雯，王昊宸.用户体验研究的发展现状、研究模型与评价方法 [J].包装工程，2020，41（6）：43-49.

作者简介：毛莹（1990—），女，汉族，江苏盐城人，工程师，硕士，主要研究方向：系统集成;谢亚妮（1988—），女，汉族，山西运城人，高级工程师，硕士，主要研究方向：系统集成;李辉（1982—），男，汉族，江苏丹阳人，高级工程师，硕士，主要研究方向：系统设计。