CN105045774B - 一种所见即所得的用户界面操作手册编写及生成方法 - Google Patents
一种所见即所得的用户界面操作手册编写及生成方法 Download PDFInfo
- Publication number
- CN105045774B CN105045774B CN201510445987.2A CN201510445987A CN105045774B CN 105045774 B CN105045774 B CN 105045774B CN 201510445987 A CN201510445987 A CN 201510445987A CN 105045774 B CN105045774 B CN 105045774B
- Authority
- CN
- China
- Prior art keywords
- user interface
- handbook
- operating user
- attribute
- operating
- Prior art date
- Legal status (The legal status is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the status listed.)
- Active
Links
- 238000000034 method Methods 0.000 title claims abstract description 28
- 238000003860 storage Methods 0.000 claims description 6
- 230000015572 biosynthetic process Effects 0.000 claims description 4
- 238000003786 synthesis reaction Methods 0.000 claims description 4
- 238000005516 engineering process Methods 0.000 description 3
- 238000010586 diagram Methods 0.000 description 2
- 239000012634 fragment Substances 0.000 description 2
- 230000001360 synchronised effect Effects 0.000 description 2
- 238000004519 manufacturing process Methods 0.000 description 1
- 238000002360 preparation method Methods 0.000 description 1
Landscapes
- Stored Programmes (AREA)
- User Interface Of Digital Computer (AREA)
- Document Processing Apparatus (AREA)
Abstract
本发明公开了一种所见即所得的用户界面操作手册编写及生成方法，属于用户界面操作手册编写技术领域，本发明解决用户界面操作手册和软件实现脱节的问题。技术方案步骤为：（1）、设置用户图形界面的用户界面操作手册相关的属性描述；（2）、设置用户界面操作手册的文档模版：将用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性进行合成；（3）、录入用户界面操作手册的相关属性信息：提供一个用于编辑用户界面操作手册属性的编辑工具；（4）、生成用户界面操作手册的实现步骤：加载该用户图形界面模型XML及用户界面操作手册属性列表值，生成相应的用户界面操作手册文档。
Description
技术领域
本发明涉及一种用户界面操作手册编写技术领域，具体地说是一种所见即所得的用户界面操作手册编写及生成方法。
背景技术
在MDD(模型驱动开发)模式下，用户图形界面的定义被描述为一个模型描述文件，它通常采用XML文档结构，它的结构一般描述为界面布局容器和具体界面组成元素之间的分层嵌套的结构。基于MDD(模型驱动开发)描述的用户图形界面模型，是由界面组成元素构成，其包括容器类界面元素和具体界面元素两类。具体界面元素一般是一个图形控件或具有特定含义的标签(例如Html的标记标签<input/>等)。每一种界面组成元素，在MDD中对应一个模型元素类型(XML)。
例如一个图形界面带有工具栏、布局容器及输入控件，那么其描述结构如下所示：
然后在运行时，通过代码生成器生成源代码编译或通过解析程序对模型描述文件解析的方式，最终形成运行时用户可操作的用户图形界面程序。
在软件交付给用户使用之前，需要编写用户界面操作手册。这个过程一般是由相关文档编写人员，依照软件操作实现，手工编辑文字和插图来实现，这个过程往往比较繁琐和低效，并且文档质量参差不齐；并且当软件实现修改后，用户界面操作手册也许有手工修改文档，甚至因为未及时编写文档，导致用户界面操作手册和软件实现脱节。
发明内容
本发明的技术任务是针对以上不足之处，提供一种所见即所得的用户界面操作手册编写及生成方法，来解决用户界面操作手册和软件实现脱节的问题。
本发明解决其技术问题所采用的技术方案是：
一种所见即所得的用户界面操作手册编写及生成方法，包括如下步骤：
(1)、设置用户图形界面的用户界面操作手册相关的属性描述：用户界面操作手册的属性描述与用户图形界面模型中的模型元素类型对应，为每一个模型元素类型添加用户界面操作手册属性描述；该属性描述是一个属性定义的集合；
(2)、设置用户界面操作手册的文档模版：基于模版引擎技术，将用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性进行合成，并作为模版的变量输入，即根据具体的用户界面操作手册的文档格式生成具体的用户界面操作手册的文档模版；
(3)、录入用户界面操作手册的相关属性信息：提供一个用于编辑用户界面操作手册属性的编辑工具，加载指定的用户图形界面模型XML和用户界面操作手册属性定义，用于录入或编辑相应的用户界面操作手册属性；
(4)、生成用户界面操作手册的实现步骤：提供一个用于生成具体用户界面操作手册的工具，该工具根据用户选择的用户图形界面模型，加载该用户图形界面模型XML及步骤(3)描述的用户界面操作手册属性列表值，依据步骤(2)描述的合成关系，调用模版引擎，生成相应的用户界面操作手册文档。
步骤(1)中，属性定义包含以下具体信息：属性标识、属性显示名称、属性编辑方式、是否必填。
步骤(1)中，属性编辑方式分为两种：简单文本编辑、富文本编辑。富文本编辑指的是可支持字体、颜色、缩进等。
步骤(2)中，用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性的合成，是在每个界面组成元素的XML描述中，追加用户界面操作手册属性对应的XML属性，其属性名为步骤(1)中定义的用户界面操作手册属性的属性标识。其具体XML表述为：
<界面组成元素界面组成元素属性1＝"...",...,界面组成元素属性n＝"...",用户界面操作手册属性标识1＝"...",...,用户界面操作手册属性标识n＝"..."/>。
步骤(3)中，当具体选择一个界面组成元素时，工具显示该界面组成元素对应的模型元素类型的用户界面操作手册属性列表，并提供用户界面操作手册属性列表值的编辑及存储。
步骤(3)中，用户界面操作手册属性值的存储包含以下信息项：用户图形界面模型标识、界面组成元素标识、用户界面操作手册属性标识、属性值。
本发明的一种所见即所得的用户界面操作手册编写及生成方法和现有技术相比，具有以下有益效果：
1、应用模版引擎技术，其基本工作原理为在一段文本中通过特殊标记，插入数据变量及程序流程控制的程序语句；通过输入不同的数据，同一个模版可以生成不同的文本文档；
2、能够根据用户图形界面，所见即所得的即时编辑用户界面操作手册相关内容，并能够自动生成或同步用户界面操作手册；
3、用户可灵活的设置待生成的用户界面操作手册模版，通过用户界面操作手册属性编辑工具，可直观、快速的编辑用户界面操作手册内容，从而一次性的批量生成用户界面操作手册；
4、当部分用户图形界面调整后，可快速的编辑和同步用户界面操作手册；降低了用户界面操作手册编写及维护的繁琐度，提高了用户界面操作手册编写的效率及实时性，并有利于用户界面操作手册格式的一致性。
附图说明
下面结合附图对本发明进一步说明。
附图1为背景技术中描述的用户图形界面模型构成示意图；
附图2为一种所见即所得的用户界面操作手册编写及生成方法的用户界面操作手册属性与模型元素类型关系结构示意图；
附图3为一种所见即所得的用户界面操作手册编写及生成方法的工作原理图。
具体实施方式
下面结合附图和具体实施例对本发明作进一步说明。
实施例1：
本发明的一种所见即所得的用户界面操作手册编写及生成方法，包括如下步骤：
(1)、设置用户图形界面的用户界面操作手册相关的属性描述：用户界面操作手册的属性描述与用户图形界面模型中的模型元素类型对应，为每一个模型元素类型添加用户界面操作手册属性描述；该属性描述是一个属性定义的集合；
(2)、设置用户界面操作手册的文档模版：基于模版引擎技术，将用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性进行合成，并作为模版的变量输入，即根据具体的用户界面操作手册的文档格式生成具体的用户界面操作手册的文档模版；
(3)、录入用户界面操作手册的相关属性信息：提供一个用于编辑用户界面操作手册属性的编辑工具，加载指定的用户图形界面模型XML和用户界面操作手册属性定义，用于录入或编辑相应的用户界面操作手册属性；
(4)、生成用户界面操作手册的实现步骤：提供一个用于生成具体用户界面操作手册的工具，该工具根据用户选择的用户图形界面模型，加载该用户图形界面模型XML及步骤(3)描述的用户界面操作手册属性列表值，依据步骤(2)描述的合成关系，调用模版引擎，生成相应的用户界面操作手册文档。
实施例2：
本发明的一种所见即所得的用户界面操作手册编写及生成方法，包括如下步骤：
(1)、设置用户图形界面的用户界面操作手册相关的属性描述：用户界面操作手册的属性描述与用户图形界面模型中的模型元素类型对应，为每一个模型元素类型添加用户界面操作手册属性描述；该属性描述是一个属性定义的集合；
(2)、设置用户界面操作手册的文档模版：基于模版引擎技术，将用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性进行合成，并作为模版的变量输入，即根据具体的用户界面操作手册的文档格式生成具体的用户界面操作手册的文档模版；
(3)、录入用户界面操作手册的相关属性信息：提供一个用于编辑用户界面操作手册属性的编辑工具，加载指定的用户图形界面模型XML和用户界面操作手册属性定义，用于录入或编辑相应的用户界面操作手册属性；
(4)、生成用户界面操作手册的实现步骤：提供一个用于生成具体用户界面操作手册的工具，该工具根据用户选择的用户图形界面模型，加载该用户图形界面模型XML及步骤(3)描述的用户界面操作手册属性列表值，依据步骤(2)描述的合成关系，调用模版引擎，生成相应的用户界面操作手册文档。
步骤(1)中，属性定义包含以下具体信息：属性标识、属性显示名称、属性编辑方式、是否必填。
步骤(1)中，属性编辑方式分为两种：简单文本编辑、富文本编辑。富文本编辑指的是可支持字体、颜色、缩进等。
步骤(2)中，用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性的合成，是在每个界面组成元素的XML描述中，追加用户界面操作手册属性对应的XML属性，其属性名为步骤(1)中定义的用户界面操作手册属性的属性标识。其具体XML表述为：
<界面组成元素界面组成元素属性1＝"...",...,界面组成元素属性n＝"...",用户界面操作手册属性标识1＝"...",...,用户界面操作手册属性标识n＝"..."/>。
步骤(3)中，当具体选择一个界面组成元素时，工具显示该界面组成元素对应的模型元素类型的用户界面操作手册属性列表，并提供用户界面操作手册属性列表值的编辑及存储。
步骤(3)中，用户界面操作手册属性值的存储包含以下信息项：用户图形界面模型标识、界面组成元素标识、用户界面操作手册属性标识、属性值。
实施例3：
本发明的一种所见即所得的用户界面操作手册编写及生成方法，包括如下步骤：
(1)、设置用户图形界面的用户界面操作手册相关的属性描述：用户界面操作手册的属性描述与用户图形界面模型中的模型元素类型对应，为每一个模型元素类型添加用户界面操作手册属性描述；该属性描述是一个属性定义的集合；
(2)、设置用户界面操作手册的文档模版：基于模版引擎技术，将用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性进行合成，并作为模版的变量输入，即根据具体的用户界面操作手册的文档格式生成具体的用户界面操作手册的文档模版；
(3)、录入用户界面操作手册的相关属性信息：提供一个用于编辑用户界面操作手册属性的编辑工具，加载指定的用户图形界面模型XML和用户界面操作手册属性定义，用于录入或编辑相应的用户界面操作手册属性；
(4)、生成用户界面操作手册的实现步骤：提供一个用于生成具体用户界面操作手册的工具，该工具根据用户选择的用户图形界面模型，加载该用户图形界面模型XML及步骤(3)描述的用户界面操作手册属性列表值，依据步骤(2)描述的合成关系，调用模版引擎，生成相应的用户界面操作手册文档。
如下以某系统的采购订单基本信息界面为例，对上述四个步骤进行说明。
基于步骤(1)，该界面主要由工具栏按钮和输入控件两类模型元素类型组成，其对应的用户界面操作手册的属性如表1所示：
表1
基于步骤(2)，定义文档模板的伪代码片段如下：
操作按钮说明：
基于步骤(3)，使用用户界面操作手册属性编辑工具原型，用户可所见即所得的快速录入相应的用户界面操作手册相关属性信息。录入的描述信息大致如表2所示：
表2
基于步骤(4)，在生成时，对用户图形界面模型和用户界面操作手册属性进行合并，合并后的XML片段，以采购订单基本信息的新建按钮为例，内容如下：
<ToolbarButtionItem id＝"btnCreate"text＝"新建(&C)",...,functionDesc＝"创建
一个新的采购订单",noticeInfo＝"如果您权限不足，系统会给予提示。"/>。
将合成后的文档XML和实施例步骤二定义的用户界面操作手册文档模版，调用模版引擎，可生成最终的用户界面操作手册文档，示例如下：
操作按钮说明：
新增按钮：创建一个新的采购订单。
注意事项：如果您权限不足，系统会给予提示。
…
输入字段说明：
…
金额字段：采购订单的总价合计
输入规则说明：货币类型，不允许输入负数。
通过上面具体实施方式，所述技术领域的技术人员可容易的实现本发明。但是应当理解，本发明并不限于上述的具体实施方式。在公开的实施方式的基础上，所述技术领域的技术人员可任意组合不同的技术特征，从而实现不同的技术方案。
除说明书所述的技术特征外，均为本专业技术人员的已知技术。
Claims (6)
1.一种所见即所得的用户界面操作手册编写及生成方法，其特征在于包括如下步骤：
（1）、设置用户图形界面的用户界面操作手册相关的属性描述：用户界面操作手册的属性描述与用户图形界面模型中的模型元素类型对应，为每一个模型元素类型添加用户界面操作手册属性描述；该属性描述是一个属性定义的集合；
（2）、设置用户界面操作手册的文档模版：基于模版引擎技术，将用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性进行合成，并作为模版的变量输入，即根据具体的用户界面操作手册的文档格式生成具体的用户界面操作手册的文档模版；
（3）、录入用户界面操作手册的相关属性信息：提供一个用于编辑用户界面操作手册属性的编辑工具，加载指定的用户图形界面模型XML和用户界面操作手册属性定义，用于录入或编辑相应的用户界面操作手册属性；
（4）、生成用户界面操作手册的实现步骤：提供一个用于生成具体用户界面操作手册的工具，该工具根据用户选择的用户图形界面模型，加载该用户图形界面模型XML及步骤（3）描述的用户界面操作手册属性列表值，依据步骤（2）描述的合成关系，调用模版引擎，生成相应的用户界面操作手册文档。
2.根据权利要求1所述的一种所见即所得的用户界面操作手册编写及生成方法，其特征在于步骤（1）中，属性定义包含以下具体信息：属性标识、属性显示名称、属性编辑方式、是否必填。
3.根据权利要求1所述的一种所见即所得的用户界面操作手册编写及生成方法，其特征在于步骤（1）中，属性编辑方式分为两种：简单文本编辑、富文本编辑。
4.根据权利要求1所述的一种所见即所得的用户界面操作手册编写及生成方法，其特征在于步骤（2）中，用户图形界面模型的XML文档及模型元素类型扩展的用户界面操作手册属性的合成，是在每个界面组成元素的XML描述中，追加用户界面操作手册属性对应的XML属性，其属性名为步骤（1）中定义的用户界面操作手册属性的属性标识。
5.根据权利要求1所述的一种所见即所得的用户界面操作手册编写及生成方法，其特征在于步骤（3）中，当具体选择一个界面组成元素时，用于编辑用户界面操作手册属性的编辑工具显示该界面组成元素对应的模型元素类型的用户界面操作手册属性列表，并提供用户界面操作手册属性列表值的编辑及存储。
6.根据权利要求5所述的一种所见即所得的用户界面操作手册编写及生成方法，其特征在于步骤（3）中，用户界面操作手册属性值的存储包含以下信息项：用户图形界面模型标识、界面组成元素标识、用户界面操作手册属性标识、属性值。
Priority Applications (1)
| Application Number | Priority Date | Filing Date | Title |
|---|---|---|---|
| CN201510445987.2A CN105045774B (zh) | 2015-07-27 | 2015-07-27 | 一种所见即所得的用户界面操作手册编写及生成方法 |
Applications Claiming Priority (1)
| Application Number | Priority Date | Filing Date | Title |
|---|---|---|---|
| CN201510445987.2A CN105045774B (zh) | 2015-07-27 | 2015-07-27 | 一种所见即所得的用户界面操作手册编写及生成方法 |
Publications (2)
| Publication Number | Publication Date |
|---|---|
| CN105045774A CN105045774A (zh) | 2015-11-11 |
| CN105045774B true CN105045774B (zh) | 2017-08-29 |
Family
ID=54452331
Family Applications (1)
| Application Number | Title | Priority Date | Filing Date |
|---|---|---|---|
| CN201510445987.2A Active CN105045774B (zh) | 2015-07-27 | 2015-07-27 | 一种所见即所得的用户界面操作手册编写及生成方法 |
Country Status (1)
| Country | Link |
|---|---|
| CN (1) | CN105045774B (zh) |
Families Citing this family (2)
| Publication number | Priority date | Publication date | Assignee | Title |
|---|---|---|---|---|
| CN112257392B (zh) * | 2020-10-30 | 2024-04-26 | 杭州数梦工场科技有限公司 | 一种计算机程序操作文档的生成方法、装置及设备 |
| CN113807071A (zh) * | 2021-08-31 | 2021-12-17 | 浙江浙大中控信息技术有限公司 | 一种基于ocr的文档生成方法 |
Citations (5)
| Publication number | Priority date | Publication date | Assignee | Title |
|---|---|---|---|---|
| JPH0922349A (ja) * | 1995-07-07 | 1997-01-21 | Fujitsu Ltd | コンピュータシステムの操作手順書自動作成方式 |
| CN1869973A (zh) * | 2005-05-27 | 2006-11-29 | 国际商业机器公司 | 生成文档的方法和系统 |
| CN102096659A (zh) * | 2009-12-11 | 2011-06-15 | 大唐移动通信设备有限公司 | 一种用户手册生成方法及系统 |
| CN103823791A (zh) * | 2014-02-28 | 2014-05-28 | 深圳市同洲电子股份有限公司 | 一种实现文档自动生成的方法及装置 |
| CN104598133A (zh) * | 2015-01-30 | 2015-05-06 | 广东欧珀移动通信有限公司 | 对象的说明书生成方法和装置 |
Family Cites Families (4)
| Publication number | Priority date | Publication date | Assignee | Title |
|---|---|---|---|---|
| JP4078356B2 (ja) * | 2005-02-14 | 2008-04-23 | 株式会社東芝 | Ｇｕｉアプリケーションの操作説明文言作成装置、ｇｕｉアプリケーションの操作説明文言作成方法およびプログラム |
| CN102495832A (zh) * | 2011-12-12 | 2012-06-13 | 方正国际软件有限公司 | 软件开发过程中文档自动生成系统 |
| CN103810292A (zh) * | 2014-02-28 | 2014-05-21 | 北京理工大学 | 一种图形界面的配置方法及装置 |
| CN104267962A (zh) * | 2014-10-09 | 2015-01-07 | 浪潮通用软件有限公司 | 一种基于描述的界面ui控件配置方法 |
-
2015
- 2015-07-27 CN CN201510445987.2A patent/CN105045774B/zh active Active
Patent Citations (5)
| Publication number | Priority date | Publication date | Assignee | Title |
|---|---|---|---|---|
| JPH0922349A (ja) * | 1995-07-07 | 1997-01-21 | Fujitsu Ltd | コンピュータシステムの操作手順書自動作成方式 |
| CN1869973A (zh) * | 2005-05-27 | 2006-11-29 | 国际商业机器公司 | 生成文档的方法和系统 |
| CN102096659A (zh) * | 2009-12-11 | 2011-06-15 | 大唐移动通信设备有限公司 | 一种用户手册生成方法及系统 |
| CN103823791A (zh) * | 2014-02-28 | 2014-05-28 | 深圳市同洲电子股份有限公司 | 一种实现文档自动生成的方法及装置 |
| CN104598133A (zh) * | 2015-01-30 | 2015-05-06 | 广东欧珀移动通信有限公司 | 对象的说明书生成方法和装置 |
Also Published As
| Publication number | Publication date |
|---|---|
| CN105045774A (zh) | 2015-11-11 |
Similar Documents
| Publication | Publication Date | Title |
|---|---|---|
| CN102779118B (zh) | 一种论文的排版方法及系统 | |
| RU2536390C2 (ru) | Способ для автоматизированного создания отчетов | |
| CN110032720A (zh) | 一种基于xml的可视化报告排版及自动生成方法及系统 | |
| CN101989256A (zh) | 一种文书文件的排版方法及装置 | |
| WO2007030695A1 (en) | Methods and systems for providing direct style sheet editing | |
| CN104516867A (zh) | 一种表格重排方法和系统 | |
| CN106469140A (zh) | 一种报表生成系统及其方法 | |
| CN104572577B (zh) | 数学公式处理方法及装置 | |
| JP2008234370A (ja) | 文書処理装置及び文書処理方法 | |
| CN111104557A (zh) | 基于标准文档标记语言规范的异构文档处理系统及方法 | |
| US20130290837A1 (en) | Method and Apparatus for Correcting Document Formatting Based on Source Document | |
| CN110765743A (zh) | 用于数学公式在HTML中编辑显示和导出到Word文档中的系统 | |
| CN113268227A (zh) | 一种零代码可视化的软件开发平台及开发方法 | |
| CN105045774B (zh) | 一种所见即所得的用户界面操作手册编写及生成方法 | |
| CN106407172A (zh) | 一种基于xml的报表生成方法 | |
| CN108073562A (zh) | 基于云平台的出版物处理方法及装置 | |
| Bagley et al. | Creating reusable well-structured PDF as a sequence of component object graphic (COG) elements | |
| CN104182427A (zh) | 电子文件制作系统及其电子文件制作方法 | |
| CN104281575A (zh) | 一种网页数据获取方法及模版引擎 | |
| CN102521424A (zh) | 标贴制作打印系统及方法 | |
| KR100902193B1 (ko) | 보고서 작성시스템, 검색결과에 대한 맞춤 보고서 제공방법 및 시스템, 그리고, 저장매체 | |
| JP2004157927A (ja) | 帳票入力用プログラムの生成方式、生成プログラム及び生成方法 | |
| Lindsay et al. | FigureFirst: A Layout-first Approach for Scientific Figures. | |
| Li et al. | BioInfograph: an online tool to design and display multi-panel scientific figure interactively | |
| JP2001265791A (ja) | 電子書籍表示装置及び電子書籍表示プログラムを記憶した記憶媒体 |
Legal Events
| Date | Code | Title | Description |
|---|---|---|---|
| C06 | Publication | ||
| PB01 | Publication | ||
| C10 | Entry into substantive examination | ||
| SE01 | Entry into force of request for substantive examination | ||
| GR01 | Patent grant | ||
| GR01 | Patent grant |