1 引言
1.1编写目的
说明编写这份用户手册的目的,指出预期的读者。
1.2背景
说明:
a.这份用户手册所描述的软件系统的名称;
b.该软件项目的任务提出者、开发者、用户(或首批用户)及安装此软件的计算中心。
1.3定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。
1.4参考资料
列出有用的参考资料,如:
a.项目的经核准的计划任务书或合同、上级机关的批文;
b.属于本项目的其他已发表文件;
c.本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够取得这些文件资料的来源。
2 用途
2.1功能
结合本软件的开发目的逐项地说明本软件所具有各项功能以及它们的极限范围。
2.2性能
2.2.1精度
逐项说明对各项输入数据的精度要求和本软件输出数据达到的精度,包括传输中的精度要求。
2.2.2时间特性
定量地说明本软件的时间特性,如响应时间,更新处理时间,数据传输、转换时间,计算时间等。
2.2.3灵活性
说明本软件所具有的灵活性,即当用户需求(如对操作方式、运行环境、结果精度、时间特性等的要求)有某些变化时,本软件的适应能力。
2. 3 安全保密
说明本软件在安全、保密方面的设计考虑和实际达到的能力。
3 运行环境
3.1 硬设备
列出为运行本软件所要求的硬设备的最小配置,如:
a.处理机的型号、内存容量;
b.所要求的外存储器、媒体、记录格式、设备的型号和台数、联机/脱机;
c. I/O设备(联机/脱机?);
d.数据传输设备和转换设备的型号、台数。
3.2支持软件
说明为运行本软件所需要的支持软件,如:
a.操作系统的名称、版本号;
b.程序语言的编译/汇编系统的名称和版本号;
c.数据库管理系统的名称和版本号;
d.其他支持软件。
3.3数据结构
列出为支持本软件的运行所需要的数据库或数据文卷。
4 使用过程
在本章,首先用图表的形式说明软件的功能同系统的输入源机构、输出接收机构之间的关系。
4. 1安装与初始化
一步一步地说明为使用本软件而需进行的安装与初始化过程,包括程序的存储形式、安装与初始化过程中的全部操作命令、系统对这些命令的反应与答复。表征安装工作完成的测试实例等。如果有的话,还应说明安装过程中所需用到的专用软件。
4.2输入
规定输入数据和参量的准备要求。
4.2.1输入数据的现实背景
说明输入数据的现实背景,主要是
a.情况--例如人员变动、库存'缺货;
b.情况出现的频度--例如是周期性的、随机的、一项操作状态的函数.
c.情况来源-一例如人事部门、仓库管理部门;
d.输入媒体---例如键盘、穿孔卡片、磁带;
e.限制--出于安全、保密考虑而对访问这些输入数据所加的限制;
f.质量管理--例如对输入数据合理性的检验以及当输入数据有错误时应采取的措施,如建立出错情况的记录等;
g.支配--例如如何确定输入数据是保留还是废弃,是否要分配给其他的接受者等。
4.2.2输入格式
说明对初始输入数据和参量的格式要求,包括语法规则和有关约定,如:
a.长度-一例如字符数/行,字符数/项;
b.格式基准--例如以左面的边沿为基准;
c.标号--例如标记或标识符;
d.顺序--例如各个数据项的次序及位置;
e.标点--例如用来表示行、数据组等的开始或结束而使用的空格、斜线、星号、字符组等。
f.词汇表--给出允许使用的字符组合的列表,禁止使用*的字符组合的列表等;
g.省略和重复--给出用来表示输人元素可省略或重复的表示方式;
h.控制--给出用来表示输入开始或结束的控制信息。
H.4.2.3输入举例
为每个完整的输入形式提供样本,包括:
a.控制或首部--例如用来表示输入的种类和类型的信息,标识符输入日期,正文起点和对所用编码的规定;
b.主体--输入数据的主体,包括数据文卷的输入表述部分;
c.尾部--用来表示输入结束的控制信息,累计字符总数等;
d.省略--指出哪些输入数据是可省略的;
e.重复--指出哪些输入数据是重复的。
4.3输出对每项输出作出说明.
4.3.1输出数据的现实背景,
说明输出数据的现实背景,主要是:
a.使用--这些输出数据是给谁的,用来干什么;
b.使用频度--例如每周的、定期的或备查阅的;
c.媒体--打印、CRI显示、磁带、卡片、磁盘,
d.质量管理-一例如关于合理性检验、出错纠正的规定;
e.支配--例如如何确定输出数据是保留还是废弃,是否要分配给其他接受者等。
4.3.2输出格式
给出对每一类输出信息的解释,主要是:
a.首部--如输出数据的标识符,输出日期和输出编号;
b.主体--输出信息的主体,包括分栏标题;
c.尾部--包括累计总数,结束标记。
4.3.3输出举例
为每种输出类型提供例子。对例子中的每一项,说明:
a.定义--每项输出信息的意义和用途;
b.来源--是从特定的输入中抽出、从数据库文卷中取出、或从软件的计算过程中得到;
c.特性--输出的值域、计量单位、在什么情况下可缺省等。
4.4文卷查询
这一条的编写针对具有查询能力的软件,内容包括:同数据库查询有关的初始化、准备、及处理所需要的详细规定,说明查询的能力、方式,所使用的命令和所要求的控制规定。
4.5出错处理和恢复
列出由软件产生的出错编码或条件以及应由用户承担的修改纠正工作。指出为了确保再启动和恢复的能力,用户必须遵循的处理过程。
4.6终端操作
当软件是在多终端系统上工作时,应编写本条,以说明终端的配置安排、连接步释、数据和参数输入步骤以及控制规定.说明通过终端操作进行查询、检索、修改数据文卷的能力、语言、过程以及辅助性程序等。
1 引言
1.1 编写目的
说明编写这份操作手册的目的,指出预期的读者。
1.2 前景
说明:
a.这份操作手册所描述的软件系统的名称;
b.该软件项目的任务提出者、开发者、用户(或首批用户)及安装该软件的计算中心。
1.3定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。
1.4参考资料
列出有用的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文;
b.属于本项目的其他已发表的文件;
c.本文件中各处引用的文件、资料,包括所列出的这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 软件征述
2.1软件的结构
结合软件系统所具有的功能包括输入、处理和输出提供该软件的总体结构图表。
2.2程序表
列出本系统内每个程序的标识符、编号和助记名。
2.3文卷表
列出将由本系统引用、建立或更新的每个永久性文卷,说明它们各自的标识符、编号、助记名、存储媒体和存储要求。
3 安装与初始化
一步一步地说明为使用本软件而需要进行的安装与初始化过程,包括程序的存载形式,安装与初始化过程中的全部操作命令,系统对这些命令的反应与答复,表征安装工作完成的测试实例等。如果有的话,还应说明安装过程中所需用到的专用软件。
4 运行说明
所谓一个运行是指提供一个启动控制信息后,直到计算机系统等待另一个启动控制信息时为止的计算机系统执行的全部过程。
4.1运行表
列出每种可能的运行,摘要说明每个运行的目的,指出每个运行各自所执行的程序。
4.2运行步骤
说明从一个运行转向另一个运行以完成整个系统运行的步骤。
4. 3运行1(标识符)说明
把运行1的有关信息,以对操作人员为最方便最有用的形式加以说明。
4.3.1运行控制
列出为本运行所需要"的运行流向控制的说明。
4.3.2操作信息
给出为操作中心的操作人员和管理人员所需要的信息,如:
a.运行目的;
b.操作要求;
c.启动方法如应请启动(由所遇到的请求信息启动)、预定时间启动、…,..等;
d.预计的运行时间和解题时间;操作命令;
f.与运行有联系的其他事项。
4.3.3输入一输出文卷
提供被本运行建立、更新或访问的数据文卷的有关信息,如:
a.文卷的标识符或标号;
b.记录媒体;
c.存留的目录表;
d.文卷的支配如确定保留或废弃的准则、是否要分配给其他接受者、占用硬设备的优先级以及保密控制等有关规定。
4.3.4输出文段
提供本软件输出的每一一个用于提示、说明、或应答的文段(包括"菜单")的有关信息,如:
a.文段的标识符;
b.输出媒体(屏幕显示、打印、……);
c.文字容量;
d.分发对象;
e.保密要求。
4.3.5输出文段的复制
对由计算机产生,而后需用其他方法复制的那些文段提供有关信息,如:
a.文段的标识符;
b.复制的技术手段;
c.纸张或其他媒体的规格;
d.装订要求;
e.分发对象;
f.复制份数。
4.3.6恢复过程
说明本运行故障后的恢复过程。
4.4运行2(标识符)说明
用与本手册1.4.3条相类似的方式介绍另一个运行的有关信息。
5 非常规过程
提供有关应急操作或非常规操作的必要信息,如出错处理操作、向后备系统的切换操作以及其他必须向程序维护人员交待的事项和步骤。
6 远程操作
如果本软件能够通过远程终端控制运行,则在本章说明通过远程终端运行本软件的操作过程。